com.sun.corba.se.spi.PortableActivationIDL

Class ServerManagerPOATie

java.lang.Object

org.omg.PortableServer.Servant

com.sun.corba.se.spi.PortableActivationIDL.ServerManagerPOA

com.sun.corba.se.spi.PortableActivationIDL.ServerManagerPOATie

All Implemented Interfaces:

ActivatorOperations, LocatorOperations, ServerManagerOperations, InvokeHandler

public class ServerManagerPOATie
extends ServerManagerPOA

Interface used to combine the Activator and Locator when both are implemented together in the same process, as is currently the case for our implementation.

Constructor Summary

Constructors

Constructor and Description
ServerManagerPOATie(ServerManagerOperations delegate)
ServerManagerPOATie(ServerManagerOperations delegate, POA poa)

Method Summary

Modifier and Type	Method and Description
POA	_default_POA() Returns the root POA from the ORB instance associated with the servant.
ServerManagerOperations	_delegate()
void	_delegate(ServerManagerOperations delegate)
void	activate(String serverId) If the server is not running, start it up.
String[]	getActiveServers() list active servers
int	getEndpoint(String endPointType) get the port for the endpoint of the locator
String[]	getORBNames(String serverId) list all registered ORBs for a server
int	getServerPortForType(ServerLocationPerORB location, String endPointType) Useful from external BadServerIdHandlers which need to pick a particular port type.
void	install(String serverId) Invoke the server install hook.
ServerLocationPerType	locateServer(String serverId, String endPoint) locate server - returns the port with a specific type for all registered ORBs of an active server.
ServerLocationPerORB	locateServerForORB(String serverId, String orbId) locate server - returns all ports registered with a specified ORB for an active server Starts the server if it is not already running.
ObjectReferenceTemplate	lookupPOATemplate(String serverId, String orbId, String[] orbAdapterName) Find the server template that corresponds to the ORBD's adapter id.
void	poaDestroyed(String serverId, String orbId, ObjectReferenceTemplate poaTemplate) Called whenever a POA is destroyed.
void	registerORB(String serverId, String orbId, ORBProxy orb, EndPointInfo[] endPointInfo) Called whenever an ORB instance is created.
ObjectReferenceTemplate	registerPOA(String serverId, String orbId, ObjectReferenceTemplate poaTemplate) Construct or find an ORBD object template corresponding to the server's object template and return it.
void	registerServer(String serverId, ServerProxy serverObj) A new ORB started server registers itself with the Activator
void	serverGoingDown(String serverId) A server is shutting down that was started by this activator.
void	shutdown(String serverId) If the server is running, shut it down
void	uninstall(String serverId) Invoke the server uninstall hook.

Methods inherited from class com.sun.corba.se.spi.PortableActivationIDL.ServerManagerPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerManagerPOATie

public ServerManagerPOATie(ServerManagerOperations delegate)

ServerManagerPOATie

public ServerManagerPOATie(ServerManagerOperations delegate,
                           POA poa)

Method Detail

_delegate

public ServerManagerOperations _delegate()

_delegate

public void _delegate(ServerManagerOperations delegate)

_default_POA

public POA _default_POA()

Description copied from class: Servant

Returns the root POA from the ORB instance associated with the servant. Subclasses may override this method to return a different POA.

Overrides:

_default_POA in class Servant

Returns:

default_POA the POA associated with the Servant.

registerServer

public void registerServer(String serverId,
                           ServerProxy serverObj)
                    throws ServerNotRegistered

A new ORB started server registers itself with the Activator

Throws:

ServerNotRegistered

serverGoingDown

public void serverGoingDown(String serverId)

A server is shutting down that was started by this activator. Complete termination of the server is detected by the death of the process implementing the server.

registerORB

public void registerORB(String serverId,
                        String orbId,
                        ORBProxy orb,
                        EndPointInfo[] endPointInfo)
                 throws ServerNotRegistered,
                        NoSuchEndPoint,
                        ORBAlreadyRegistered

Called whenever an ORB instance is created. This registers the transport endpoints and the ORB proxy callback object. Note that we cannot detect when an ORB shuts down, although all of the POA shutdowns should still be reported.

Throws:

ServerNotRegistered

NoSuchEndPoint

ORBAlreadyRegistered

registerPOA

public ObjectReferenceTemplate registerPOA(String serverId,
                                           String orbId,
                                           ObjectReferenceTemplate poaTemplate)

Construct or find an ORBD object template corresponding to the server's object template and return it. Called whenever a persistent POA is created.

poaDestroyed

public void poaDestroyed(String serverId,
                         String orbId,
                         ObjectReferenceTemplate poaTemplate)

Called whenever a POA is destroyed.

activate

public void activate(String serverId)
              throws ServerAlreadyActive,
                     ServerNotRegistered,
                     ServerHeldDown

If the server is not running, start it up. This is allowed whether or not the server has been installed.

Throws:

ServerAlreadyActive

ServerNotRegistered

ServerHeldDown

shutdown

public void shutdown(String serverId)
              throws ServerNotActive,
                     ServerNotRegistered

If the server is running, shut it down

Throws:

ServerNotActive

ServerNotRegistered

install

public void install(String serverId)
             throws ServerNotRegistered,
                    ServerHeldDown,
                    ServerAlreadyInstalled

Invoke the server install hook. If the server is not currently running, this method will activate it.

Throws:

ServerNotRegistered

ServerHeldDown

ServerAlreadyInstalled

uninstall

public void uninstall(String serverId)
               throws ServerNotRegistered,
                      ServerHeldDown,
                      ServerAlreadyUninstalled

Invoke the server uninstall hook. If the server is not currently running, this method will activate it. After this hook completes, the server may still be running.

Throws:

ServerNotRegistered

ServerHeldDown

ServerAlreadyUninstalled

getActiveServers

public String[] getActiveServers()

list active servers

getORBNames

public String[] getORBNames(String serverId)
                     throws ServerNotRegistered

list all registered ORBs for a server

Throws:

ServerNotRegistered

lookupPOATemplate

public ObjectReferenceTemplate lookupPOATemplate(String serverId,
                                                 String orbId,
                                                 String[] orbAdapterName)

Find the server template that corresponds to the ORBD's adapter id.

locateServer

public ServerLocationPerType locateServer(String serverId,
                                          String endPoint)
                                   throws NoSuchEndPoint,
                                          ServerNotRegistered,
                                          ServerHeldDown

locate server - returns the port with a specific type for all registered ORBs of an active server. Starts the server if it is not already running.

Throws:

NoSuchEndPoint

ServerNotRegistered

ServerHeldDown

locateServerForORB

public ServerLocationPerORB locateServerForORB(String serverId,
                                               String orbId)
                                        throws InvalidORBid,
                                               ServerNotRegistered,
                                               ServerHeldDown

locate server - returns all ports registered with a specified ORB for an active server Starts the server if it is not already running.

Throws:

InvalidORBid

ServerNotRegistered

ServerHeldDown

getEndpoint

public int getEndpoint(String endPointType)
                throws NoSuchEndPoint

get the port for the endpoint of the locator

Throws:

NoSuchEndPoint

getServerPortForType

public int getServerPortForType(ServerLocationPerORB location,
                                String endPointType)
                         throws NoSuchEndPoint

Useful from external BadServerIdHandlers which need to pick a particular port type.

Throws:

NoSuchEndPoint