Class PINoOpHandlerImpl

  • All Implemented Interfaces:
    PIHandler, java.io.Closeable, java.lang.AutoCloseable

    public class PINoOpHandlerImpl
    extends java.lang.Object
    implements PIHandler
    This is No-Op implementation of PIHandler. It is used in ORBConfigurator to initialize a piHandler before the Persistent Server Activation. This PIHandler implementation will be replaced by the real PIHandler in ORB.postInit( ) call.
    • Constructor Detail

      • PINoOpHandlerImpl

        public PINoOpHandlerImpl()
    • Method Detail

      • close

        public void close()
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
      • initialize

        public void initialize()
        Description copied from interface: PIHandler
        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.
        Specified by:
        initialize in interface PIHandler
      • objectAdapterCreated

        public void objectAdapterCreated​(ObjectAdapter oa)
        Description copied from interface: PIHandler
        Called when a new object adapter is created.
        Specified by:
        objectAdapterCreated in interface PIHandler
        Parameters:
        oa - The adapter associated with the interceptors to be invoked.
      • adapterManagerStateChanged

        public void adapterManagerStateChanged​(int managerId,
                                               short newState)
        Description copied from interface: PIHandler
        Called whenever a state change occurs in an adapter manager.
        Specified by:
        adapterManagerStateChanged in interface PIHandler
        Parameters:
        managerId - managerId The adapter manager id
        newState - newState The new state of the adapter manager, and by implication of all object adapters managed by this manager.
      • adapterStateChanged

        public void adapterStateChanged​(ObjectReferenceTemplate[] templates,
                                        short newState)
        Description copied from interface: PIHandler
        Called whenever a state change occurs in an object adapter that was not caused by an adapter manager state change.
        Specified by:
        adapterStateChanged in interface PIHandler
        Parameters:
        templates - The templates that are changing state.
        newState - The new state of the adapters identified by the templates.
      • disableInterceptorsThisThread

        public void disableInterceptorsThisThread()
        Description copied from interface: PIHandler
        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.
        Specified by:
        disableInterceptorsThisThread in interface PIHandler
      • enableInterceptorsThisThread

        public void enableInterceptorsThisThread()
        Description copied from interface: PIHandler
        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.
        Specified by:
        enableInterceptorsThisThread in interface PIHandler
      • invokeClientPIStartingPoint

        public void invokeClientPIStartingPoint()
                                         throws RemarshalException
        Description copied from interface: PIHandler
        Called when the send_request or send_poll portable interception point is to be invoked for all appropriate client-side request interceptors.
        Specified by:
        invokeClientPIStartingPoint in interface PIHandler
        Throws:
        RemarshalException - - Thrown when this request needs to be retried.
      • invokeClientPIEndingPoint

        public java.lang.Exception invokeClientPIEndingPoint​(int replyStatus,
                                                             java.lang.Exception exception)
        Description copied from interface: PIHandler
        Called when the appropriate client ending interception point is to be invoked for all apporpriate client-side request interceptors.
        Specified by:
        invokeClientPIEndingPoint in interface PIHandler
        Parameters:
        replyStatus - One of the constants in iiop.messages.ReplyMessage indicating which reply status to set.
        exception - The exception before ending interception points have been invoked, or null if no exception at the moment.
        Returns:
        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.
      • makeCompletedClientRequest

        public java.lang.Exception makeCompletedClientRequest​(int replyStatus,
                                                              java.lang.Exception exception)
        Description copied from interface: PIHandler
        Called when a retry is needed after initiateClientPIRequest but before invokeClientPIRequest. In this case, we need to properly balance initiateClientPIRequest/cleanupClientPIRequest calls, but WITHOUT extraneous calls to invokeClientPIEndingPoint (see bug 6763340).
        Specified by:
        makeCompletedClientRequest in interface PIHandler
        Parameters:
        replyStatus - One of the constants in iiop.messages.ReplyMessage indicating which reply status to set.
        exception - The exception before ending interception points have been invoked, or null if no exception at the moment.
        Returns:
        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.
      • initiateClientPIRequest

        public void initiateClientPIRequest​(boolean diiRequest)
        Description copied from interface: PIHandler
        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.
        Specified by:
        initiateClientPIRequest in interface PIHandler
        Parameters:
        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.
      • cleanupClientPIRequest

        public void cleanupClientPIRequest()
        Description copied from interface: PIHandler
        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.
        Specified by:
        cleanupClientPIRequest in interface PIHandler
      • setClientPIInfo

        public void setClientPIInfo​(MessageMediator messageMediator)
        Description copied from interface: PIHandler
        Notify PI of the MessageMediator for the request.
        Specified by:
        setClientPIInfo in interface PIHandler
        Parameters:
        messageMediator - Mediator to notify
      • setClientPIInfo

        public void setClientPIInfo​(RequestImpl requestImpl)
        Description copied from interface: PIHandler
        Notifies PI of additional information for client-side interceptors. PI will use this information as a source of information for the ClientRequestInfo object.
        Specified by:
        setClientPIInfo in interface PIHandler
        Parameters:
        requestImpl - request used as source of information
      • sendCancelRequestIfFinalFragmentNotSent

        public final void sendCancelRequestIfFinalFragmentNotSent()
      • invokeServerPIStartingPoint

        public void invokeServerPIStartingPoint()
        Description copied from interface: PIHandler
        Called when the appropriate server starting interception point is to be invoked for all appropriate server-side request interceptors.
        Specified by:
        invokeServerPIStartingPoint in interface PIHandler
      • invokeServerPIIntermediatePoint

        public void invokeServerPIIntermediatePoint()
        Description copied from interface: PIHandler
        Called when the appropriate server intermediate interception point is to be invoked for all appropriate server-side request interceptors.
        Specified by:
        invokeServerPIIntermediatePoint in interface PIHandler
      • invokeServerPIEndingPoint

        public void invokeServerPIEndingPoint​(ReplyMessage replyMessage)
        Description copied from interface: PIHandler
        Called when the appropriate server ending interception point is to be invoked for all appropriate server-side request interceptors.
        Specified by:
        invokeServerPIEndingPoint in interface PIHandler
        Parameters:
        replyMessage - The iiop.messages.ReplyMessage containing the reply status.
      • setServerPIInfo

        public void setServerPIInfo​(java.lang.Exception exception)
        Description copied from interface: PIHandler
        Notifies PI of additional information required for ServerRequestInfo.
        Specified by:
        setServerPIInfo in interface PIHandler
        Parameters:
        exception - the exception that will be returned
      • setServerPIInfo

        public void setServerPIInfo​(NVList arguments)
        Description copied from interface: PIHandler
        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.
        Specified by:
        setServerPIInfo in interface PIHandler
        Parameters:
        arguments - Arguments for a DSI request.
      • setServerPIExceptionInfo

        public void setServerPIExceptionInfo​(Any exception)
        Description copied from interface: PIHandler
        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.
        Specified by:
        setServerPIExceptionInfo in interface PIHandler
        Parameters:
        exception - Exception of a DSI request
      • setServerPIInfo

        public void setServerPIInfo​(Any result)
        Description copied from interface: PIHandler
        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.
        Specified by:
        setServerPIInfo in interface PIHandler
        Parameters:
        result - Result of a DSI request
      • initializeServerPIInfo

        public void initializeServerPIInfo​(MessageMediator request,
                                           ObjectAdapter oa,
                                           byte[] objectId,
                                           ObjectKeyTemplate oktemp)
        Description copied from interface: PIHandler
        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.
        Specified by:
        initializeServerPIInfo in interface PIHandler
        Parameters:
        request - Request holder, included the Connection
        oa - Object Adapter
        objectId - id of object
        oktemp - template for object
      • setServerPIInfo

        public void setServerPIInfo​(java.lang.Object servant,
                                    java.lang.String targetMostDerivedInterface)
        Description copied from interface: PIHandler
        Notifies PI of additional information reqired for ServerRequestInfo.
        Specified by:
        setServerPIInfo in interface PIHandler
        Parameters:
        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.
        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.
      • cleanupServerPIRequest

        public void cleanupServerPIRequest()
        Description copied from interface: PIHandler
        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.
        Specified by:
        cleanupServerPIRequest in interface PIHandler