com.cosylab.acs.maci.manager

Class ManagerImpl

java.lang.Object

AbstractPrevalentSystem

com.cosylab.acs.maci.manager.ManagerImpl

All Implemented Interfaces:

HandleConstants, Manager, ManagerConstants

public class ManagerImpl
extends AbstractPrevalentSystem
implements Manager, HandleConstants

This class is an implementation of MACI com.cosylab.acs.maci.Manager. It provides the actual internal implementation of the Manager functionality in a way independent from the ACS maci Manager IDL interface.

Author:

Matej Sekoranja (matej.sekoranja@cosylab.com)

See Also:

Manager

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ManagerImpl.WhyUnloadedReason

Nested classes/interfaces inherited from interface com.cosylab.acs.maci.Manager

Manager.LongCompletionCallback

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<Client,java.util.LinkedList<com.cosylab.acs.maci.manager.ManagerImpl.ClientMessageTask>>	clientMessageQueue Queue (per client) for its messages.
protected static int	FAULT_CODE
protected static java.lang.String	FAULT_FAMILY
protected static java.lang.String	FAULT_MEMBER
static java.lang.String	STATE_PERSISTENCE_DEFAULT

Fields inherited from interface com.cosylab.acs.maci.ManagerConstants

RELEASE_IMMEDIATELY, RELEASE_NEVER, RELEASE_TIME_UNDEFINED

Fields inherited from interface com.cosylab.acs.maci.HandleConstants

ADMINISTRATOR_MASK, CLIENT_MASK, COMPONENT_MASK, CONTAINER_MASK, HANDLE_MASK, KEY_MASK, MANAGER_MASK, TYPE_MASK

Constructor Summary

Constructors

Constructor and Description
ManagerImpl()

Method Summary

Modifier and Type	Method and Description
void	alarmCleared(java.lang.String faultMember) Remember that alarms has been cleared.
void	alarmRaised(java.lang.String faultMember) Remember that alarms has been raised.
int	forceReleaseComponent(int id, java.net.URI curl) Forcefully release a component.
protected long	generateExecutionId()
java.util.HashSet	getActiveAlarms()
HandleDataStore	getAdministrators() Returns the administrators.
ClientInfo	getClientInfo(int id) Get client info.
ClientInfo[]	getClientInfo(int id, int[] handles, java.lang.String name_wc) Get all the information that the Manager has about its known clients.
HandleDataStore	getClients() Returns the clients.
ComponentInfo	getCollocatedComponent(int id, ComponentSpec componentSpec, boolean markAsDefault, java.net.URI targetComponentURI) Activation of an co-deployed component.
Component	getComponent(int id, java.net.URI curl, boolean activate, StatusHolder status) Get a component, activating it if necessary.
ComponentInfo	getComponentInfo(int id) Get component info.
ComponentInfo[]	getComponentInfo(int id, int[] handles, java.lang.String name_wc, java.lang.String type_wc, boolean activeOnly) Get all the information that the Manager has about components.
Component	getComponentNonSticky(int id, java.net.URI curl) Get a component, do not activate it and also do not do any reference counting.
HandleDataStore	getComponents() Returns the components.
ContainerInfo[]	getContainerInfo(int id, int[] handles, java.lang.String name_wc) Get all the information that the Manager has about its known containers.
HandleDataStore	getContainers() Returns the containers.
ComponentInfo	getDefaultComponent(int id, java.lang.String type) Get default component of given type.
java.util.Map<java.lang.String,ComponentInfo>	getDefaultComponents() Returns the defaultComponents.
java.lang.String	getDomain() Return the fully qualified name of the domain, e.g., "antenna1.alma.nrao".
ComponentInfo	getDynamicComponent(int id, ComponentSpec componentSpec, boolean markAsDefault) Activation of an dynamic component.
ComponentInfo[]	getDynamicComponents(int id, ComponentSpec[] components)
int	getHandle() Returns the handle of the Manager.
com.cosylab.acs.maci.manager.ManagerImpl.HandleMonitorEntry	getHandleReleaseLog(int handle) Get handle release log.
long	getLockTimeout() Returns lock timeout (deadlock detection time) in ms.
java.lang.Object	getManagerComponentReference() Returns the managerComponentReference.
java.util.Map<java.lang.Integer,com.cosylab.acs.maci.manager.ManagerImpl.HandleMonitorEntry>	getReleasedHandles() Get handle released map.
javax.naming.Context	getRemoteDirectory() Returns the remoteDirectory.
java.lang.Object	getRemoteDirectoryComponentReference() Returns the remoteDirectoryComponentReference.
Component	getService(int id, java.net.URI curl, boolean activate, StatusHolder status) Get a service.
ManagerShutdown	getShutdownImplementation() Returns the shutdownImplementation.
java.util.concurrent.atomic.AtomicBoolean	getStatePersitenceFlag()
java.util.Map	getUnavailableComponents() Returns the unavailableComponents.
boolean	hasActiveAlarm(java.lang.String faultMember) Flag if alarm is active.
void	initializationDone() Called from client code after all manager initialization is done.
void	initialize(Prevayler prevayler, CDBAccess cdbAccess, javax.naming.Context context, java.util.logging.Logger logger, ManagerContainerServices managerContainerServices) Initializes Manager.
void	initializeFederation(java.util.Hashtable federationDirectoryProperties) Initialize manager federation.
boolean	isServiceComponent(java.lang.String name) Checks if component name is a service component name, list of names is defined in the CDB.
boolean	isShuttingDown() Return shutdown status of the Manager.
void	logHandleCleanup(long maxAgeMs) Log handle cleanup (removes logs older than maxAgeMs).
void	logHandleRelease(int handle, ManagerImpl.WhyUnloadedReason reason) Log handle release.
ClientInfo	login(Client reference) Login to MACI.
void	logout(int id) Logout from MACI.
void	logout(int id, boolean pingFailed) Logout client.
void	makeComponentImmortal(int id, java.net.URI curl, boolean immortalState) Change mortality state of an component.
ClientInfo	noSyncGetClientInfo(int id) Get client info.
int	registerComponent(int id, java.net.URI curl, java.lang.String type, Component component) Register a CORBA object as a component, assigning it a CURL and making it accessible through the Manager.
protected void	registerGroupedNotifyTaks(java.lang.Object key, com.cosylab.acs.maci.manager.ManagerImpl.GroupedRunnable runnable)
int	releaseComponent(int id, java.net.URI curl) Release a component.
void	releaseComponentAsync(int id, java.net.URI curl, Manager.LongCompletionCallback callback)
void	releaseComponents(int id, java.net.URI[] curls)
void	reportPrevaylerState(boolean raise, java.lang.Throwable alarmEx) Convenience method for send_alarm with given state.
Component	restartComponent(int id, java.net.URI curl) Restart a component.
void	setCDBAccess(CDBAccess cdbAccess) Sets CDB access.
void	setConnectionThreadUsage(int percentage) Allows setting the current percentage of used connection threads, which would typically be updated by an ORB profiler.
void	setDomain(java.lang.String domain) Set name of the domain, which this manager will handle.
void	setLockTimeout(long l) Sets lock timeout (deadlock detection time) in ms.
void	setManagerComponentReference(java.lang.Object managerComponentReference) Sets the managerComponentReference.
void	setRemoteDirectory(javax.naming.Context remoteDirectory) Sets the remoteDirectory.
void	setRemoteDirectoryComponentReference(java.lang.Object remoteDirectoryComponentReference) Sets the remoteDirectoryComponentReference.
void	setShutdownImplementation(ManagerShutdown shutdownImplementation) Sets the shutdownImplementation.
void	setStatePersistence(int id, boolean enable) Enable/disable state persistence subsystem.
void	setTransport(Transport transport) Set the transport.
void	shutdown(int id, int containers) Shutdown the Manager.
void	shutdownContainer(int id, java.lang.String containerName, int action) Shutdown a container.
java.lang.String	toString() Returns a single-line rendition of this instance into text.
void	unregisterComponent(int id, int h) Unregister a component from the Manager.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

clientMessageQueue

protected transient java.util.Map<Client,java.util.LinkedList<com.cosylab.acs.maci.manager.ManagerImpl.ClientMessageTask>> clientMessageQueue

