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.
Modifier and Type | Field and Description |
---|---|
Object |
forward_reference
The object reference, indicating the new location of the invocation target.
|
Constructor and Description |
---|
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.
|
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
public Object forward_reference
public ForwardRequest()
null
.public ForwardRequest(String why, Object a_forward_reference)
why
- a string, explaining, why this exception has been thrown.a_forward_reference
- a value for forward_reference.public ForwardRequest(Object a_forward_reference)
a_forward_reference
- a value for forward_reference.