< prev index next >
src/java.corba/share/classes/org/omg/PortableInterceptor/Interceptors.idl
Print this page
*** 1,7 ****
/*
! * Copyright (c) 2000, 2010, 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
--- 1,7 ----
/*
! * 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
*** 477,487 ****
* <li><code>PortableInterceptor.TRANSPORT_RETRY</code></li>
* </ul>
* On the client:
* <ul>
* <li>Within the <code>receive_reply</code> interception point, this
! * will only return <code>SUCCESSFUL</code></li>.
* <li>Within the <code>receive_exception</code> interception point,
* this will be either <code>SYSTEM_EXCEPTION</code> or
* <code>USER_EXCEPTION</code>.</li>
* <li>Within the <code>receive_other</code> interception point, this
* will be any of: <code>SUCCESSFUL</code>,
--- 477,487 ----
* <li><code>PortableInterceptor.TRANSPORT_RETRY</code></li>
* </ul>
* On the client:
* <ul>
* <li>Within the <code>receive_reply</code> interception point, this
! * will only return <code>SUCCESSFUL</code>.</li>
* <li>Within the <code>receive_exception</code> interception point,
* this will be either <code>SYSTEM_EXCEPTION</code> or
* <code>USER_EXCEPTION</code>.</li>
* <li>Within the <code>receive_other</code> interception point, this
* will be any of: <code>SUCCESSFUL</code>,
*** 543,553 ****
any get_slot (in SlotId id) raises (InvalidSlot);
/**
* Returns a copy of the service context with the given ID that
* is associated with the request.
! * <p>
* @param id The <code>IOP.ServiceId</code> of the service context
* which is to be returned.
* @return The <code>IOP.ServiceContext</code> obtained with the
* given identifier.
* @exception BAD_PARAM thrown with a standard minor code of 26, if the
--- 543,553 ----
any get_slot (in SlotId id) raises (InvalidSlot);
/**
* Returns a copy of the service context with the given ID that
* is associated with the request.
! *
* @param id The <code>IOP.ServiceId</code> of the service context
* which is to be returned.
* @return The <code>IOP.ServiceContext</code> obtained with the
* given identifier.
* @exception BAD_PARAM thrown with a standard minor code of 26, if the
*** 577,587 ****
* Some attributes and operations on <code>ClientRequestInfo</code> are
* not valid at all interception points. The following table shows the
* validity of each attribute or operation. If it is not valid, attempting
* to access it will result in a <code>BAD_INV_ORDER</code> being thrown
* with a standard minor code of 14.
- * <p>
*
* <table border=1 summary="Shows the validity of each attribute or operation">
* <thead>
* <tr>
* <th> </th>
--- 577,586 ----
*** 932,942 ****
* Some attributes and operations on <code>ServerRequestInfo</code> are not
* valid at all interception points. The following table shows the validity
* of each attribute or operation. If it is not valid, attempting to access
* it will result in a <code>BAD_INV_ORDER</code> being thrown with a
* standard minor code of 14.
- * <p>
*
*
* <table border=1 summary="Shows the validity of each attribute or operation">
* <thead>
* <tr>
--- 931,940 ----
*** 1026,1036 ****
*
* <tr><td><b>operation</b></td>
* <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
*
* <tr><td><b>arguments</b></td>
! * <td>no </td> <td>yes<sub>1</sub</td>
* <td>yes</td> <td>no<sub>2</sub></td>
* <td>no<sub>2</sub>
* </td></tr>
*
* <tr><td><b>exceptions</b></td>
--- 1024,1034 ----
*
* <tr><td><b>operation</b></td>
* <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td> <td>yes</td></tr>
*
* <tr><td><b>arguments</b></td>
! * <td>no </td> <td>yes<sub>1</sub></td>
* <td>yes</td> <td>no<sub>2</sub></td>
* <td>no<sub>2</sub>
* </td></tr>
*
* <tr><td><b>exceptions</b></td>
*** 1131,1141 ****
* <li>The operation is not available in this interception point because
* the necessary information requires access to the target object's
* servant, which may no longer be available to the ORB. For example,
* if the object's adapter is a POA that uses a
* <code>ServantLocator</code>, then the ORB invokes the interception
! * point after it calls <code>ServantLocator.postinvoke()</code></li>.
* </ol>
*
* @see ServerRequestInterceptor
*/
local interface ServerRequestInfo : RequestInfo {
--- 1129,1139 ----
* <li>The operation is not available in this interception point because
* the necessary information requires access to the target object's
* servant, which may no longer be available to the ORB. For example,
* if the object's adapter is a POA that uses a
* <code>ServantLocator</code>, then the ORB invokes the interception
! * point after it calls <code>ServantLocator.postinvoke()</code>.</li>
* </ol>
*
* @see ServerRequestInterceptor
*/
local interface ServerRequestInfo : RequestInfo {
*** 1887,1897 ****
* <code>CORBA.ORB.create_policy</code>.
*
* @param type An int specifying the type of policy being created.
* @param value An any containing data with which to construct the
* <code>CORBA.Policy</code>.
! * @return A <code>CORBA.Policy<code> object of the specified type and
* value.
*/
CORBA::Policy create_policy
(in CORBA::PolicyType type, in any value)
raises (CORBA::PolicyError);
--- 1885,1895 ----
* <code>CORBA.ORB.create_policy</code>.
*
* @param type An int specifying the type of policy being created.
* @param value An any containing data with which to construct the
* <code>CORBA.Policy</code>.
! * @return A <code>CORBA.Policy</code> object of the specified type and
* value.
*/
CORBA::Policy create_policy
(in CORBA::PolicyType type, in any value)
raises (CORBA::PolicyError);
*** 2122,2132 ****
* <p>
* <b><i>Example</i></b>
* <p>
* A client-side logging service written by company X, for example, may
* have the following ORBInitializer implementation:
! * <code><pre>
* package com.x.logging;
*
* import org.omg.PortableInterceptor.Interceptor;
* import org.omg.PortableInterceptor.ORBInitializer;
* import org.omg.PortableInterceptor.ORBInitInfo;
--- 2120,2130 ----
* <p>
* <b><i>Example</i></b>
* <p>
* A client-side logging service written by company X, for example, may
* have the following ORBInitializer implementation:
! * <pre><code>
* package com.x.logging;
*
* import org.omg.PortableInterceptor.Interceptor;
* import org.omg.PortableInterceptor.ORBInitializer;
* import org.omg.PortableInterceptor.ORBInitInfo;
*** 2142,2152 ****
*
* void post_init( ORBInitInfo info ) {
* // This service does not need two init points.
* }
* }
! * </pre></code>
* To run a program called <code>MyApp</code> using this logging
* service, the user could type:
* <blockquote><code>
* java
*-Dorg.omg.PortableInterceptor.ORBInitializerClass.com.x.Logging.LoggingService
--- 2140,2150 ----
*
* void post_init( ORBInitInfo info ) {
* // This service does not need two init points.
* }
* }
! * </code></pre>
* To run a program called <code>MyApp</code> using this logging
* service, the user could type:
* <blockquote><code>
* java
*-Dorg.omg.PortableInterceptor.ORBInitializerClass.com.x.Logging.LoggingService
< prev index next >