org.omg.PortableInterceptor
Interface ClientRequestInterceptorOperations

All Superinterfaces:
InterceptorOperations
All Known Subinterfaces:
ClientRequestInterceptor

public interface ClientRequestInterceptorOperations
extends InterceptorOperations

Defines operations, applicable to the client side request interceptor. The operations are called by ORB at the appropriate interception points.


Method Summary
 void receive_exception(ClientRequestInfo info)
          ORB calls this method after the receiving the message that a remote exception has been thrown on a server side and before raising this exception in the client side.
 void receive_other(ClientRequestInfo info)
          /** ORB normally calls this method after receiving the forwarding message.
 void receive_reply(ClientRequestInfo info)
          ORB calls this method after the normal reply is received from the server and before the control is returned to the calling client code.
 void send_poll(ClientRequestInfo info)
          This method is called by if ORB uses the Time- Independent Invocation (TII) polling.
 void send_request(ClientRequestInfo info)
          ORB calls this method before sending the request to the server.
 
Methods inherited from interface org.omg.PortableInterceptor.InterceptorOperations
destroy, name
 

Method Detail

send_request

void send_request(ClientRequestInfo info)
                  throws ForwardRequest
ORB calls this method before sending the request to the server.

Parameters:
info - the object for accessing and manipulating the request information.
Throws:
SystemException - if it does, the send_request is not called for the subsequent interceptors, calling receive_exception instead. The completion status of this exception must be COMPLETED_NO.
ForwardRequest - to forward the invocation to another target. The send_request is not called for the subsequent interceptors, calling receive_other instead.

receive_reply

void receive_reply(ClientRequestInfo info)
ORB calls this method after the normal reply is received from the server and before the control is returned to the calling client code.

Parameters:
info - the object for accessing and manipulating the request information.
Throws:
SystemException - if it does, the receive_reply is not called for the subsequent interceptors, calling receive_exception instead. The completion status of this exception must be COMPLETED_YES.

receive_exception

void receive_exception(ClientRequestInfo info)
                       throws ForwardRequest
ORB calls this method after the receiving the message that a remote exception has been thrown on a server side and before raising this exception in the client side.

Parameters:
info - the object for accessing and manipulating the request information.
Throws:
SystemException - has the effect of changing the exception that successive interceptors receive on their calls to receive_other. If the original exception is a system exception, the completion_status of the new exception must match the exception being replaced. If the original exception is a user exception, then the completion_status of the new exception must be COMPLETED_YES.
ForwardRequest - to forward the invocation to another target. The receive_exception is not called for the subsequent interceptors, calling receive_other instead. If the completion_status of the original exception is not a COMPLETED_NO, the ForwardRequest must not be raised.

receive_other

void receive_other(ClientRequestInfo info)
                   throws ForwardRequest
/** ORB normally calls this method after receiving the forwarding message.

Parameters:
info - the object for accessing and manipulating the request information.
Throws:
SystemException - if it does, the receive_other is not called for the subsequent interceptors, calling receive_exception instead.
ForwardRequest - has the effect of changing the redirection that successive interceptors receive on their calls to receive_other.

send_poll

void send_poll(ClientRequestInfo info)
This method is called by if ORB uses the Time- Independent Invocation (TII) polling.

Parameters:
info - the object for accessing and manipulating the request information.
Throws:
SystemException - if it does, the send_poll is not called for the subsequent interceptors, calling receive_exception instead. The completion status of this exception must be COMPLETED_NO.