Queue (per client) for its messages.

STATE_PERSISTENCE_DEFAULT

public static final java.lang.String STATE_PERSISTENCE_DEFAULT

See Also:

Constant Field Values

FAULT_FAMILY

protected static final java.lang.String FAULT_FAMILY

See Also:

Constant Field Values

FAULT_MEMBER

protected static final java.lang.String FAULT_MEMBER

See Also:

Constant Field Values

FAULT_CODE

protected static final int FAULT_CODE

See Also:

Constant Field Values

Constructor Detail

ManagerImpl

public ManagerImpl()

Method Detail

registerGroupedNotifyTaks

protected void registerGroupedNotifyTaks(java.lang.Object key,
                                         com.cosylab.acs.maci.manager.ManagerImpl.GroupedRunnable runnable)

setConnectionThreadUsage

public void setConnectionThreadUsage(int percentage)

Allows setting the current percentage of used connection threads, which would typically be updated by an ORB profiler.

Parameters:

percentage -

See Also:

threadsUsedPercentage

initialize

public void initialize(Prevayler prevayler,
                       CDBAccess cdbAccess,
                       javax.naming.Context context,
                       java.util.logging.Logger logger,
                       ManagerContainerServices managerContainerServices)

Initializes Manager.

Parameters:

prevayler - implementation of prevayler system

context - remote directory implementation

initializationDone

public void initializationDone()

Called from client code after all manager initialization is done.

getHandle

public int getHandle()

Returns the handle of the Manager.

Returns:

int handle of the Manager.

setDomain

public void setDomain(java.lang.String domain)

Set name of the domain, which this manager will handle.

Parameters:

domain - name of the domain, which this manager will handle, non-null

See Also:

getDomain()

getDomain

public java.lang.String getDomain()

Description copied from interface: Manager

Return the fully qualified name of the domain, e.g., "antenna1.alma.nrao".

Specified by:

getDomain in interface Manager

Returns:

the fully qualified name of the domain

See Also:

Manager.getDomain()

generateExecutionId

protected long generateExecutionId()

getContainerInfo

public ContainerInfo[] getContainerInfo(int id,
                                        int[] handles,
                                        java.lang.String name_wc)
                                 throws AcsJNoPermissionEx

Description copied from interface: Manager

Get all the information that the Manager has about its known containers. To invoke this method, the caller must have INTROSPECT_MANAGER access rights, or it must be the object whose info it is requesting (request by handle sequence of length one). Calling this function does not affect the internal state of the Manager.

Specified by:

getContainerInfo in interface Manager

Parameters:

id - Identification of the caller.

handles - Handles of the containers whose information is requested. If this is an empty sequence, the name_wc parameter is used.

name_wc - Wildcard that the container's name must match in order for its information to be returned.

Returns:

A sequence of ContainerInfo structures containing the entire Manager's knowledge about the containers. If access is denied to a subset of objects, the handles to those objects are set to 0.

Throws:

AcsJNoPermissionEx

See Also:

Manager.getContainerInfo(int, int[], String)

getClientInfo

public ClientInfo[] getClientInfo(int id,
                                  int[] handles,
                                  java.lang.String name_wc)
                           throws AcsJNoPermissionEx

Description copied from interface: Manager

Get all the information that the Manager has about its known clients. To invoke this method, the caller must have INTROSPECT_MANAGER access rights, or it must be the object whose info it is requesting (request by handle sequence of length one). Calling this function does not affect the internal state of the Manager.

Specified by:

getClientInfo in interface Manager

Parameters:

id - Identification of the caller.

handles - Handles of the clients whose information is requested. If this is an empty sequence, the name_wc parameter is used.

name_wc - Wildcard that the clients's name must match in order for its information to be returned.

Returns:

A sequence of ClientInfo structures containing the entire Manager's knowledge about the containers. If access is denied to a subset of objects, the handles to those objects are set to 0.

Throws:

AcsJNoPermissionEx

See Also:

Manager.getClientInfo(int, int[], String)

getComponentInfo

public ComponentInfo[] getComponentInfo(int id,
                                        int[] handles,
                                        java.lang.String name_wc,
                                        java.lang.String type_wc,
                                        boolean activeOnly)
                                 throws AcsJNoPermissionEx

