FileDocCategorySizeDatePackage
ObjectHolder.javaAPI DocJava SE 5 API3184Fri Aug 26 14:58:30 BST 2005org.omg.CORBA

ObjectHolder

public final class ObjectHolder extends Object implements org.omg.CORBA.portable.Streamable
The Holder for Object. For more information on Holder files, see "Generated Files: Holder Files".

A Holder class for a CORBA object reference (a value of type org.omg.CORBA.Object). It is usually used to store "out" and "inout" parameters in IDL methods. If an IDL method signature has a CORBA Object reference as an "out" or "inout" parameter, the programmer must pass an instance of ObjectHolder 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 myObjectHolder is an instance of ObjectHolder, the value stored in its value field can be accessed with myObjectHolder.value.

version
1.14, 09/09/97
since
JDK1.2

Fields Summary
public Object
value
The Object value held by this ObjectHolder object.
Constructors Summary
public ObjectHolder()
Constructs a new ObjectHolder object with its value field initialized to null.
public ObjectHolder(Object initial)
Constructs a new ObjectHolder object with its value field initialized to the given Object.

param
initial the Object with which to initialize the value field of the newly-created ObjectHolder object

	value = initial;
Methods Summary
public void_read(org.omg.CORBA.portable.InputStream input)
Reads from input and initalizes the value in this ObjectHolder object with the unmarshalled data.

param
input the InputStream containing CDR formatted data from the wire.

	value = input.read_Object();
public org.omg.CORBA.TypeCode_type()
Returns the TypeCode corresponding to the value held in this ObjectHolder object

return
the TypeCode of the value held in this ObjectHolder object

	return org.omg.CORBA.ORB.init().get_primitive_tc(TCKind.tk_objref);
public void_write(org.omg.CORBA.portable.OutputStream output)
Marshals to output the value in this ObjectHolder object.

param
output the OutputStream which will contain the CDR formatted data.

	output.write_Object(value);