alma.acs.container

Interface AdvancedContainerServices

All Known Implementing Classes:

AdvancedContainerServicesImpl, AlarmSystemAdvancedContainerServices, ManagerContainerServices

public interface AdvancedContainerServices

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

The idea is

1. to keep the standard ContainerServices interface lean,
2. to discourage using these methods when not really needed, because they may violate architectural principles,
3. perhaps later to require a flag in the CDB for a component to be allowed to access these methods.

Author:

hsommer created May 2, 2005 5:46:23 PM

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.

Method Detail

corbaObjectToString

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

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

Parameters:

objRef - the corba stub

Returns:

standardized string representation of objRef.

corbaObjectFromString

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

Encapsulates ORB.string_to_object(String).

Parameters:

strObjRef -

Returns:

org.omg.CORBA.Object

getORB

org.omg.CORBA.ORB getORB()

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.

Returns:

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

getAny

org.omg.CORBA.Any getAny()

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

The notification channel module provides a convenience class for dealing with CORBA Anys, see AnyAide.

Returns:

org.omg.CORBA.Any

connectManagerAdmin

void connectManagerAdmin(AdministratorOperations adminOp,
                         boolean retryConnectOnFailure)
                  throws AcsJContainerEx

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

In the current implementation every call to this method establishes a new connection to the manager. Should a client ever need to call this method more than once, it must also call #disconnectManagerAdmin(String) for each of its admin objects.

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

Parameters:

adminOp - callback object

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

Throws:

AcsJContainerEx

Since:

ACS 7.0

disconnectManagerAdmin

void disconnectManagerAdmin(AdministratorOperations adminOp)

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

Parameters:

componentUrl -