Description copied from interface: Manager

Get all the information that the Manager has about components. To invoke this method, the caller must have INTROSPECT_MANAGER access rights, or it must have adequate privileges to access the Component (the same as with the get_component method). Information about all components is returned, unless the active_only parameter is set to true, in which case only information about those components that are currently registered with the Manager and activated is returned. Calling this function does not affect the internal state of the Manager.

Specified by:

getComponentInfo in interface Manager

Parameters:

id - Identification of the caller.

handles - Handles of the components whose information is requested. If this is an empty sequence, the name_wc and type_wc parameters are used.

name_wc - Wildcard that the Component's name must match in order for its information to be returned.

type_wc - Wildcard that the Component's type must match in order for its information to be returned.

activeOnly - If true returns information only about components that are activated.

Returns:

A sequence of ComponentInfo structures containing the entire Manager's knowledge about the components. If access is denied to a subset of objects, the handles to those objects are set to 0.

Throws:

AcsJNoPermissionEx

See Also:

Manager.getComponentInfo(int, int[], String, String, boolean)

getService

public Component getService(int id,
                            java.net.URI curl,
                            boolean activate,
                            StatusHolder status)
                     throws AcsJCannotGetComponentEx,
                            AcsJNoPermissionEx

Description copied from interface: Manager

Get a service. NOTE: a component is also a service, i.e. a service activated by a container.

Specified by:

getService in interface Manager

Throws:

AcsJCannotGetComponentEx

AcsJNoPermissionEx

See Also:

Manager.getService(int, java.net.URI, boolean, StatusHolder)

getComponent

public Component getComponent(int id,
                              java.net.URI curl,
                              boolean activate,
                              StatusHolder status)
                       throws AcsJCannotGetComponentEx,
                              AcsJNoPermissionEx

Description copied from interface: Manager

Get a component, activating it if necessary. The client represented by id (the handle) must have adequate access rights to access the component. This is untrue of components: components always have unlimited access rights to other components.

Specified by:

getComponent in interface Manager

Parameters:

id - Identification of the caller. If this is an invalid handle, or if the caller does not have enough access rights, a AcsJNoPermissionEx exception is raised.

curl - CURL of the component whose reference is to be retrieved.

activate - true if the Component is to be activated in case it does not exist. If set to false, and the Component exist, a null reference is returned and status is set to COMPONENT_NOT_ACTIVATED.

status - Status of the request. One of COMPONENT_ACTIVATED, COMPONENT_DOES_NO_EXIST and COMPONENT_NOT_ACTIVATED.

Returns:

Reference to the Component. If the Component could not be activated, a nil reference is returned, and the status contains an error code detailing the cause of failure (one of the component_* constants).

Throws:

AcsJCannotGetComponentEx

AcsJNoPermissionEx

See Also:

Manager.getComponent(int, URI, boolean, StatusHolder)

getComponentNonSticky

public Component getComponentNonSticky(int id,
                                       java.net.URI curl)
                                throws AcsJCannotGetComponentEx,
                                       AcsJNoPermissionEx

Description copied from interface: Manager

Get a component, do not activate it and also do not do any reference counting. The client represented by id (the handle) must have adequate access rights to access the Component. This is untrue of components: components always have unlimited access rights to other components.

Specified by:

getComponentNonSticky in interface Manager

Parameters:

id - Identification of the caller. If this is an invalid handle, or if the caller does not have enough access rights, a AcsJNoPermissionEx exception is raised.

Returns:

Reference to the Component.

Throws:

AcsJCannotGetComponentEx

AcsJNoPermissionEx

See Also:

Manager.getComponentNonSticky(int id, URI curl)

makeComponentImmortal

public void makeComponentImmortal(int id,
                                  java.net.URI curl,
                                  boolean immortalState)
                           throws AcsJCannotGetComponentEx,
                                  AcsJNoPermissionEx,
                                  AcsJBadParameterEx

Description copied from interface: Manager

Change mortality state of an component. Compnent must be already active, otherwise NoResourcesException exception will be thrown. The caller must be an owner of an component or have administator rights, otherwise AcsJNoPermissionEx exception will be thrown.

