alma::acs::container::AcsEmbeddedContainerRunner Class Reference

Inheritance diagram for alma::acs::container::AcsEmbeddedContainerRunner:

Collaboration diagram for alma::acs::container::AcsEmbeddedContainerRunner:

Public Member Functions
	AcsEmbeddedContainerRunner ()
void	run (AcsCorba acsCorba, String containerName, String managerLoc) throws AcsJContainerEx
Logger	getContainerLogger ()
Protected Member Functions
void	createContainer () throws AcsJContainerEx
void	initManagerProxy () throws AcsJContainerEx
Protected Attributes
Logger	m_logger
AcsCorba	m_acsCorba
AcsContainer	m_container
boolean	isEmbedded
boolean	useRecoveryMode
String	m_containerName
String	m_managerLoc
AcsManagerProxy	m_managerProxy
Package Functions
	AcsEmbeddedContainerRunner (boolean isEmbedded, boolean useRecoveryMode)
void	run (AcsCorba acsCorba) throws AcsJContainerEx
AcsContainer	getContainer ()
AcsManagerProxy	getManagerProxy ()
void	checkReadyToRun (String otherMsg) throws AcsJContainerEx
void	setContainerName (String name)
void	setManagerLoc (String loc)

Detailed Description

Runner for an embedded container, i.e. a container that gets started in the JVM of an ACS-aware application such as the Exec GUI.

See comments for run(AcsCorba, String, String), which is the only method that must be called, with the required external initializations.

Author:: hsommer created Apr 25, 2005 5:55:27 PM

Constructor & Destructor Documentation

alma::acs::container::AcsEmbeddedContainerRunner::AcsEmbeddedContainerRunner ( ) [inline]

Constructor to be used by a separate application which needs to create an embedded container.

alma::acs::container::AcsEmbeddedContainerRunner::AcsEmbeddedContainerRunner	(	boolean	isEmbedded,
		boolean	useRecoveryMode
	)			`[inline, package]`

Parameters:

isEmbedded

false if this runner is not started by a separate application, but merely by some other runner.

Member Function Documentation

void alma::acs::container::AcsEmbeddedContainerRunner::checkReadyToRun ( String otherMsg ) throws AcsJContainerEx [inline, package]

References m_containerName, m_managerLoc, and alma::JavaContainerError::wrappers::AcsJContainerEx::setContextInfo().

Referenced by alma::acs::container::AcsContainerRunner::checkReadyToRun(), and run().

void alma::acs::container::AcsEmbeddedContainerRunner::createContainer ( ) throws AcsJContainerEx [inline, protected]

References isEmbedded, m_acsCorba, m_container, m_containerName, m_logger, m_managerProxy, alma::acs::container::AcsContainer::setRecoveryMode(), and useRecoveryMode.

Referenced by run().

AcsContainer alma::acs::container::AcsEmbeddedContainerRunner::getContainer ( ) [inline, package]

References m_container.

Referenced by alma::acs::container::AcsContainerRunner::run().

Logger alma::acs::container::AcsEmbeddedContainerRunner::getContainerLogger ( ) [inline]

Gets the logger used by the container. If necessary, creates and initializes the logger.

Returns:: container logger

References m_containerName, and m_logger.

Referenced by run(), and alma::acs::container::AcsContainerRunner::run().

AcsManagerProxy alma::acs::container::AcsEmbeddedContainerRunner::getManagerProxy ( ) [inline, package]

References m_managerProxy.

Referenced by alma::acs::container::AcsContainerRunner::run().

void alma::acs::container::AcsEmbeddedContainerRunner::initManagerProxy ( ) throws AcsJContainerEx [inline, protected]

Creates the instance for m_managerProxy and calls getManager on it so that the connection to the manager will be established, without logging in to the manager yet.

Exceptions:

AcsJContainerEx

References alma::acs::container::AcsManagerProxy::getManager(), alma::acs::container::corba::AcsCorba::getORB(), m_acsCorba, m_logger, m_managerLoc, and m_managerProxy.

Referenced by run().

void alma::acs::container::AcsEmbeddedContainerRunner::run ( AcsCorba acsCorba ) throws AcsJContainerEx [inline, package]

References checkReadyToRun(), createContainer(), getContainerLogger(), alma::acs::container::AcsContainer::initialize(), initManagerProxy(), m_acsCorba, m_container, and alma::JavaContainerError::wrappers::AcsJContainerEx::setContextInfo().

void alma::acs::container::AcsEmbeddedContainerRunner::run	(	AcsCorba	acsCorba,
		String	containerName,
		String	managerLoc
	)			throws AcsJContainerEx `[inline]`

Runs this container using the ORB provided in acsCorba and returns w/o blocking on the ORB. It is assumed that acsCorba is initialized, and that the singleton ClientLogManager has been or will be initialized for remote logging outside of this method.

Note on the implementation: the steps involved are grouped as private methods that access the instance variables. The intent was to make the sequence clearer.

Parameters: