Mercurial > hg > jdk9-shenandoah > corba
view src/java.corba/share/classes/org/omg/PortableInterceptor/package.html @ 662:753f4114e6d6
8039440: Tidy warnings cleanup for org/omg
Summary: some HTML markup fixes for CORBA
Reviewed-by: yan, rriggs, lancea
author | avstepan |
---|---|
date | Wed, 08 Apr 2015 16:01:26 +0400 |
parents | 7e06bf1dcb09 |
children |
line wrap: on
line source
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <html> <head> <!-- Copyright (c) 2000, 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. --> </head> <body bgcolor="white"> Provides a mechanism to register ORB hooks through which ORB services can intercept the normal flow of execution of the ORB. <h2>Interceptor Types</h2> There are currently three types of interceptors that can be registered: <ul> <li>{@link org.omg.PortableInterceptor.IORInterceptor IORInterceptor} - Used to establish tagged components in the profiles within an IOR.</li> <li>{@link org.omg.PortableInterceptor.ClientRequestInterceptor ClientRequestInterceptor} - Intercepts the flow of a request/reply sequence through the ORB on the <i>client</i> side.</li> <li>{@link org.omg.PortableInterceptor.ServerRequestInterceptor ServerRequestInterceptor} - Intercepts the flow of a request/reply sequence through the ORB on the <i>server</i> side.</li> </ul> See the javadocs for class <code> {@link org.omg.PortableInterceptor.ORBInitializer ORBInitializer}</code> for how to go about registering interceptors. <a name="unimpl"></a> <h2>Known limitations / unimplemented methods in package <code>org.omg.PortableInterceptor</code></h2> <ul> <li> <code><b>RequestInfo</b></code> <ul> <li><code><b>sync_scope()</b></code>: Always returns SYNC_WITH_TRANSPORT</li> <li><code><b>arguments()</b></code>: Only supported for DII/DSI calls</li> <li><code><b>exceptions()</b></code>: Only supported for DII calls on client side. Not supported on server-side.</li> <li><code><b>contexts()</b></code>: Only supported for DII calls on client side. Not supported on server-side since our ORB does not send contexts. </li> <li><code><b>operation_context()</b></code>: Only supported for DII calls on client side. Not supported on server-side since ORB does not send contexts.</li> <li><code><b>result()</b></code>: Only supported for DII/DSI calls</li> </ul> </li> <li> <code><b>ClientRequestInfo</b></code> <ul> <li><code><b>received_exception_id()</b></code>: Always returns null in the DII case</li> <li><code><b>get_request_policy(int type)</b></code>: Not implemented.</li> </ul> </li> <li> <code><b>ServerRequestInfo</b></code> <ul> <li><code><b>sending_exception()</b></code>: Does not support user exceptions on the server side in non-DSI case.</li> </ul> </li> </ul> <h2>Package Specification</h2> <P>For a precise list of supported sections of official OMG specifications with which the Java[tm] Platform, Standard Edition 6 complies, see <A HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java SE 6</A>. @since 1.4 <br> @serial exclude </body> </html>