Specified by:

makeComponentImmortal in interface Manager

Parameters:

id - Identification of the caller. The caller must be an owner of an component or have administator rights.

curl - The CURL of the component whose mortality to change.

immortalState - New mortality state.

Throws:

AcsJCannotGetComponentEx

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.makeComponentImmortal(int, java.net.URI, boolean)

login

public ClientInfo login(Client reference)
                 throws AcsJNoPermissionEx

Description copied from interface: Manager

Login to MACI. Containers, Clients and Administrative clients call this function first to identify themselves with the Manager. The Manager authenticates them (through the authenticate function), and assigns them access rights and a handle, through which they will identify themselves at subsequent calls to the Manager.

Specified by:

login in interface Manager

Parameters:

reference - A reference to the Client.

Returns:

A ClientInfo structure with handle (h) and access fields filled-in. If the client with this name did not logout prior to calling login, the components sequence in ClientInfo contains the handles of all components that the client was using. (For containers, the components sequence contains handles of all components previously hosted by the Container.)

Throws:

AcsJNoPermissionEx

See Also:

Manager.login(Client)

logout

public void logout(int id)
            throws AcsJNoPermissionEx

Description copied from interface: Manager

Logout from MACI.

Specified by:

logout in interface Manager

Parameters:

id - Handle of the Client that is logging out

Throws:

AcsJNoPermissionEx

See Also:

Manager.logout(int)

logout

public void logout(int id,
                   boolean pingFailed)
            throws AcsJNoPermissionEx

Logout client.

Parameters:

id - client handle.

pingFailed - flag indicating that ping has failed (i.e. reason for logout).

Throws:

AcsJNoPermissionEx

See Also:

Manager.logout(int)

registerComponent

public int registerComponent(int id,
                             java.net.URI curl,
                             java.lang.String type,
                             Component component)
                      throws AcsJNoPermissionEx,
                             AcsJBadParameterEx

Description copied from interface: Manager

Register a CORBA object as a component, assigning it a CURL and making it accessible through the Manager. The component is treated as an immortal Component.

Specified by:

registerComponent in interface Manager

Parameters:

id - Identification of the caller. The caller must have the REGISTER_COMPONENT access right to perform this operation.

curl - CURL that will be assigned to the object. The CURL must be in the Manager's domain, otherwise a fundamental property of domains that one computer belongs to only one domain would be too easy to violate.

type - Type of the component

component - Object to be registered as component.

Returns:

Returns the handle of the newly registered component.

Throws:

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.registerComponent(int, URI, String, Component)

unregisterComponent

public void unregisterComponent(int id,
                                int h)
                         throws AcsJNoPermissionEx,
                                AcsJBadParameterEx

Description copied from interface: Manager

Unregister a component from the Manager.

Specified by:

unregisterComponent in interface Manager

Parameters:

id - Identification of the caller. The caller must have the REGISTER_COMPONENT access right to perform this operation.

h - Component's handle. The component must have been previously registered through the call to register_component. If there are clients still using this component, a components_unavailable notification is issued to all of them, and the component is unregistered.

Throws:

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.unregisterComponent(int, int)

restartComponent

public Component restartComponent(int id,
                                  java.net.URI curl)
                           throws AcsJNoPermissionEx,
                                  AcsJBadParameterEx

Description copied from interface: Manager

Restart a component. The client represented by id (the handle) must be a owner of a component.

Specified by:

restartComponent in interface Manager

Parameters:

id - Identification of the caller. If this is an invalid handle, or if the caller does not have enough access rights, a AcsJNoPermissionEx exception is raised.

curl - CURL of the component whose reference is to be restarted.

Returns:

Reference to the component. If the component could not be restarted, a nil reference is returned.

Throws:

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.restartComponent(int, URI)

releaseComponent

public int releaseComponent(int id,
                            java.net.URI curl)
                     throws AcsJNoPermissionEx,
                            AcsJBadParameterEx

Description copied from interface: Manager

Release a component. In order for this operation to be possible, the caller represented by the id must have previously successfuly requested the component via a call to get_component. Releasing a component more times than requesting it should be avoided, but it produces no errors.

