org.omg.CORBA

Class StringHolder

public final class StringHolder extends Object implements Streamable

A holder for CORBA string that is mapped into java String. The holders have several application areas. The end user usually sees them implementing CORBA methods where the primitive type is passed by reference. While CORBA (or, for example, C) supports this, the java does not and a wrapper class is required.
Field Summary
Stringvalue
The String (CORBA string) value, held by this StringHolder.
Constructor Summary
StringHolder()
Constructs an instance of StringHolder, initializing {@link #value} to null.
StringHolder(String initial_value)
Constructs an instance of StringHolder, initializing {@link #value} to the given String.
Method Summary
void_read(InputStream input)
Fill in the {@link #value } field by reading the required data from the given stream.
TypeCode_type()
Returns the TypeCode, corresponding the CORBA type that is stored using this holder.
void_write(OutputStream output)
Write the {@link #value } field to the given stream.

Field Detail

value

public String value
The String (CORBA string) value, held by this StringHolder.

Constructor Detail

StringHolder

public StringHolder()
Constructs an instance of StringHolder, initializing {@link #value} to null.

StringHolder

public StringHolder(String initial_value)
Constructs an instance of StringHolder, initializing {@link #value} to the given String.

Parameters: initial_value a value that will be assigned to the {@link #value} field.

Method Detail

_read

public void _read(InputStream input)
Fill in the {@link #value } field by reading the required data from the given stream. For string, the functionality is delegated to {@link org.omg.CORBA.portable.InputStream#read_string}.

Parameters: input the input stream to read from.

_type

public TypeCode _type()
Returns the TypeCode, corresponding the CORBA type that is stored using this holder. The {@link TypeCode#length()} method of the returned typecode always returns 0.

_write

public void _write(OutputStream output)
Write the {@link #value } field to the given stream. For string, the functionality is delegated to {@link org.omg.CORBA.portable.OutputStream#write_string(String) }.

Parameters: output the output stream to write into.