File	Doc	Category	Size	Date	Package
PIHandler.java	API Doc	Java SE 5 API	9983	Fri Aug 26 14:54:40 BST 2005	com.sun.corba.se.spi.protocol

PIHandler

Fields Summary

Constructors Summary

Methods Summary
public void	adapterManagerStateChanged(int managerId, short newState) Called whenever a state change occurs in an adapter manager. param managerId managerId The adapter manager id param newState newState The new state of the adapter manager, and by implication of all object adapters managed by this manager.
public void	adapterStateChanged(org.omg.PortableInterceptor.ObjectReferenceTemplate[] templates, short newState) Called whenever a state change occurs in an object adapter that was not caused by an adapter manager state change. param templates The templates that are changing state. param newState The new state of the adapters identified by the templates.
public int	allocateServerRequestId()
public void	cleanupClientPIRequest() Invoked when a request is about to be cleaned up. Must be called after ending points are called so that the info object on the stack can be deinitialized and popped from the stack at the appropriate time.
public void	cleanupServerPIRequest() Invoked when a request is about to be cleaned up. Must be called after ending points are called so that the info object on the stack can be deinitialized and popped from the stack at the appropriate time.
public org.omg.CORBA.Policy	create_policy(int type, org.omg.CORBA.Any val)
public void	destroyInterceptors()
public void	disableInterceptorsThisThread() Called for pseudo-ops to temporarily disable portable interceptor hooks for calls on this thread. Keeps track of the number of times this is called and increments the disabledCount.
public void	enableInterceptorsThisThread() Called for pseudo-ops to re-enable portable interceptor hooks for calls on this thread. Decrements the disabledCount. If disabledCount is 0, interceptors are re-enabled.
public org.omg.PortableInterceptor.Current	getPICurrent()
public void	initialize() Complete the initialization of the PIHandler. This will execute the methods on the ORBInitializers, if any are defined. This must be done here so that the ORB can obtain the PIHandler BEFORE the ORBInitializers run, since they will need access to the PIHandler through the ORB.
public void	initializeServerPIInfo(com.sun.corba.se.spi.protocol.CorbaMessageMediator request, com.sun.corba.se.spi.oa.ObjectAdapter oa, byte[] objectId, com.sun.corba.se.spi.ior.ObjectKeyTemplate oktemp) Notifies PI to start a new server request and set initial information for server-side interceptors. PI will use this information as a source of information for the ServerRequestInfo object. poaimpl is declared as an Object so that we need not introduce a dependency on the POA package.
public void	initiateClientPIRequest(boolean diiRequest) Invoked when a request is about to be created. Must be called before any of the setClientPI* methods so that a new info object can be prepared for information collection. param diiRequest True if this is to be a DII request, or false if it is a "normal" request. In the DII case, initiateClientPIRequest is called twice and we need to ignore the second one.
public java.lang.Exception	invokeClientPIEndingPoint(int replyStatus, java.lang.Exception exception) Called when the appropriate client ending interception point is to be invoked for all apporpriate client-side request interceptors. param replyStatus One of the constants in iiop.messages.ReplyMessage indicating which reply status to set. param exception The exception before ending interception points have been invoked, or null if no exception at the moment. return The exception to be thrown, after having gone through all ending points, or null if there is no exception to be thrown. Note that this exception can be either the same or different from the exception set using setClientPIException. There are four possible return types: null (no exception), SystemException, UserException, or RemarshalException.
public void	invokeClientPIStartingPoint() Called when the send_request or send_poll portable interception point is to be invoked for all appropriate client-side request interceptors. exception RemarhsalException - Thrown when this request needs to be retried.
public void	invokeServerPIEndingPoint(com.sun.corba.se.impl.protocol.giopmsgheaders.ReplyMessage replyMessage) Called when the appropriate server ending interception point is to be invoked for all appropriate server-side request interceptors. param replyMessage The iiop.messages.ReplyMessage containing the reply status. throws ForwardException Thrown if an interceptor raises ForwardRequest. This is an unchecked exception so that we need not modify the entire execution path to declare throwing ForwardException.
public void	invokeServerPIIntermediatePoint() Called when the appropriate server intermediate interception point is to be invoked for all appropriate server-side request interceptors. throws ForwardException Thrown if an interceptor raises ForwardRequest. This is an unchecked exception so that we need not modify the entire execution path to declare throwing ForwardException.
public void	invokeServerPIStartingPoint() Called when the appropriate server starting interception point is to be invoked for all appropriate server-side request interceptors. throws ForwardException Thrown if an interceptor raises ForwardRequest. This is an unchecked exception so that we need not modify the entire execution path to declare throwing ForwardException.
public void	objectAdapterCreated(com.sun.corba.se.spi.oa.ObjectAdapter oa) Called when a new object adapter is created. param oa The adapter associated with the interceptors to be invoked.
public void	registerPolicyFactory(int type, org.omg.PortableInterceptor.PolicyFactory factory)
public void	register_interceptor(org.omg.PortableInterceptor.Interceptor interceptor, int type)
public void	setClientPIInfo(com.sun.corba.se.impl.corba.RequestImpl requestImpl) Notifies PI of additional information for client-side interceptors. PI will use this information as a source of information for the ClientRequestInfo object.
public void	setClientPIInfo(com.sun.corba.se.spi.protocol.CorbaMessageMediator messageMediator) Notify PI of the MessageMediator for the request.
public void	setServerPIExceptionInfo(org.omg.CORBA.Any exception) Notifies PI of additional information for server-side interceptors. PI will use this information as a source of information for the ServerRequestInfo object. This is the exception of a DSI request.
public void	setServerPIInfo(java.lang.Object servant, java.lang.String targetMostDerivedInterface) Notifies PI of additional information reqired for ServerRequestInfo. param servant The servant. This is java.lang.Object because in the POA case, this will be a org.omg.PortableServer.Servant whereas in the ServerRequestDispatcher case this will be an ObjectImpl. param targetMostDerivedInterface. The most derived interface. This is passed in instead of calculated when needed because it requires extra information in the POA case that we didn't want to bother creating extra methods for to pass in.
public void	setServerPIInfo(java.lang.Exception exception) Notifies PI of additional information required for ServerRequestInfo.
public void	setServerPIInfo(org.omg.CORBA.NVList arguments) Notifies PI of additional information for server-side interceptors. PI will use this information as a source of information for the ServerRequestInfo object. These are the arguments for a DSI request.
public void	setServerPIInfo(org.omg.CORBA.Any result) Notifies PI of additional information for server-side interceptors. PI will use this information as a source of information for the ServerRequestInfo object. This is the result of a DSI request.