Inheritance diagram for alma.acs.commandcenter.meta.MaciSupervisor:

Classes
class	AdministratorImplementation
class	ManagerConnectionExceptionHandler
class	RefreshIfNeeded
Public Member Functions
void	setConnectsAutomatically (boolean b)
synchronized void	start () throws NoPermissionEx, CannotRetrieveManagerException, CorbaTransientException, CorbaNotExistException, UnknownErrorException
synchronized void	stop ()
synchronized void	dismissManager ()
boolean	isConnected ()
int	myMaciHandle () throws NotConnectedToManagerException
String	getManagerLocation ()
MaciInfo	getMaciInfo () throws NoPermissionEx, NotConnectedToManagerException, CorbaTransientException, CorbaNotExistException, UnknownErrorException
MaciInfo	getMaciInformation ()
void	refreshSoon ()
void	setRefreshesPeriodically (boolean b)
void	refreshNow () throws NoPermissionEx, NotConnectedToManagerException, SystemException, CorbaTransientException, CorbaNotExistException, UnknownErrorException
String	toString ()
Protected Member Functions
	MaciSupervisor (String clientName, String managerLoc, ORB orb, Logger log)
Manager	myManagerReference () throws NotConnectedToManagerException
void	connectToManager () throws CannotRetrieveManagerException, NoPermissionEx, SystemException
void	disconnectFromManager ()
ContainerInfo[]	retrieveContainerInfo (String name_wildcard) throws NotConnectedToManagerException, NoPermissionEx, SystemException
ClientInfo[]	retrieveClientInfo (String name_wildcard) throws NotConnectedToManagerException, NoPermissionEx, SystemException
ComponentInfo[]	retrieveComponentInfo (String name_wildcard) throws NotConnectedToManagerException, NoPermissionEx, SystemException
SortingTreeNode	createNode (Object info)
SortingTreeNode	createNode (Object info, boolean allowInfoDetails)
String	extractLocation (org.omg.CORBA.Object reference)
Protected Attributes
String	name = null
String	managerLoc = null
ORB	orb = null
Logger	log = null
boolean	connectsAutomatically = true
ManagerConnectionExceptionHandler	mcehandler
final MaciInfo	maciInfo
volatile boolean	refreshWithoutACause
volatile int	refreshCountdown
RefreshIfNeeded	refreshTask
Timer	timer = new Timer("MaciSupervisor.Refresher", true)
Manager	managerRef = null
volatile boolean	infoShouldBeRefreshed
ClientInfo	administratorClientInfo = null
AdministratorImplementation	acImpl

Detailed Description

Author:: mschilli

Constructor & Destructor Documentation

alma.acs.commandcenter.meta.MaciSupervisor.MaciSupervisor	(	String	clientName,
		String	managerLoc,
		ORB	orb,
		Logger	log
	)			`[protected]`

Creates a MaciSupervisor running on the given ORB, it will connect to the specified manager.

Parameters:

	clientName	name-prefix like "AcsCommandCenter" or "OMC"
	managerLoc	the manager corbaloc
	orb	the orb to use

References alma.acs.commandcenter.meta.MaciSupervisor.acImpl, alma.acs.commandcenter.meta.MaciSupervisor.createNode(), alma.acs.commandcenter.meta.MaciSupervisor.maciInfo, and alma.acs.commandcenter.meta.MaciSupervisor.name.

Member Function Documentation

void alma.acs.commandcenter.meta.MaciSupervisor.connectToManager ( ) throws CannotRetrieveManagerException, NoPermissionEx, SystemException [protected]

References alma.acs.commandcenter.meta.MaciSupervisor.acImpl, alma.acs.commandcenter.meta.MaciSupervisor.administratorClientInfo, alma.acs.commandcenter.meta.MaciSupervisor.getManagerLocation(), alma.acs.commandcenter.meta.MaciSupervisor.log, alma.acs.commandcenter.meta.MaciSupervisor.managerLoc, alma.acs.commandcenter.meta.MaciSupervisor.managerRef, and alma.acs.commandcenter.meta.MaciSupervisor.orb.

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.start().

SortingTreeNode alma.acs.commandcenter.meta.MaciSupervisor.createNode ( Object info ) [protected]

Factory method

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.createNode(), alma.acs.commandcenter.meta.MaciSupervisor.MaciSupervisor(), and alma.acs.commandcenter.meta.MaciSupervisor.refreshNow().

SortingTreeNode alma.acs.commandcenter.meta.MaciSupervisor.createNode	(	Object	info,
		boolean	allowInfoDetails
	)			`[protected]`

