org.omg.PortableServer
public final class ForwardRequest extends UserException implements IDLEntity, Serializable
This exception is raised by {@link 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.
| 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(String why, Object a_forward_reference)
Create the ForwardRequest with explaining message and
initialising the object reference to the given value.
| |
| ForwardRequest(Object a_forward_reference)
Create the ForwardRequest without explaining
message and initialising the object reference to the given value.
| |
null.Parameters: why a string, explaining, why this exception has been thrown. a_forward_reference a value for forward_reference.
Parameters: a_forward_reference a value for forward_reference.