FileDocCategorySizeDatePackage
InvokeHandler.javaAPI DocJava SE 5 API2066Fri Aug 26 14:58:34 BST 2005org.omg.CORBA.portable

InvokeHandler

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.

Fields Summary
Constructors Summary
Methods Summary
public OutputStream_invoke(java.lang.String method, InputStream input, ResponseHandler handler)
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.

param
method The method name.
param
input The InputStream containing the marshalled arguments.
param
handler The ResponseHandler which the servant uses to construct a proper reply
return
The OutputStream created by the ResponseHandler which contains the marshalled reply
throws
SystemException is thrown when invocation fails due to a CORBA system exception.