Specified by:

releaseComponent in interface Manager

Parameters:

id - Identification of the caller. The caller must have previously got the Component through get_component.

curl - The CURL of the Component to be released.

Returns:

Number of clients that are still using the Component after the operation completed. This is a useful debugging tool.

Throws:

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.releaseComponent(int, URI)

releaseComponentAsync

public void releaseComponentAsync(int id,
                                  java.net.URI curl,
                                  Manager.LongCompletionCallback callback)
                           throws AcsJNoPermissionEx,
                                  AcsJBadParameterEx

Specified by:

releaseComponentAsync in interface Manager

Throws:

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.releaseComponentAsync(int, java.net.URI, com.cosylab.acs.maci.Manager.LongCompletionCallback)

forceReleaseComponent

public int forceReleaseComponent(int id,
                                 java.net.URI curl)
                          throws AcsJNoPermissionEx,
                                 AcsJBadParameterEx

Description copied from interface: Manager

Forcefully release a component.

Specified by:

forceReleaseComponent in interface Manager

Parameters:

id - Identification of the caller.

curl - The CURL of the Component to be released.

Returns:

Number of clients that are still using the Component after the operation completed. This is a useful debugging tool.

Throws:

AcsJNoPermissionEx

AcsJBadParameterEx

See Also:

Manager.forceReleaseComponent(int, URI)

releaseComponents

public void releaseComponents(int id,
                              java.net.URI[] curls)
                       throws AcsJNoPermissionEx

Throws:

AcsJNoPermissionEx

See Also:

com.cosylab.acs.maci.Manager#releaseComponents(int, URI[])

shutdownContainer

public void shutdownContainer(int id,
                              java.lang.String containerName,
                              int action)
                       throws AcsJNoPermissionEx

Description copied from interface: Manager

Shutdown a container.

Specified by:

shutdownContainer in interface Manager

Parameters:

id - Identification of the caller. The caller must have the SHUTDOWN_SYSTEM access right.

action - The code to send to shutdown method of the container. If 0, the Container's disconnect methods is called instead.

Throws:

AcsJNoPermissionEx

See Also:

Manager.shutdownContainer(int, java.lang.String, int)

shutdown

public void shutdown(int id,
                     int containers)
              throws AcsJNoPermissionEx

Description copied from interface: Manager

Shutdown the Manager. Warning: This call will also deactivate all components active in the system, including startup and immortal components.

Specified by:

shutdown in interface Manager

Parameters:

id - Identification of the caller. The caller must have the SHUTDOWN_SYSTEM access right.

containers - The code to send to shutdown methods of all containers. If 0, the Container's shutdown methods are not called.

Throws:

AcsJNoPermissionEx

See Also:

Manager.shutdown(int, int)

getClientInfo

public ClientInfo getClientInfo(int id)

Get client info. for specified id of Client or Administrator.

Parameters:

id - handle of the client whose info. should be returned

returns - requested info, null if client with requested handle does not exits

noSyncGetClientInfo

public ClientInfo noSyncGetClientInfo(int id)

Get client info. (no sync version) for specified id of Client or Administrator.

Parameters:

id - handle of the client whose info. should be returned

returns - requested info, null if client with requested handle does not exits

getComponentInfo

public ComponentInfo getComponentInfo(int id)

Get component info. for specified id of Component.

Parameters:

id - handle of the component whose info. should be returned

returns - requested info, null if component with requested handle does not exits

getDefaultComponent

public ComponentInfo getDefaultComponent(int id,
                                         java.lang.String type)
                                  throws AcsJNoPermissionEx,
                                         NoDefaultComponentException

Description copied from interface: Manager

Get default component of given type. The client represented by id (the handle) must have adequate access rights to access the component.

Specified by:

getDefaultComponent in interface Manager

Parameters:

id - Identification of the caller. If this is an invalid handle, or if the caller does not have enough access rights, a AcsJNoPermissionEx exception is raised.

type - type of the component whose reference is to be restarted.

Returns:

ComponentInfo of the component. If no defualt component is found NoDefaultComponentException exception is thrown.

Throws:

AcsJNoPermissionEx

