Inheritance diagram for alma.acs.container.AdvancedContainerServices:

Public Member Functions
String	corbaObjectToString (org.omg.CORBA.Object objRef)
org.omg.CORBA.Object	corbaObjectFromString (String strObjRef)
ORB	getORB ()
org.omg.CORBA.Any	getAny ()
void	connectManagerAdmin (AdministratorOperations adminOp, boolean retryConnectOnFailure) throws AcsJContainerEx
void	disconnectManagerAdmin (AdministratorOperations adminOp)

Detailed Description

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

to keep the standard ContainerServices interface lean,
to discourage using these methods when not really needed, because they may violate architectural principles,
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

Member Function Documentation

void alma.acs.container.AdvancedContainerServices.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.

Exceptions:

AcsJContainerEx

Since:: ACS 7.0

Implemented in alma.alarmsystem.corbaservice.AlarmSystemAdvancedContainerServices, alma.acs.container.AdvancedContainerServicesImpl, and com.cosylab.acs.maci.manager.app.ManagerContainerServices.

org.omg.CORBA.Object alma.acs.container.AdvancedContainerServices.corbaObjectFromString ( String strObjRef )

Encapsulates org.omg.CORBA.ORB#string_to_object(String).

Parameters:

strObjRef

Returns:: org.omg.CORBA.Object

Implemented in alma.alarmsystem.corbaservice.AlarmSystemAdvancedContainerServices, alma.acs.container.AdvancedContainerServicesImpl, and com.cosylab.acs.maci.manager.app.ManagerContainerServices.

String alma.acs.container.AdvancedContainerServices.corbaObjectToString ( org.omg.CORBA.Object objRef )

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

Parameters:

objRef

the corba stub

Returns:: standardized string representation of objRef.

Implemented in alma.alarmsystem.corbaservice.AlarmSystemAdvancedContainerServices, alma.acs.container.AdvancedContainerServicesImpl, and com.cosylab.acs.maci.manager.app.ManagerContainerServices.

void alma.acs.container.AdvancedContainerServices.disconnectManagerAdmin ( AdministratorOperations adminOp )

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

Parameters:

componentUrl

Implemented in alma.alarmsystem.corbaservice.AlarmSystemAdvancedContainerServices, alma.acs.container.AdvancedContainerServicesImpl, and com.cosylab.acs.maci.manager.app.ManagerContainerServices.

org.omg.CORBA.Any alma.acs.container.AdvancedContainerServices.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 alma.acs.nc.AnyAide.

Returns:: org.omg.CORBA.Any

Implemented in alma.alarmsystem.corbaservice.AlarmSystemAdvancedContainerServices, alma.acs.container.AdvancedContainerServicesImpl, and com.cosylab.acs.maci.manager.app.ManagerContainerServices.

ORB alma.acs.container.AdvancedContainerServices.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.

Implemented in alma.alarmsystem.corbaservice.AlarmSystemAdvancedContainerServices, alma.acs.container.AdvancedContainerServicesImpl, and com.cosylab.acs.maci.manager.app.ManagerContainerServices.

Referenced by alma.alarmsystem.corbaservice.CernAlarmServiceUtils.CernAlarmServiceUtils(), and com.cosylab.logging.LoggingClient.connect().

The documentation for this interface was generated from the following file:

AdvancedContainerServices.java

All Classes Namespaces Files Functions Variables Enumerations Properties

alma.acs.container.AdvancedContainerServices Interface Reference

Public Member Functions

Detailed Description

Member Function Documentation