Package org.omg.CORBA.portable

Interface InvokeHandler

All Known Subinterfaces:
Tie
All Known Implementing Classes:
_CodeBaseImplBase, AliasDefPOA, AliasDefPOATie, ArrayDefPOA, ArrayDefPOATie, AttributeDefPOA, AttributeDefPOATie, BindingIteratorImpl, BindingIteratorPOA, BindingIteratorPOATie, CachedCodeBase, CodeBasePOA, CodeBasePOATie, ConstantDefPOA, ConstantDefPOATie, ContainedPOA, ContainedPOATie, ContainerPOA, ContainerPOATie, ControlPOA, ControlPOATie, CoordinatorPOA, CoordinatorPOATie, CurrentPOA, CurrentPOATie, DynAnyFactoryPOA, DynAnyFactoryPOATie, DynAnyPOA, DynAnyPOATie, DynArrayPOA, DynArrayPOATie, DynEnumPOA, DynEnumPOATie, DynFixedPOA, DynFixedPOATie, DynSequencePOA, DynSequencePOATie, DynStructPOA, DynStructPOATie, DynUnionPOA, DynUnionPOATie, DynValueBoxPOA, DynValueBoxPOATie, DynValueCommonPOA, DynValueCommonPOATie, DynValuePOA, DynValuePOATie, EnumDefPOA, EnumDefPOATie, ExceptionDefPOA, ExceptionDefPOATie, FVDCodeBaseImpl, InterfaceDefPOA, InterfaceDefPOATie, InvocationPolicyPOA, InvocationPolicyPOATie, MaxHopsPolicyPOA, MaxHopsPolicyPOATie, ModuleDefPOA, ModuleDefPOATie, NamingContextExtPOA, NamingContextExtPOATie, NamingContextImpl, NamingContextPOA, NamingContextPOATie, NativeDefPOA, NativeDefPOATie, NonTxTargetPolicyPOA, NonTxTargetPolicyPOATie, OperationDefPOA, OperationDefPOATie, OTSPolicyPOA, OTSPolicyPOATie, PrimitiveDefPOA, PrimitiveDefPOATie, QueueOrderPolicyPOA, QueueOrderPolicyPOATie, RebindPolicyPOA, RebindPolicyPOATie, RecoveryCoordinatorPOA, RecoveryCoordinatorPOATie, ReflectiveTie, RelativeRequestTimeoutPolicyPOA, RelativeRequestTimeoutPolicyPOATie, RelativeRoundtripTimeoutPolicyPOA, RelativeRoundtripTimeoutPolicyPOATie, ReplyEndTimePolicyPOA, ReplyEndTimePolicyPOATie, ReplyPriorityPolicyPOA, ReplyPriorityPolicyPOATie, ReplyStartTimePolicyPOA, ReplyStartTimePolicyPOATie, RepositoryPOA, RepositoryPOATie, RequestEndTimePolicyPOA, RequestEndTimePolicyPOATie, RequestPriorityPolicyPOA, RequestPriorityPolicyPOATie, RequestStartTimePolicyPOA, RequestStartTimePolicyPOATie, ResourcePOA, ResourcePOATie, RoutingPolicyPOA, RoutingPolicyPOATie, RunTimePOA, RunTimePOATie, SequenceDefPOA, SequenceDefPOATie, ServantActivatorPOA, ServantActivatorPOATie, ServantLocatorPOA, ServantLocatorPOATie, StringDefPOA, StringDefPOATie, StructDefPOA, StructDefPOATie, SubtransactionAwareResourcePOA, SubtransactionAwareResourcePOATie, SynchronizationPOA, SynchronizationPOATie, SyncScopePolicyPOA, SyncScopePolicyPOATie, TerminatorPOA, TerminatorPOATie, TransactionalObjectPOA, TransactionalObjectPOATie, TransactionFactoryPOA, TransactionFactoryPOATie, TransientBindingIterator, TransientNamingContext, TypedefDefPOA, TypedefDefPOATie, UnionDefPOA, UnionDefPOATie, ValueBoxDefPOA, ValueBoxDefPOATie, ValueDefPOA, ValueDefPOATie, ValueMemberDefPOA, ValueMemberDefPOATie
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 Details

    • _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.