NoDefaultComponentException

See Also:

Manager.getDefaultComponent(int, java.lang.String)

getDynamicComponent

public ComponentInfo getDynamicComponent(int id,
                                         ComponentSpec componentSpec,
                                         boolean markAsDefault)
                                  throws AcsJCannotGetComponentEx,
                                         AcsJNoPermissionEx,
                                         AcsJIncompleteComponentSpecEx,
                                         AcsJInvalidComponentSpecEx,
                                         AcsJComponentSpecIncompatibleWithActiveComponentEx

Description copied from interface: Manager

Activation of an dynamic component.

Specified by:

getDynamicComponent in interface Manager

Parameters:

id - Identification of the caller.

componentSpec - Component to be obtained.

markAsDefault - Mark component as default component of its type.

Returns:

ComponentInfo of requested component. If componentSpec if found to be incomplete IncompleteComponentSpecException exception is thrown. If requested component collides with already activated component with the same name ComponentSpecIncompatibleWithActiveComponentException exception is thrown.

Throws:

AcsJCannotGetComponentEx

AcsJNoPermissionEx

AcsJIncompleteComponentSpecEx

AcsJInvalidComponentSpecEx

AcsJComponentSpecIncompatibleWithActiveComponentEx

See Also:

Manager.getDynamicComponent(int, com.cosylab.acs.maci.ComponentSpec, boolean)

getDynamicComponents

public ComponentInfo[] getDynamicComponents(int id,
                                            ComponentSpec[] components)
                                     throws AcsJNoPermissionEx

Throws:

AcsJNoPermissionEx

See Also:

com.cosylab.acs.maci.Manager#getDynamicComponents(int, com.cosylab.acs.maci.ComponentSpec[])

getCollocatedComponent

public ComponentInfo getCollocatedComponent(int id,
                                            ComponentSpec componentSpec,
                                            boolean markAsDefault,
                                            java.net.URI targetComponentURI)
                                     throws AcsJCannotGetComponentEx,
                                            AcsJNoPermissionEx,
                                            AcsJIncompleteComponentSpecEx,
                                            AcsJInvalidComponentSpecEx,
                                            AcsJComponentSpecIncompatibleWithActiveComponentEx

Description copied from interface: Manager

Activation of an co-deployed component.

Specified by:

getCollocatedComponent in interface Manager

Parameters:

id - Identification of the caller.

componentSpec - Component to be obtained.

markAsDefault - Mark component as default component of its type.

targetComponentURI - target co-deployed component.

Returns:

ComponentInfo of requested component. If componentSpec if found to be incomplete IncompleteComponentSpecException exception is thrown. If requested component collides with already activated component with the same name ComponentSpecIncompatibleWithActiveComponentException exception is thrown.

Throws:

AcsJCannotGetComponentEx

AcsJNoPermissionEx

AcsJIncompleteComponentSpecEx

AcsJInvalidComponentSpecEx

AcsJComponentSpecIncompatibleWithActiveComponentEx

See Also:

Manager.getCollocatedComponent(int, com.cosylab.acs.maci.ComponentSpec, boolean, URI)

isServiceComponent

public boolean isServiceComponent(java.lang.String name)

Checks if component name is a service component name, list of names is defined in the CDB.

Parameters:

name - name to be checked, non-null

initializeFederation

public void initializeFederation(java.util.Hashtable federationDirectoryProperties)
                          throws CoreException

Initialize manager federation.

Throws:

CoreException

toString

public java.lang.String toString()

Returns a single-line rendition of this instance into text.

Returns:

internal state of this instance

reportPrevaylerState

public void reportPrevaylerState(boolean raise,
                                 java.lang.Throwable alarmEx)

Convenience method for send_alarm with given state.

Parameters:

faultMember -

state -

setStatePersistence

public void setStatePersistence(int id,
                                boolean enable)
                         throws AcsJNoPermissionEx

Description copied from interface: Manager

Enable/disable state persistence subsystem.

Specified by:

setStatePersistence in interface Manager

Parameters:

id - Identification of the caller.

enable - enable/disable switch.

Throws:

AcsJNoPermissionEx

getStatePersitenceFlag

