org.omg.DynamicAny

Class DynAnyFactoryPOA

java.lang.Object

org.omg.PortableServer.Servant

org.omg.DynamicAny.DynAnyFactoryPOA

All Implemented Interfaces:

InvokeHandler, DynAnyFactoryOperations

Direct Known Subclasses:

DynAnyFactoryPOATie

public abstract class DynAnyFactoryPOA
extends Servant
implements DynAnyFactoryOperations, InvokeHandler

DynAny objects can be created by invoking operations on the DynAnyFactory object. Generally there are only two ways to create a DynAny object:

• invoking an operation on an existing DynAny object
• invoking an operation on a DynAnyFactory object

A constructed DynAny object supports operations that enable the creation of new DynAny objects encapsulating access to the value of some constituent. DynAny objects also support the copy operation for creating new DynAny objects. A reference to the DynAnyFactory object is obtained by calling ORB.resolve_initial_references() with the identifier parameter set to the string constant "DynAnyFactory".

Dynamic interpretation of an any usually involves creating a DynAny object using create_dyn_any() as the first step. Depending on the type of the any, the resulting DynAny object reference can be narrowed to a DynFixed, DynStruct, DynSequence, DynArray, DynUnion, DynEnum, or DynValue object reference.

Dynamic creation of an any involves creating a DynAny object using create_dyn_any_from_type_code(), passing the TypeCode associated with the value to be created. The returned reference is narrowed to one of the complex types, such as DynStruct, if appropriate. Then, the value can be initialized by means of invoking operations on the resulting object. Finally, the to_any operation can be invoked to create an any value from the constructed DynAny.

Constructor Summary

Constructors

Constructor and Description
DynAnyFactoryPOA()

Method Summary

Modifier and Type	Method and Description
String[]	_all_interfaces(POA poa, byte[] objectId) Used by the ORB to obtain complete type information from the servant.
OutputStream	_invoke(String $method, InputStream in, ResponseHandler $rh) Invoked by the ORB to dispatch a request to the servant.
DynAnyFactory	_this()
DynAnyFactory	_this(ORB orb)

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.omg.DynamicAny.DynAnyFactoryOperations

create_dyn_any_from_type_code, create_dyn_any

Constructor Detail

DynAnyFactoryPOA

public DynAnyFactoryPOA()

Method Detail

_invoke

public OutputStream _invoke(String $method,
                            InputStream in,
                            ResponseHandler $rh)

Description copied from interface: InvokeHandler

Invoked by the ORB to dispatch a request to the servant. ORB passes the method name, an InputStream containing the marshalled arguments, and a ResponseHandler which the servant uses to construct a proper reply. Only CORBA SystemException may be thrown by this method. The method must return an OutputStream created by the ResponseHandler which contains the marshalled reply. A servant must not retain a reference to the ResponseHandler beyond the lifetime of a method invocation. Servant behaviour is defined as follows:

1. Determine correct method, and unmarshal parameters from InputStream.

2. Invoke method implementation.

3. If no user exception, create a normal reply using ResponseHandler.

4. If user exception occurred, create exception reply using ResponseHandler.

5. Marshal reply into OutputStream returned by ResponseHandler.

6. Return OutputStream to ORB.

Specified by:

_invoke in interface InvokeHandler

Parameters:

$method - The method name.

in - The InputStream containing the marshalled arguments.

$rh - The ResponseHandler which the servant uses to construct a proper reply

Returns:

The OutputStream created by the ResponseHandler which contains the marshalled reply

_all_interfaces

public String[] _all_interfaces(POA poa,
                                byte[] objectId)

Description copied from class: Servant

Used by the ORB to obtain complete type information from the servant.

Specified by:

_all_interfaces in class Servant

Parameters:

poa - POA with which the servant is associated.

objectId - is the id corresponding to the object associated with this servant.

Returns:

list of type information for the object.

_this

public DynAnyFactory _this()

_this

public DynAnyFactory _this(ORB orb)