--- old/src/java.corba/share/classes/org/omg/CORBA/portable/InvokeHandler.java 2018-01-30 20:28:51.000000000 -0500 +++ /dev/null 2018-01-30 20:28:51.000000000 -0500 @@ -1,72 +0,0 @@ -/* - * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved. - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. Oracle designates this - * particular file as subject to the "Classpath" exception as provided - * by Oracle in the LICENSE file that accompanied this code. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ -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: - *

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. - */ - - OutputStream _invoke(String method, InputStream input, - ResponseHandler handler) - throws org.omg.CORBA.SystemException; -}