org.omg.PortableInterceptor
Class ForwardRequest

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          org.omg.CORBA.UserException
              org.omg.PortableInterceptor.ForwardRequest

All Implemented Interfaces:

java.io.Serializable, IDLEntity

public final class ForwardRequest
extends UserException

The ForwardRequest exception is the means by which an interceptor can indicate to the ORB that a retry of the request should occur with the new object given in the exception. This behavior of causing a retry only occurs if the ORB receives a ForwardRequest from an interceptor. If ForwardRequest is raised anywhere else it is passed through the ORB as is normal for a user exception.

If an interceptor raises a ForwardRequest exception in response to a call of an interceptor, no other interceptors are called for that interception point. The remaining interceptors in the flow stack will have their appropriate ending interception point called: receive_other on the client, or send_other() on the server. The reply_status() in the receive_other() or send_other() will return LOCATION_FORWARD.

See Also:

Serialized Form

Field Summary

Object

forward

Constructor Summary

ForwardRequest()

ForwardRequest(Object forward)

ForwardRequest(java.lang.String _reason, Object forward)

Method Summary

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

forward

public Object forward

Constructor Detail

ForwardRequest

public ForwardRequest()

ForwardRequest

public ForwardRequest(Object forward)

ForwardRequest

public ForwardRequest(java.lang.String _reason,
                      Object forward)