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

alma::acs::component::client::AdvancedComponentClient Class Reference

Inheritance diagram for alma::acs::component::client::AdvancedComponentClient:

Inheritance graph
[legend]
Collaboration diagram for alma::acs::component::client::AdvancedComponentClient:

Collaboration graph
[legend]
List of all members.

Public Member Functions

 AdvancedComponentClient (Logger logger, String managerLoc, String clientName) throws Exception
 AdvancedComponentClient (Logger logger, String managerLoc, String clientName, AcsCorba externalAcsCorba) throws Exception
ContainerServices createContainerServices (String clientName, Logger csLogger) throws AcsJContainerServicesEx
void destroyContainerServices (ContainerServices cs) throws AcsJContainerServicesEx
AcsCorba getAcsCorba ()
AcsManagerProxy getAcsManagerProxy ()

Private Attributes

Map< ContainerServicesImpl,
AcsManagerProxy
additionalContainerServices = new HashMap<ContainerServicesImpl AcsManagerProxy>()

Detailed Description

Special version of ComponentClient, which gives more power to specialized applications such as the OMC Gui ("Exec"). Using some of these methods can be dangerous to the stability of the entire system.

If you find that your application needs to use AdvancedComponentClient instead of ComponentClient, better check with the ACS team if there really is no other way.

Author:
hsommer


Constructor & Destructor Documentation

alma::acs::component::client::AdvancedComponentClient::AdvancedComponentClient Logger  logger,
String  managerLoc,
String  clientName
throws Exception [inline]
 

alma::acs::component::client::AdvancedComponentClient::AdvancedComponentClient Logger  logger,
String  managerLoc,
String  clientName,
AcsCorba  externalAcsCorba
throws Exception [inline]
 

This ctor's implementation comes already from the base class for practical reasons, but there it is not public. Only here it becomes available to client applications.


Member Function Documentation

ContainerServices alma::acs::component::client::AdvancedComponentClient::createContainerServices String  clientName,
Logger  csLogger
throws AcsJContainerServicesEx [inline]
 

Factory method for additional container service instances. This method should only be used by specialized clients such as the OMC GUI which needs independent ContainerServices instances for the plug-ins it runs.

Make sure to call destroyContainerServices(ContainerServices) when done with the new CS.

Parameters:
clientName name for ContainerServices#getName()
csLogger logger to be used internally by the new ContainerServices instance (which is different from the Logger returned in ContainerServices#getLogger()). Since ACS 8.0 it is recommended to supply an AcsLogger instead of a plain JDK Logger because a plain Logger will have to be wrapped inside this method.

void alma::acs::component::client::AdvancedComponentClient::destroyContainerServices ContainerServices  cs  )  throws AcsJContainerServicesEx [inline]
 

"un-factory" method which inverts createContainerServices(String, Logger).

Parameters:
cs ContainerServices instance created by createContainerServices(String, Logger).

AcsCorba alma::acs::component::client::AdvancedComponentClient::getAcsCorba  )  [inline]
 

Gives direct access to the CORBA ORB, POAs etc, encapsulated by the AcsCorba object. Caution: interfering with the ComponentClient's usage of CORBA can have nasty side effects!

AcsManagerProxy alma::acs::component::client::AdvancedComponentClient::getAcsManagerProxy  )  [inline]
 

Gives direct access to the ACS manager, encapsulated by the AcsManagerProxy object. Caution: interfering with ACS's usage of the manager can have nasty side effects in the entire system!


Member Data Documentation

Map<ContainerServicesImpl, AcsManagerProxy> alma::acs::component::client::AdvancedComponentClient::additionalContainerServices = new HashMap<ContainerServicesImpl AcsManagerProxy>() [private]
 


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