public final class StringHolder extends Object implements Streamable
A Holder class for a String
that is used to store "out" and "inout" parameters in IDL operations.
If an IDL operation signature has an IDL string as an "out"
or "inout" parameter, the programmer must pass an instance of
StringHolder as the corresponding
parameter in the method invocation; for "inout" parameters, the programmer
must also fill the "in" value to be sent to the server.
Before the method invocation returns, the ORB will fill in the
value corresponding to the "out" value returned from the server.
If myStringHolder is an instance of StringHolder,
the value stored in its value field can be accessed with
myStringHolder.value.
| Modifier and Type | Field and Description |
|---|---|
String |
value
The
String value held by this StringHolder
object. |
| Constructor and Description |
|---|
StringHolder()
Constructs a new
StringHolder object with its
value field initialized to null. |
StringHolder(String initial)
Constructs a new
StringHolder object with its
value field initialized to the given
String. |
| Modifier and Type | Method and Description |
|---|---|
void |
_read(InputStream input)
Reads the unmarshalled data from
input and assigns it to
the value field of this StringHolder object. |
TypeCode |
_type()
Retrieves the
TypeCode object that corresponds to
the value held in this StringHolder object. |
void |
_write(OutputStream output)
Marshals the value held by this
StringHolder object
to the output stream output. |
public String value
String value held by this StringHolder
object.public StringHolder()
StringHolder object with its
value field initialized to null.public StringHolder(String initial)
StringHolder object with its
value field initialized to the given
String.initial - the String with which to initialize
the value field of the newly-created
StringHolder objectpublic void _read(InputStream input)
input and assigns it to
the value field of this StringHolder object._read in interface Streamableinput - the InputStream containing CDR formatted data from the wire.public void _write(OutputStream output)
StringHolder object
to the output stream output._write in interface Streamableoutput - the OutputStream which will contain the CDR formatted data.public TypeCode _type()
TypeCode object that corresponds to
the value held in this StringHolder object._type in interface StreamableStringHolder
object Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.