Interface InvokeHandler

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.