org.omg.PortableServer
Class ForwardRequest

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by org.omg.CORBA.UserException
              extended by org.omg.PortableServer.ForwardRequest
All Implemented Interfaces:
Serializable, IDLEntity

public final class ForwardRequest
extends UserException
implements IDLEntity, Serializable

This exception is raised by ServantManager to indicate that the invocation target has moved to another known location. In this case, the client will receive a redirection (LOCATION_FORWARD) message and should resend the request to the new target. The exception contains the object reference, indicating the new location.

The exception can be thrown both by servant locators and servant activators. If the exception is raised anywhere else than in the ServantManager methods, it is handled as an ordinary user excepton.

See Also:
Serialized Form

Field Summary
 Object forward_reference
          The object reference, indicating the new location of the invocation target.
 
Constructor Summary
ForwardRequest()
          Create ForwardRequest with no explaining message and stating the new location is null.
ForwardRequest(Object a_forward_reference)
          Create the ForwardRequest without explaining message and initialising the object reference to the given value.
ForwardRequest(String why, Object a_forward_reference)
          Create the ForwardRequest with explaining message and initialising the object reference to the given value.
 
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
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

forward_reference

public Object forward_reference
The object reference, indicating the new location of the invocation target.

Constructor Detail

ForwardRequest

public ForwardRequest()
Create ForwardRequest with no explaining message and stating the new location is null.


ForwardRequest

public ForwardRequest(String why,
                      Object a_forward_reference)
Create the ForwardRequest with explaining message and initialising the object reference to the given value.

Parameters:
why - a string, explaining, why this exception has been thrown.
a_forward_reference - a value for forward_reference.

ForwardRequest

public ForwardRequest(Object a_forward_reference)
Create the ForwardRequest without explaining message and initialising the object reference to the given value.

Parameters:
a_forward_reference - a value for forward_reference.