Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages

alma::acs::container::AdvancedContainerServices Interface Reference

Inheritance diagram for alma::acs::container::AdvancedContainerServices:

Inheritance graph
[legend]
List of all members.

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

  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


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::acs::container::AdvancedContainerServicesImpl.

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::acs::container::AdvancedContainerServicesImpl.

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::acs::container::AdvancedContainerServicesImpl.

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::acs::container::AdvancedContainerServicesImpl.

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 seealma.acs.nc.AnyAide.@returnorg.omg.CORBA.Any

Implemented in alma::acs::container::AdvancedContainerServicesImpl.

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::acs::container::AdvancedContainerServicesImpl.


The documentation for this interface was generated from the following file:
Generated on Thu Apr 30 02:52:22 2009 for ACS Java API by doxygen 1.3.8