org.apache.stratos.messaging.message.receiver.topology

Class TopologyManager

java.lang.Object

org.apache.stratos.messaging.message.receiver.topology.TopologyManager

public class TopologyManager
extends Object

A singleton class for managing the topology data structure.

Usage: Acquire a relevant lock and invoke the getTopology() method inside a try block. Once processing is done release the lock using a finally block.

Acquiring Locks:

Stratos supports hierarchical locking. As per the practice, we need to lock the hierarchy from root level till the relevant sub tree.

Acquire a read lock:

From root level, acquire read locks till the relevant sub tree

Examples -

Example 1: Acquiring read lock to read Cluster information acquiring: public static void acquireReadLockForCluster (String serviceName, String clusterId)

releasing: public static void releaseReadLockForCluster (String serviceName, String clusterId)

Example 2: Acquiring read lock for a particular Service acquiring: public static void acquireReadLockForService (String serviceName)

releasing: public static void releaseReadLockForService (String serviceName)

Constructor Summary

Constructors

Constructor and Description
TopologyManager()

Method Summary

Methods

Modifier and Type	Method and Description
static void	acquireReadLock() Acquires read lock for the Complete Topology
static void	acquireReadLockForCluster(String serviceName, String clusterId) Acquires read lock for a Cluster.
static void	acquireReadLockForService(String serviceName) Acquires read lock for a Service
static void	acquireReadLockForServices() Acquires read lock for the all Services
static Topology	getTopology()
static void	releaseReadLock() Releases read lock for the Complete Topology
static void	releaseReadLockForCluster(String serviceName, String clusterId) Releases read lock for a Cluster.
static void	releaseReadLockForService(String serviceName) Releases read lock for a Service
static void	releaseReadLockForServices() Releases read lock for the all Services

Methods inherited from class java.lang.Object

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

Constructor Detail

TopologyManager

public TopologyManager()

Method Detail

acquireReadLock

public static void acquireReadLock()

Acquires read lock for the Complete Topology

releaseReadLock

public static void releaseReadLock()

Releases read lock for the Complete Topology

acquireReadLockForServices

public static void acquireReadLockForServices()

Acquires read lock for the all Services

releaseReadLockForServices

public static void releaseReadLockForServices()

Releases read lock for the all Services

acquireReadLockForService

public static void acquireReadLockForService(String serviceName)

Acquires read lock for a Service

Parameters:

serviceName - service name to acquire read lock

releaseReadLockForService

public static void releaseReadLockForService(String serviceName)

Releases read lock for a Service

Parameters:

serviceName - service name to release read lock

acquireReadLockForCluster

public static void acquireReadLockForCluster(String serviceName,
                             String clusterId)

Acquires read lock for a Cluster. This will acquire the read lock in the following order 1. for the Service 2. for the Cluster

Parameters:

serviceName - service name to acquire read lock

clusterId - cluster id to acquire read lock

releaseReadLockForCluster

public static void releaseReadLockForCluster(String serviceName,
                             String clusterId)

Releases read lock for a Cluster. This will release the read lock in the following order 1. for the Cluster 2. for the Service

Parameters:

serviceName - service name to release read lock

clusterId - cluster id to release read lock

getTopology

public static Topology getTopology()