com.sun.corba.se.spi.PortableActivationIDL

Class _ServerManagerStub

java.lang.Object

org.omg.CORBA.portable.ObjectImpl

com.sun.corba.se.spi.PortableActivationIDL._ServerManagerStub

All Implemented Interfaces:

Activator, ActivatorOperations, Locator, LocatorOperations, ServerManager, ServerManagerOperations, Serializable, Object, IDLEntity

public class _ServerManagerStub
extends ObjectImpl
implements ServerManager

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.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
_ServerManagerStub()

Method Summary

Modifier and Type	Method and Description
String[]	_ids() Retrieves a string array containing the repository identifiers supported by this ObjectImpl object.
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 org.omg.CORBA.portable.ObjectImpl

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _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 inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Constructor Detail

_ServerManagerStub

public _ServerManagerStub()

Method Detail

registerServer

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

A new ORB started server registers itself with the Activator

Specified by:

registerServer in interface ActivatorOperations

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.

Specified by:

serverGoingDown in interface ActivatorOperations

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.

Specified by:

registerORB in interface ActivatorOperations

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.

Specified by:

registerPOA in interface ActivatorOperations

poaDestroyed

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

Called whenever a POA is destroyed.

Specified by:

poaDestroyed in interface ActivatorOperations

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.

Specified by:

activate in interface ActivatorOperations

Throws:

ServerAlreadyActive

ServerNotRegistered

ServerHeldDown

shutdown

public void shutdown(String serverId)
              throws ServerNotActive,
                     ServerNotRegistered

If the server is running, shut it down

Specified by:

shutdown in interface ActivatorOperations

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.

Specified by:

install in interface ActivatorOperations

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.

Specified by:

uninstall in interface ActivatorOperations

Throws:

ServerNotRegistered

ServerHeldDown

ServerAlreadyUninstalled

getActiveServers

public String[] getActiveServers()

list active servers

Specified by:

getActiveServers in interface ActivatorOperations

getORBNames

public String[] getORBNames(String serverId)
                     throws ServerNotRegistered

list all registered ORBs for a server

Specified by:

getORBNames in interface ActivatorOperations

Throws:

ServerNotRegistered

lookupPOATemplate

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

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

Specified by:

lookupPOATemplate in interface ActivatorOperations

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.

Specified by:

locateServer in interface LocatorOperations

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.

Specified by:

locateServerForORB in interface LocatorOperations

Throws:

InvalidORBid

ServerNotRegistered

ServerHeldDown

getEndpoint

public int getEndpoint(String endPointType)
                throws NoSuchEndPoint

get the port for the endpoint of the locator

Specified by:

getEndpoint in interface LocatorOperations

Throws:

NoSuchEndPoint

getServerPortForType

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

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

Specified by:

getServerPortForType in interface LocatorOperations

Throws:

NoSuchEndPoint

_ids

public String[] _ids()

Description copied from class: ObjectImpl

Retrieves a string array containing the repository identifiers supported by this ObjectImpl object. For example, for a stub, this method returns information about all the interfaces supported by the stub.

Specified by:

_ids in class ObjectImpl

Returns:

the array of all repository identifiers supported by this ObjectImpl instance