public java.util.concurrent.atomic.AtomicBoolean getStatePersitenceFlag()

getContainers

public HandleDataStore getContainers()

Returns the containers.

Returns:

HandleDataStore

getAdministrators

public HandleDataStore getAdministrators()

Returns the administrators.

Returns:

HandleDataStore

getClients

public HandleDataStore getClients()

Returns the clients.

Returns:

HandleDataStore

getComponents

public HandleDataStore getComponents()

Returns the components.

Returns:

HandleDataStore

logHandleRelease

public void logHandleRelease(int handle,
                             ManagerImpl.WhyUnloadedReason reason)

Log handle release.

Parameters:

handle -

reason -

logHandleCleanup

public void logHandleCleanup(long maxAgeMs)

Log handle cleanup (removes logs older than maxAgeMs).

Parameters:

maxAgeMs -

getHandleReleaseLog

public com.cosylab.acs.maci.manager.ManagerImpl.HandleMonitorEntry getHandleReleaseLog(int handle)

Get handle release log.

Parameters:

handle -

Returns:

log or null if it does not exist.

getReleasedHandles

public java.util.Map<java.lang.Integer,com.cosylab.acs.maci.manager.ManagerImpl.HandleMonitorEntry> getReleasedHandles()

Get handle released map.

Returns:

getUnavailableComponents

public java.util.Map getUnavailableComponents()

Returns the unavailableComponents.

Returns:

Map

getDefaultComponents

public java.util.Map<java.lang.String,ComponentInfo> getDefaultComponents()

Returns the defaultComponents.

Returns:

Map

getRemoteDirectory

public javax.naming.Context getRemoteDirectory()

Returns the remoteDirectory.

Returns:

Context

setTransport

public void setTransport(Transport transport)

Set the transport.

Parameters:

transport -

setRemoteDirectory

public void setRemoteDirectory(javax.naming.Context remoteDirectory)

Sets the remoteDirectory.

Parameters:

remoteDirectory - The remoteDirectory to set

getManagerComponentReference

public java.lang.Object getManagerComponentReference()

Returns the managerComponentReference.

Returns:

Object

getRemoteDirectoryComponentReference

public java.lang.Object getRemoteDirectoryComponentReference()

Returns the remoteDirectoryComponentReference.

Returns:

Object

setManagerComponentReference

public void setManagerComponentReference(java.lang.Object managerComponentReference)

Sets the managerComponentReference.

Parameters:

managerComponentReference - The managerComponentReference to set

setRemoteDirectoryComponentReference

public void setRemoteDirectoryComponentReference(java.lang.Object remoteDirectoryComponentReference)

Sets the remoteDirectoryComponentReference.

Parameters:

remoteDirectoryComponentReference - The remoteDirectoryComponentReference to set

isShuttingDown

public boolean isShuttingDown()

Return shutdown status of the Manager.

Returns:

shutdown status of the Manager

getShutdownImplementation

public ManagerShutdown getShutdownImplementation()

Returns the shutdownImplementation.

Returns:

ManagerShutdown

setShutdownImplementation

public void setShutdownImplementation(ManagerShutdown shutdownImplementation)

Sets the shutdownImplementation.

Parameters:

shutdownImplementation - The shutdownImplementation to set

getLockTimeout

public long getLockTimeout()

Returns lock timeout (deadlock detection time) in ms.

Returns:

lock timeout (deadlock detection time) in ms

setLockTimeout

public void setLockTimeout(long l)

Sets lock timeout (deadlock detection time) in ms.

Parameters:

l - lock timeout (deadlock detection time) in ms

setCDBAccess

public void setCDBAccess(CDBAccess cdbAccess)

Sets CDB access.

Parameters:

cdbAccess - cdbAccess to set.

getActiveAlarms

public java.util.HashSet getActiveAlarms()

Returns:

the activeAlarms

hasActiveAlarm

public boolean hasActiveAlarm(java.lang.String faultMember)

Flag if alarm is active.

alarmRaised

public void alarmRaised(java.lang.String faultMember)

Remember that alarms has been raised.

alarmCleared

public void alarmCleared(java.lang.String faultMember)

Remember that alarms has been cleared.