org.apache.stratos.messaging.message.processor.topology.updater

Class TopologyUpdater

java.lang.Object

org.apache.stratos.messaging.message.processor.topology.updater.TopologyUpdater

public class TopologyUpdater
extends Object

Used to lock the Topology for writes by messaging component

Acquire a write lock:

From root level, acquire read lock, and acquire a write lock only for the relevant sub tree.

Example 1: Acquiring write lock for a Cluster to modify the Cluster object - acquiring: public static void acquireWriteLockForCluster (String serviceName, String clusterId)

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

Example 2: Acquiring write lock to add a new Cluster object - acquiring: public static void acquireWriteLockForService (String serviceName)

releasing: public static void releaseWriteLockForService (String serviceName)

Example 3: Acquiring the write lock to add a deploy a Cartridge (add a new Service) acquire: public static void acquireWriteLockForServices()

release: public static void releaseWriteLockForServices()

Constructor Summary

Constructors

Constructor and Description
TopologyUpdater()

Method Summary

Methods

Modifier and Type	Method and Description
static void	acquireWriteLock() Acquires write lock for the Complete Topology
static void	acquireWriteLockForCluster(String serviceName, String clusterId) Acquires write lock for a Cluster.
static void	acquireWriteLockForService(String serviceName) Acquires write lock for a Service
static void	acquireWriteLockForServices() Acquires write lock for the all Services
static void	releaseWriteLock() Releases write lock for the Complete Topology
static void	releaseWriteLockForCluster(String serviceName, String clusterId) Releases write lock for a Cluster.
static void	releaseWriteLockForService(String serviceName) Releases write lock for a Service
static void	releaseWriteLockForServices() Releases write 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

TopologyUpdater

public TopologyUpdater()

Method Detail

acquireWriteLock

public static void acquireWriteLock()

Acquires write lock for the Complete Topology

releaseWriteLock

public static void releaseWriteLock()

Releases write lock for the Complete Topology

acquireWriteLockForServices

public static void acquireWriteLockForServices()

Acquires write lock for the all Services

releaseWriteLockForServices

public static void releaseWriteLockForServices()

Releases write lock for the all Services

acquireWriteLockForService

public static void acquireWriteLockForService(String serviceName)

Acquires write lock for a Service

Parameters:

serviceName - service name to acquire write lock

releaseWriteLockForService

public static void releaseWriteLockForService(String serviceName)

Releases write lock for a Service

Parameters:

serviceName - service name to release write lock

acquireWriteLockForCluster

public static void acquireWriteLockForCluster(String serviceName,
                              String clusterId)

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

Parameters:

serviceName - service name to acquire write lock

clusterId - cluster id to acquire write lock

releaseWriteLockForCluster

public static void releaseWriteLockForCluster(String serviceName,
                              String clusterId)

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

Parameters:

serviceName - service name to release write lock

clusterId - cluster id to release write lock