org.omg.PortableServer: public class:

org.omg.PortableServer
public class: _ServantLocatorStub [javadoc | source]

java.lang.Object
   org.omg.CORBA.portable.ObjectImpl
      org.omg.PortableServer._ServantLocatorStub

All Implemented Interfaces:
Serializable, ServantLocator, Object

The ServantLocator stub is an optional base for the servant locators. This stub cannot accept remote invocations, as methods in ServantLocatorOperations take POA as one of parameters. Both JDK 1.5 API and OMG specifies that POA is a local object that must not be transferred to the remote invocation target.

You do not need to derive your servant locator from this stub, it is enough to implement the ServantLocator interface. But you may choose to do this if you need its functional #_ids() method or want to keep default behavior during per- or post- invokcations.

author: Audrius - Meskauskas, Lithuania (AudriusA@Bioinformatics.org)

Field Summary
public static final Class	_opsClass	This the purpose of this field is undocumented up till 1.5 java API inclusive.
static final String	OVERRIDE	The package private string, used as a parameter for the throws NullPointerExceptions in both servant locator and activator stubs.

Method from org.omg.PortableServer._ServantLocatorStub Summary:
_ids, postinvoke, preinvoke

Methods from org.omg.CORBA.portable.ObjectImpl:
_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _ids, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.omg.PortableServer._ServantLocatorStub Detail:
public String[] _ids() { return new String[] { "IDL:omg.org/PortableServer/ServantLocator:1.0", "IDL:omg.org/PortableServer/ServantManager:1.0" }; } Return the array of repository ids for this object, stating that it is both Servant locator and Servant manager.
public void postinvoke(byte[] Object_id, POA poa, String method, Object cookie, Servant servant) { } It is your responsibility to take the postinvoke actions, if any, by overriding this method. The default method does nothing.
public Servant preinvoke(byte[] Object_id, POA poa, String method, CookieHolder cookie) throws ForwardRequest { return null; } It is your responsibility to take the preinvoke actions, if any, and also supply an appropriate servant for the current invocation. The default method instructs POA that the servant cannot be provided by locator. The OBJ_ADAPTER exception will be thrown by POA, unless it uses the available default servant for all invocations.

Method from org.omg.PortableServer._ServantLocatorStub Detail:

 public String[] _ids() {
                                        
    return new String[]
           {
             "IDL:omg.org/PortableServer/ServantLocator:1.0",
             "IDL:omg.org/PortableServer/ServantManager:1.0"
           };
}

Return the array of repository ids for this object, stating that it is both Servant locator and Servant manager.

 public  void postinvoke(byte[] Object_id,
    POA poa,
    String method,
    Object cookie,
    Servant servant) {

}

It is your responsibility to take the postinvoke actions, if any, by overriding this method. The default method does nothing.

 public Servant preinvoke(byte[] Object_id,
    POA poa,
    String method,
    CookieHolder cookie) throws ForwardRequest {
    return null;
}

It is your responsibility to take the preinvoke actions, if any, and also supply an appropriate servant for the current invocation. The default method instructs POA that the servant cannot be provided by locator. The OBJ_ADAPTER exception will be thrown by POA, unless it uses the available default servant for all invocations.