org.omg.CORBA.portable

Interface InvokeHandler

All Known Subinterfaces:

Tie

All Known Implementing Classes:

_CodeBaseImplBase, com.sun.corba.se.spi.activation._RepositoryImplBase, com.sun.corba.se.spi.activation._ServerManagerImplBase, AbstractInterfaceDefPOA, AbstractInterfaceDefPOATie, ActivatorPOA, ActivatorPOA, ActivatorPOATie, ActivatorPOATie, AliasDefPOA, AliasDefPOATie, ArrayDefPOA, ArrayDefPOATie, AttributeDefPOA, AttributeDefPOATie, BindingIteratorImpl, BindingIteratorPOA, BindingIteratorPOATie, CachedCodeBase, ComponentDefPOA, ComponentDefPOATie, ConstantDefPOA, ConstantDefPOATie, ConsumesDefPOA, ConsumesDefPOATie, ContainedPOA, ContainedPOATie, ContainerPOA, ContainerPOA, ContainerPOATie, ContainerPOATie, DynAnyFactoryPOA, DynAnyFactoryPOATie, DynAnyPOA, DynAnyPOATie, DynArrayPOA, DynArrayPOATie, DynEnumPOA, DynEnumPOATie, DynFixedPOA, DynFixedPOATie, DynSequencePOA, DynSequencePOATie, DynStructPOA, DynStructPOATie, DynUnionPOA, DynUnionPOATie, DynValueBoxPOA, DynValueBoxPOATie, DynValueCommonPOA, DynValueCommonPOATie, DynValuePOA, DynValuePOATie, EmitsDefPOA, EmitsDefPOATie, EnumDefPOA, EnumDefPOATie, EventDefPOA, EventDefPOATie, EventPortDefPOA, EventPortDefPOATie, ExceptionDefPOA, ExceptionDefPOATie, ExtAbstractInterfaceDefPOA, ExtAbstractInterfaceDefPOATie, ExtAttributeDefPOA, ExtAttributeDefPOATie, ExtInterfaceDefPOA, ExtInterfaceDefPOATie, ExtLocalInterfaceDefPOA, ExtLocalInterfaceDefPOATie, ExtValueDefPOA, ExtValueDefPOATie, FactoryDefPOA, FactoryDefPOATie, FinderDefPOA, FinderDefPOATie, FixedDefPOA, FixedDefPOATie, FVDCodeBaseImpl, HomeDefPOA, HomeDefPOATie, IDLTypePOA, IDLTypePOATie, InitialNameServicePOA, InitialNameServicePOA, InitialNameServicePOATie, InitialNameServicePOATie, InterfaceAttrExtensionPOA, InterfaceAttrExtensionPOATie, InterfaceDefPOA, InterfaceDefPOATie, IRObjectPOA, IRObjectPOATie, LocalInterfaceDefPOA, LocalInterfaceDefPOATie, LocatorPOA, LocatorPOA, LocatorPOATie, LocatorPOATie, ModuleDefPOA, ModuleDefPOA, ModuleDefPOATie, ModuleDefPOATie, NamingContextExtPOA, NamingContextExtPOATie, NamingContextImpl, NamingContextImpl, NamingContextPOA, NamingContextPOATie, NativeDefPOA, NativeDefPOATie, OperationDefPOA, OperationDefPOATie, ORBProxyPOA, ORBProxyPOATie, PersistentBindingIterator, PrimitiveDefPOA, PrimitiveDefPOATie, ProvidesDefPOA, ProvidesDefPOATie, PublishesDefPOA, PublishesDefPOATie, ReflectiveTie, RepositoryImpl, RepositoryPOA, RepositoryPOA, RepositoryPOA, RepositoryPOA, RepositoryPOATie, RepositoryPOATie, RepositoryPOATie, RepositoryPOATie, SequenceDefPOA, SequenceDefPOATie, ServantActivatorPOA, ServantActivatorPOATie, ServantLocatorPOA, ServantLocatorPOATie, ServerManagerImpl, ServerManagerPOA, ServerManagerPOA, ServerManagerPOATie, ServerManagerPOATie, ServerPOA, ServerPOATie, ServerProxyPOA, ServerProxyPOATie, StringDefPOA, StringDefPOATie, StructDefPOA, StructDefPOATie, TransientBindingIterator, TransientNamingContext, TypedefDefPOA, TypedefDefPOATie, UnionDefPOA, UnionDefPOATie, UsesDefPOA, UsesDefPOATie, ValueBoxDefPOA, ValueBoxDefPOATie, ValueDefPOA, ValueDefPOATie, ValueMemberDefPOA, ValueMemberDefPOATie, WstringDefPOA, WstringDefPOATie

public interface InvokeHandler

This interface provides a dispatching mechanism for an incoming call. It is invoked by the ORB to dispatch a request to a servant.

Method Summary

Modifier and Type	Method and Description
OutputStream	_invoke(String method, InputStream input, ResponseHandler handler) Invoked by the ORB to dispatch a request to the servant.

Method Detail

_invoke

OutputStream _invoke(String method,
                     InputStream input,
                     ResponseHandler handler)
              throws SystemException

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.

Parameters:

method - The method name.

input - The InputStream containing the marshalled arguments.

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

Returns:

The OutputStream created by the ResponseHandler which contains the marshalled reply

Throws:

SystemException - is thrown when invocation fails due to a CORBA system exception.