org.omg.PortableServer
public interface ServantLocatorOperations extends ServantManagerOperations
Method Summary | |
---|---|
void | postinvoke(byte[] Object_Id, POA poa, String operation, Object cookie, Servant servant)
If the POA has the USE_SERVANT_MANAGER and NON_RETAIN policies, it
invokes this method whenever a servant completes a request.
|
Servant | preinvoke(byte[] Object_Id, POA poa, String operation, CookieHolder cookie_holder)
If the POA has the USE_SERVANT_MANAGER and NON_RETAIN policies, it
invokes this method whenever the object being requested that is not
inactive. |
Parameters: Object_Id the id of the object, on which the request was called. poa the POA in those scope the object is active. operation the name of the method or operation that was invoked. cookie the object that has been previously set by preinvoke in
the cookie_holder
parameter. servant the servant, associated with the object.
Parameters: Object_Id the id of the object, on which the request was called. poa the POA in those scope the object is active. operation the name of the method or operation being invoked. cookie_holder the holder where the servant manager can store
an arbitrary java.lang.Object. This object will be later passed as a
cookie
parameter for {@link #postinvoke}, to create tie
between preinvoke and postinvoke. The application should not
suppose that each call of preinvoke is followed by the subsequent
postinvoke for the same invocation; under multi threaded policy these
calls may be intermixed.
Returns: a servant that will serve the incoming request.
Throws: ForwardRequest if the locator decides to forward the request
to another object. The exception contains the object that should
handle this request. This object is usually remote, but can also
be local. As preinvoke
is called on each method
invocation, the thrown exception will forward only this current request.