Factory method, the boolean parameter supresses auto-generated sub-nodes

References alma.acs.commandcenter.meta.MaciSupervisor.createNode(), and alma.acs.commandcenter.meta.MaciSupervisor.extractLocation().

void alma.acs.commandcenter.meta.MaciSupervisor.disconnectFromManager ( ) [protected]

References alma.acs.commandcenter.meta.MaciSupervisor.dismissManager(), alma.acs.commandcenter.meta.MaciSupervisor.log, alma.acs.commandcenter.meta.MaciSupervisor.myMaciHandle(), and alma.acs.commandcenter.meta.MaciSupervisor.myManagerReference().

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.AdministratorImplementation.disconnect(), and alma.acs.commandcenter.meta.MaciSupervisor.stop().

synchronized void alma.acs.commandcenter.meta.MaciSupervisor.dismissManager ( )

msc (2004-11-09): This was requested, suggested, and agreed upon as a workaround for the situation where a manager has gone down (and the application using this macisupervisor knows that the manager is down, e.g. because it made it go down) while this macisupervisor does not yet know that the manager is down. It will only realize that the next time it tries to access it. Doing so will provoke some no_permission error messages in the manager log. To enable the application to avoid these error messages this API method was added.

Implements alma.acs.commandcenter.meta.IMaciSupervisor.

References alma.acs.commandcenter.meta.MaciSupervisor.administratorClientInfo.

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.disconnectFromManager(), and alma.acs.commandcenter.gui.DeploymentTree.removeManager().

String alma.acs.commandcenter.meta.MaciSupervisor.extractLocation ( org.omg.CORBA.Object reference ) [protected]

Helper for createNode()

Returns:: {host, port}, or null on failure

References alma.acs.commandcenter.meta.MaciSupervisor.orb.

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.createNode().

MaciInfo alma.acs.commandcenter.meta.MaciSupervisor.getMaciInfo ( ) throws NoPermissionEx, NotConnectedToManagerException, CorbaTransientException, CorbaNotExistException, UnknownErrorException

Returns a TreeModel compiled from information from the Acs manager. The returned model will never become invalid during the lifetime of this MaciSupervisor, and it will be automatically updated.

A call to this method will automatically trigger a refresh, possibly throwing an exception or blocking the current thread for a long time. Calling getMaciInformation() and refreshSoon() will shield you from these effects.

Returns:: a stable maciInfo instance, never null

Exceptions:

	NotConnectedToManagerException
	NoPermissionEx
	UnknownErrorException
	CorbaNotExistException
	CorbaTransientException

Implements alma.acs.commandcenter.meta.IMaciSupervisor.

References alma.acs.commandcenter.meta.MaciSupervisor.maciInfo, and alma.acs.commandcenter.meta.MaciSupervisor.refreshNow().

Referenced by alma.acs.commandcenter.gui.DeploymentTree.shieldedRefreshManager().

MaciInfo alma.acs.commandcenter.meta.MaciSupervisor.getMaciInformation ( )

Returns a TreeModel compiled from information from the Acs manager. The returned model will never become invalid during the lifetime of this MaciSupervisor, and it will be automatically updated.

The returned model may be out-of-date. Call refreshSoon() to have it updated.

Returns:: a stable maciInfo instance, never null

References alma.acs.commandcenter.meta.MaciSupervisor.maciInfo.

String alma.acs.commandcenter.meta.MaciSupervisor.getManagerLocation ( )

Some people are interested in the weirdest things..

Implements alma.acs.commandcenter.meta.IMaciSupervisor.

References alma.acs.commandcenter.meta.MaciSupervisor.managerLoc.

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.connectToManager(), alma.acs.commandcenter.gui.DeploymentTree.getManagerNode(), alma.acs.commandcenter.meta.GuiMaciSupervisor.managerPing(), and alma.acs.commandcenter.meta.GuiMaciSupervisor.managerShutdown().

boolean alma.acs.commandcenter.meta.MaciSupervisor.isConnected ( )

Whether this is connected

Implements alma.acs.commandcenter.meta.IMaciSupervisor.

References alma.acs.commandcenter.meta.MaciSupervisor.administratorClientInfo.

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.RefreshIfNeeded.run(), and alma.acs.commandcenter.meta.MaciSupervisor.start().

int alma.acs.commandcenter.meta.MaciSupervisor.myMaciHandle ( ) throws NotConnectedToManagerException

Exceptions:

