org.omg.PortableServer
Interface AdapterActivatorOperations

All Known Subinterfaces:

AdapterActivator

public interface AdapterActivatorOperations

     Adapter activators are associated with POAs. An adapter activator
     supplies a POA with the ability to create child POAs on demand, as
     a side-effect of receiving a request that names the child POA (or
     one of its children), or when find_POA is called with an activate
     parameter value of TRUE.
     

     An application server that creates all
     its needed POAs at the beginning of execution does not need to use
     or provide an adapter activator; it is necessary only for the case
     in which POAs need to be created during request processing.  While
     a request from the POA to an adapter activator is in progress, all
     requests to objects managed by the new POA (or any descendant
     POAs) will be queued. This serialization allows the adapter
     activator to complete any initialization of the new POA before
     requests are delivered to that POA.
     

Method Summary

boolean

unknown_adapter(POA parent, java.lang.String name) This operation is invoked when the ORB receives a request for an object reference that identifies a target POA that does not exist.

Method Detail

unknown_adapter

boolean unknown_adapter(POA parent,
                        java.lang.String name)

This operation is invoked when the ORB receives a request for an object reference that identifies a target POA that does not exist. The ORB invokes this operation once for each POA that must be created in order for the target POA to exist (starting with ancestor POA closest to the root POA). The operation is invoked on the adapter activator associated with the POA that is the parent of the POA that needs to be created. That parent POA is passed as the parent parameter. The name of the POA to be created (relative to the parent) is passed as the name parameter. The implementation of this operation should either create the specified POA and return TRUE, or it should return FALSE. If the operation returns TRUE, the ORB will proceed with processing the request. If the operation returns FALSE, the ORB will return OBJECT_NOT_EXIST to the client. If multiple POAs need to be created, the ORB will invoke unknown_adapter once for each POA that needs to be created. If the parent of a nonexistent POA does not have an associated adapter activator, the ORB will return the OBJECT_NOT_EXIST exception. If unknown_adapter raises a system exception, the ORB will report an OBJ_ADAPTER exception.

       Note: It is possible for another
       thread to create the same POA the AdapterActivator is being
       asked to create if AdapterActivators are used in conjunction
       with other threads calling create_POA with the same POA name.
       Applications should be prepared to deal with failures from
       either the manual or automatic (AdapterActivator) POA creation
       request. There can be no guarantee of the order of such calls.
       

Parameters:

parent - The parent POA.

name - The name of the POA to be created.