package org.omg.PortableInterceptor;


/**
* org/omg/PortableInterceptor/CurrentOperations.java .
* Generated by the IDL-to-Java compiler (portable), version "3.2"
* from /var/lib/jenkins/jobs/openjdk/jobs/openjdk10/workspace/jdk-updates_jdk10u/src/java.corba/share/classes/org/omg/PortableInterceptor/Interceptors.idl
* Sunday, February 14, 2021 at 5:20:32 PM Coordinated Universal Time
*/


Portable Interceptors Current (also known as PICurrent) is merely a slot table, the slots of which are used by each service to transfer their context data between their context and the request's or reply's service context. Each service which wishes to use PICurrent reserves a slot or slots at initialization time and uses those slots during the processing of requests and replies.

Before an invocation is made, PICurrent is obtained via a call to ORB.resolve_initial_references( "PICurrent" ). From within the interception points, the data on PICurrent that has moved from the thread scope to the request scope is available via the get_slot operation on the RequestInfo object. A PICurrent can still be obtained via resolve_initial_references, but that is the Interceptor's thread scope PICurrent.

/** * Portable Interceptors Current (also known as <code>PICurrent</code>) * is merely a slot table, the slots of which are used by each service to * transfer their context data between their context and the request's or * reply's service context. Each service which wishes to use PICurrent * reserves a slot or slots at initialization time and uses those slots * during the processing of requests and replies. * <p> * Before an invocation is made, PICurrent is obtained via a call to * <code>ORB.resolve_initial_references( "PICurrent" )</code>. From within * the interception points, the data on PICurrent that has moved from the * thread scope to the request scope is available via the * <code>get_slot</code> operation on the <code>RequestInfo</code> object. * A PICurrent can still be obtained via * <code>resolve_initial_references</code>, but that is the Interceptor's * thread scope PICurrent. */
public interface CurrentOperations extends org.omg.CORBA.CurrentOperations {
Retrieves the slot data the application set in PICurrent via get_slot. The data is in the form of an Any.

If the given slot has not been set, an Any containing a type code with a TCKind value of tk_null and no value is returned.

Params:
  • id – The SlotId of the slot from which the data will be returned.
Throws:
  • InvalidSlot – thrown if get_slot is called on a slot that has not been allocated.
  • BAD_INV_ORDER – thrown if get_slot is called from within an ORB initializer
Returns:The data, in the form of an Any, of the given slot identifier.
/** * Retrieves the slot data the application set in PICurrent via * <code>get_slot</code>. The data is in the form of an Any. * <p> * If the given slot has not been set, an Any containing a type code * with a <code>TCKind</code> value of <code>tk_null</code> and no value * is returned. * * @param id The <code>SlotId</code> of the slot from which the data will * be returned. * @return The data, in the form of an Any, of the given slot identifier. * @exception InvalidSlot thrown if get_slot is called on a slot that * has not been allocated. * @exception BAD_INV_ORDER thrown if <code>get_slot</code> is called * from within an ORB initializer */
org.omg.CORBA.Any get_slot (int id) throws org.omg.PortableInterceptor.InvalidSlot;
Sets data in a slot. The data is in the form of an Any. If data already exists in that slot, it is overridden.
Params:
  • id – The SlotId of the slot to which the data will be set.
  • data – The data, in the form of an Any, which will be set to the identified slot.
Throws:
  • InvalidSlot – thrown if set_slot is called on a slot that has not been allocated.
  • BAD_INV_ORDER – thrown if set_slot is called from within an ORB initializer.
/** * Sets data in a slot. The data is in the form of an Any. If data * already exists in that slot, it is overridden. * * @param id The <code>SlotId</code> of the slot to which the data will * be set. * @param data The data, in the form of an Any, which will be set * to the identified slot. * @exception InvalidSlot thrown if <code>set_slot</code> is called on * a slot that has not been allocated. * @exception BAD_INV_ORDER thrown if <code>set_slot</code> is called * from within an ORB initializer. */
void set_slot (int id, org.omg.CORBA.Any data) throws org.omg.PortableInterceptor.InvalidSlot; } // interface CurrentOperations