NotConnectedToManagerException

Implements alma.acs.commandcenter.meta.IMaciSupervisor.

References alma.acs.commandcenter.meta.MaciSupervisor.administratorClientInfo.

Manager alma.acs.commandcenter.meta.MaciSupervisor.myManagerReference ( ) throws NotConnectedToManagerException [protected]

Exceptions:

NotConnectedToManagerException

References alma.acs.commandcenter.meta.MaciSupervisor.managerRef.

void alma.acs.commandcenter.meta.MaciSupervisor.refreshNow ( ) throws NoPermissionEx, NotConnectedToManagerException, SystemException, CorbaTransientException, CorbaNotExistException, UnknownErrorException

Tries to refresh the component-section, container-section, and client-section of the info tree model. The treemodel will be updated when things go well and also when things fail.

A call to this method will instantly perform a refresh, possibly throwing an exception or blocking the current thread for a long time. Calling getMaciInformation() and refreshSoon() will shield you from these effects.

Exceptions:

	NoPermissionEx	error during refresh
	NotConnectedToManagerException	error during refresh
	CorbaTransientException
	CorbaNotExistException
	UnknownErrorException

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.getMaciInfo(), and alma.acs.commandcenter.meta.MaciSupervisor.RefreshIfNeeded.run().

void alma.acs.commandcenter.meta.MaciSupervisor.refreshSoon ( )

Request the MaciInfo be refreshed in the background.

References alma.acs.commandcenter.meta.MaciSupervisor.infoShouldBeRefreshed.

ClientInfo [] alma.acs.commandcenter.meta.MaciSupervisor.retrieveClientInfo ( String name_wildcard ) throws NotConnectedToManagerException, NoPermissionEx, SystemException [protected]

Exceptions:

	NoPermissionEx
	NotConnectedToManagerException
	SystemException

References alma.acs.commandcenter.meta.MaciSupervisor.myMaciHandle(), and alma.acs.commandcenter.meta.MaciSupervisor.myManagerReference().

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.refreshNow().

ComponentInfo [] alma.acs.commandcenter.meta.MaciSupervisor.retrieveComponentInfo ( String name_wildcard ) throws NotConnectedToManagerException, NoPermissionEx, SystemException [protected]

Exceptions:

	NoPermissionEx
	NotConnectedToManagerException
	SystemException

References alma.acs.commandcenter.meta.MaciSupervisor.myMaciHandle(), and alma.acs.commandcenter.meta.MaciSupervisor.myManagerReference().

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.refreshNow().

ContainerInfo [] alma.acs.commandcenter.meta.MaciSupervisor.retrieveContainerInfo ( String name_wildcard ) throws NotConnectedToManagerException, NoPermissionEx, SystemException [protected]

The containerHandles argument cannot be specified here. Reason: There's apparently a bug in Manager.get_activator_info() in ACS2.x (nothing known about ACS3.x): The containerHandles argument is not evaluated properly, instead empty (therefore useless) ContainerInfos are returned.

Parameters:

name_wildcard

not verified to work as expected, recommended to use '*'.

Returns:

Exceptions:

	NoPermissionEx
	NotConnectedToManagerException
	SystemException

References alma.acs.commandcenter.meta.MaciSupervisor.myMaciHandle(), and alma.acs.commandcenter.meta.MaciSupervisor.myManagerReference().

Referenced by alma.acs.commandcenter.meta.MaciSupervisor.refreshNow().

void alma.acs.commandcenter.meta.MaciSupervisor.setConnectsAutomatically ( boolean b )

References alma.acs.commandcenter.meta.MaciSupervisor.connectsAutomatically.

Referenced by alma.acs.commandcenter.gui.DeploymentTree.getMaciSupervisor().

void alma.acs.commandcenter.meta.MaciSupervisor.setRefreshesPeriodically ( boolean b )

Refresh every once in a while, even if there wasn't any indication from the manager that something has changed.

References alma.acs.commandcenter.meta.MaciSupervisor.refreshCountdown, and alma.acs.commandcenter.meta.MaciSupervisor.refreshWithoutACause.

Referenced by alma.acs.commandcenter.app.CommandCenterLogic.DeploymentTreeControllerImpl.giveMaciSupervisor().

synchronized void alma.acs.commandcenter.meta.MaciSupervisor.start ( ) throws NoPermissionEx, CannotRetrieveManagerException, CorbaTransientException, CorbaNotExistException, UnknownErrorException

This start implementation is smart, it can be called repeatedly.

Exceptions: