You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
73 lines
2.1 KiB
73 lines
2.1 KiB
/*
|
|
* Copyright (c) 1998, 1999, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
package org.omg.CORBA.portable;
|
|
|
|
/**
|
|
This interface provides a dispatching mechanism for an incoming call.
|
|
It is invoked by the ORB to dispatch a request to a servant.
|
|
*/
|
|
|
|
public interface InvokeHandler {
|
|
/**
|
|
* 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:
|
|
* <p>1. Determine correct method, and unmarshal parameters from
|
|
* InputStream.
|
|
* <p>2. Invoke method implementation.
|
|
* <p>3. If no user exception, create a normal reply using
|
|
* ResponseHandler.
|
|
* <p>4. If user exception occurred, create exception reply using
|
|
* ResponseHandler.
|
|
* <p>5. Marshal reply into OutputStream returned by
|
|
* ResponseHandler.
|
|
* <p>6. Return OutputStream to ORB.
|
|
* <p>
|
|
* @param method The method name.
|
|
* @param input The <code>InputStream</code> containing the marshalled arguments.
|
|
* @param handler The <code>ResponseHandler</code> which the servant uses
|
|
* to construct a proper reply
|
|
* @return The <code>OutputStream</code> created by the
|
|
* ResponseHandler which contains the marshalled reply
|
|
* @throws SystemException is thrown when invocation fails due to a CORBA system exception.
|
|
*/
|
|
|
|
OutputStream _invoke(String method, InputStream input,
|
|
ResponseHandler handler)
|
|
throws org.omg.CORBA.SystemException;
|
|
}
|