org.omg.CORBA.portable
Interface InvokeHandler

All Known Subinterfaces:
Tie sample code for javax.rmi.CORBA.Tie definition code for javax.rmi.CORBA.Tie
All Known Implementing Classes:
BindingIteratorPOA sample code for org.omg.CosNaming.BindingIteratorPOA definition code for org.omg.CosNaming.BindingIteratorPOA , NamingContextExtPOA sample code for org.omg.CosNaming.NamingContextExtPOA definition code for org.omg.CosNaming.NamingContextExtPOA , NamingContextPOA sample code for org.omg.CosNaming.NamingContextPOA definition code for org.omg.CosNaming.NamingContextPOA , ServantActivatorPOA sample code for org.omg.PortableServer.ServantActivatorPOA definition code for org.omg.PortableServer.ServantActivatorPOA , ServantLocatorPOA sample code for org.omg.PortableServer.ServantLocatorPOA definition code for org.omg.PortableServer.ServantLocatorPOA

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
 OutputStream sample code for org.omg.CORBA.portable.OutputStream definition code for org.omg.CORBA.portable.OutputStream _invoke sample code for org.omg.CORBA.portable.InvokeHandler._invoke(java.lang.String, org.omg.CORBA.portable.InputStream, org.omg.CORBA.portable.ResponseHandler) definition code for org.omg.CORBA.portable.InvokeHandler._invoke(java.lang.String, org.omg.CORBA.portable.InputStream, org.omg.CORBA.portable.ResponseHandler) (String sample code for java.lang.String definition code for java.lang.String  method, InputStream sample code for org.omg.CORBA.portable.InputStream definition code for org.omg.CORBA.portable.InputStream  input, ResponseHandler sample code for org.omg.CORBA.portable.ResponseHandler definition code for org.omg.CORBA.portable.ResponseHandler  handler)
          Invoked by the ORB to dispatch a request to the servant.
 

Method Detail

_invoke sample code for org.omg.CORBA.portable.InvokeHandler._invoke(java.lang.String, org.omg.CORBA.portable.InputStream, org.omg.CORBA.portable.ResponseHandler) definition code for org.omg.CORBA.portable.InvokeHandler._invoke(java.lang.String, org.omg.CORBA.portable.InputStream, org.omg.CORBA.portable.ResponseHandler)

OutputStream sample code for org.omg.CORBA.portable.OutputStream definition code for org.omg.CORBA.portable.OutputStream  _invoke(String sample code for java.lang.String definition code for java.lang.String  method,
                     InputStream sample code for org.omg.CORBA.portable.InputStream definition code for org.omg.CORBA.portable.InputStream  input,
                     ResponseHandler sample code for org.omg.CORBA.portable.ResponseHandler definition code for org.omg.CORBA.portable.ResponseHandler  handler)
                     throws SystemException sample code for org.omg.CORBA.SystemException definition code for org.omg.CORBA.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.