alma.acs.container

Class AdvancedContainerServicesImpl

java.lang.Object

alma.acs.container.AdvancedContainerServicesImpl

All Implemented Interfaces:

AdvancedContainerServices

public class AdvancedContainerServicesImpl
extends java.lang.Object
implements AdvancedContainerServices

This class implements the more exotic methods from the container services interface, which have been refactored out of ContainerServices into a separate interface.

Author:

hsommer

See Also:

ContainerServicesImpl

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<AdministratorOperations,AcsManagerProxy>	adminClientsToManagerProxy
protected ContainerServicesImpl	containerServicesImpl
protected java.util.logging.Logger	logger

Method Summary

Modifier and Type	Method and Description
void	connectManagerAdmin(AdministratorOperations adminOp, boolean retryConnectOnFailure) Allows to connect a manager admin object to the manager, to receive notifications etc.
org.omg.CORBA.Object	corbaObjectFromString(java.lang.String strObjRef) Encapsulates ORB.string_to_object(String).
java.lang.String	corbaObjectToString(org.omg.CORBA.Object objRef) Encapsulates ORB.object_to_string(org.omg.CORBA.Object).
void	disconnectManagerAdmin(AdministratorOperations adminOp) Releases a previously connected manager admin object.
org.omg.CORBA.Any	getAny() Returns a reference to a new CORBA Any.
org.omg.CORBA.ORB	getORB() Provides explicit access to the normally invisible ORB, for components that fulfill infrastructural tasks.

Methods inherited from class java.lang.Object

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

Field Detail

containerServicesImpl

protected ContainerServicesImpl containerServicesImpl

logger

protected java.util.logging.Logger logger

adminClientsToManagerProxy

protected final java.util.Map<AdministratorOperations,AcsManagerProxy> adminClientsToManagerProxy

Method Detail

corbaObjectToString

public java.lang.String corbaObjectToString(org.omg.CORBA.Object objRef)

Description copied from interface: AdvancedContainerServices

Encapsulates ORB.object_to_string(org.omg.CORBA.Object).

Specified by:

corbaObjectToString in interface AdvancedContainerServices

Parameters:

objRef - the corba stub

Returns:

standardized string representation of objRef.

corbaObjectFromString

public org.omg.CORBA.Object corbaObjectFromString(java.lang.String strObjRef)

Description copied from interface: AdvancedContainerServices

Encapsulates ORB.string_to_object(String).

Specified by:

corbaObjectFromString in interface AdvancedContainerServices

Returns:

org.omg.CORBA.Object

getORB

public org.omg.CORBA.ORB getORB()

Description copied from interface: AdvancedContainerServices

Provides explicit access to the normally invisible ORB, for components that fulfill infrastructural tasks.

Normal subsystem components must not use this method! If they feel they should get access to the ORB, either ACS is missing a feature which should be reported, or there is a misunderstanding in how to develop software for Alma.

Specified by:

getORB in interface AdvancedContainerServices

Returns:

the ORB that connects the container and its components with other processes.

Throws:

java.lang.IllegalStateException - if the ORB reference is null or has not been initialized before.

getAny

public org.omg.CORBA.Any getAny()

Returns a reference to a new CORBA Any. In Java the only way to do this is through the ORB itself (i.e., the create_any method).

Specified by:

getAny in interface AdvancedContainerServices

Returns:

org.omg.CORBA.Any

Throws:

java.lang.NullPointerException - if the Any object could not be created.

connectManagerAdmin

public void connectManagerAdmin(AdministratorOperations adminOp,
                                boolean retryConnectOnFailure)
                         throws AcsJContainerEx

Allows to connect a manager admin object to the manager, to receive notifications etc.

This method accepts and distinguishes AdministratorOperations objects and the subtyped SynchronousAdministratorOperations objects.

TODO: (1) container could implement a single proxy/interceptor admin client so that we only have at most one such login on the manager, even if many components register their admin clients. (2) Discuss if the retryConnectOnFailure flag makes sense, or if such a specialized component that uses this method should implement its own retry strategy and should rather be notified quickly if there are problems.

Specified by:

connectManagerAdmin in interface AdvancedContainerServices

Parameters:

adminOp - admin object for manager callbacks.

retryConnectOnFailure - retry if the manager is not available or the connection failed.

Throws:

AcsJContainerEx

java.lang.IllegalArgumentException - if adminOp == null.

disconnectManagerAdmin

public void disconnectManagerAdmin(AdministratorOperations adminOp)

Description copied from interface: AdvancedContainerServices

Releases a previously connected manager admin object. This call is ignored if the given object is not connected.

Specified by:

disconnectManagerAdmin in interface AdvancedContainerServices