org.opendaylight.controller.config.manager.impl.jmx

Class JMXNotifierConfigRegistry

java.lang.Object

org.opendaylight.controller.config.manager.impl.jmx.JMXNotifierConfigRegistry

All Implemented Interfaces:

AutoCloseable, ConfigRegistry, LookupRegistry, ServiceReferenceReadableRegistry, ConfigRegistryImplMXBean

public class JMXNotifierConfigRegistry
extends Object
implements ConfigRegistryImplMXBean, AutoCloseable

Thin wrapper over ConfigRegistry emitting JMX notifications.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JMXNotifierConfigRegistry.NotifierMXBean
static class	JMXNotifierConfigRegistry.NotifierMXBeanImpl

Field Summary

Fields inherited from interface org.opendaylight.controller.config.api.ConfigRegistry

OBJECT_NAME, OBJECT_NAME_NO_NOTIFICATIONS

Constructor Summary

Constructors

Constructor and Description
JMXNotifierConfigRegistry(ConfigRegistryImplMXBean delegate, MBeanServer beanServer)

Method Summary

Modifier and Type	Method and Description
ObjectName	beginConfig() Opens new configuration transaction.
void	checkConfigBeanExists(ObjectName objectName) Check that object name corresponds with existing module.
void	checkServiceReferenceExists(ObjectName objectName)
void	close()
CommitStatus	commitConfig(ObjectName transactionControllerON) Verifies and commits transaction.
Set<String>	getAvailableModuleFactoryQNames() Get the qNames of all ModuleFactory instances in the system.
Set<String>	getAvailableModuleNames() Get the module names available in the system.
List<ObjectName>	getOpenConfigs() List of open configuration transactions.
String	getServiceInterfaceName(String namespace, String localName) Get the name of the service interface.
Map<String,Map<String,ObjectName>>	getServiceMapping() Get mapping of services to reference names and module object names.
ObjectName	getServiceReference(String serviceInterfaceQName, String refName) Get the reference to that service.
long	getVersion() Get the version of last committed transaction that is now used as base version.
boolean	isHealthy() Will return true unless there was a transaction that succeeded during validation but failed in second phase of commit.
ObjectName	lookupConfigBean(String moduleName, String instanceName) Find read module.
ObjectName	lookupConfigBeanByServiceInterfaceName(String serviceInterfaceQName, String refName) Lookup object name by fully qualified service interface name and service reference name.
Set<ObjectName>	lookupConfigBeans() Find all modules.
Set<ObjectName>	lookupConfigBeans(String moduleName) Find modules with given module name.
Set<ObjectName>	lookupConfigBeans(String moduleName, String instanceName) Find read modules.
Set<ObjectName>	lookupRuntimeBeans() Find all runtime beans.
Set<ObjectName>	lookupRuntimeBeans(String moduleName, String instanceName) Find all runtime of specified module.
Set<String>	lookupServiceInterfaceNames(ObjectName objectName) Find all available service interface names of a module.
Map<String,ObjectName>	lookupServiceReferencesByServiceInterfaceName(String serviceInterfaceQName) Get current mapping between reference names and module object names for given service interface name.

Methods inherited from class java.lang.Object

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

Constructor Detail

JMXNotifierConfigRegistry

public JMXNotifierConfigRegistry(ConfigRegistryImplMXBean delegate,
                                 MBeanServer beanServer)

Method Detail

getVersion

public long getVersion()

Description copied from interface: ConfigRegistryImplMXBean

Get the version of last committed transaction that is now used as base version. Transactions can only be committed if their parent version matches this value, that means, transaction must be started after last one has been committed.

Specified by:

getVersion in interface ConfigRegistryImplMXBean

Returns:

version

beginConfig

public ObjectName beginConfig()

Description copied from interface: ConfigRegistry

Opens new configuration transaction.

Specified by:

beginConfig in interface ConfigRegistry

Returns:

ObjectName of ConfigTransactionControllerMXBean

commitConfig

public CommitStatus commitConfig(ObjectName transactionControllerON)
                          throws ConflictingVersionException,
                                 ValidationException

Description copied from interface: ConfigRegistry

Verifies and commits transaction.

Specified by:

commitConfig in interface ConfigRegistry

Parameters:

transactionControllerON - ObjectName of ConfigTransactionControllerMXBean that was received in ConfigRegistry.beginConfig() method call.

Returns:

CommitStatus

Throws:

ConflictingVersionException - if configuration state was changed

ValidationException - if validation fails

getOpenConfigs

public List<ObjectName> getOpenConfigs()

Description copied from interface: ConfigRegistry

List of open configuration transactions.

Specified by:

getOpenConfigs in interface ConfigRegistry

Returns:

list of open configuration transactions.

isHealthy

public boolean isHealthy()

Description copied from interface: ConfigRegistry

Will return true unless there was a transaction that succeeded during validation but failed in second phase of commit. In this case the server is unstable and its state is undefined.

Specified by:

isHealthy in interface ConfigRegistry

getAvailableModuleNames

public Set<String> getAvailableModuleNames()

Description copied from interface: ConfigRegistry

Get the module names available in the system.

Specified by:

getAvailableModuleNames in interface ConfigRegistry

Returns:

module factory names available in the system

lookupConfigBeans

public Set<ObjectName> lookupConfigBeans()

Description copied from interface: LookupRegistry

Find all modules. Same Module can be registered multiple times.

Specified by:

lookupConfigBeans in interface LookupRegistry

Returns:

objectNames

lookupConfigBeans

public Set<ObjectName> lookupConfigBeans(String moduleName)

Description copied from interface: LookupRegistry

Find modules with given module name.

Specified by:

lookupConfigBeans in interface LookupRegistry

Parameters:

moduleName - name of module

Returns:

objectNames

lookupConfigBeans

public Set<ObjectName> lookupConfigBeans(String moduleName,
                                         String instanceName)

Description copied from interface: LookupRegistry

Find read modules.

Specified by:

lookupConfigBeans in interface LookupRegistry

Parameters:

moduleName - exact match for searched module name, can contain '*' to match all values.

instanceName - exact match for searched instance name, can contain '*' to match all values.

Returns:

objectNames

lookupConfigBean

public ObjectName lookupConfigBean(String moduleName,
                                   String instanceName)
                            throws InstanceNotFoundException

Description copied from interface: LookupRegistry

Find read module.

Specified by:

lookupConfigBean in interface LookupRegistry

Parameters:

moduleName - exact match for searched module name, can contain '*' to match all values.

instanceName - exact match for searched instance name, can contain '*' to match all values.

Returns:

objectNames

Throws:

InstanceNotFoundException - if search did not find exactly one instance

checkConfigBeanExists

public void checkConfigBeanExists(ObjectName objectName)
                           throws InstanceNotFoundException

Description copied from interface: LookupRegistry

Check that object name corresponds with existing module.

Specified by:

checkConfigBeanExists in interface LookupRegistry

Throws:

InstanceNotFoundException - if search did not find exactly one instance

getAvailableModuleFactoryQNames

public Set<String> getAvailableModuleFactoryQNames()

Description copied from interface: LookupRegistry

Get the qNames of all ModuleFactory instances in the system.

Specified by:

getAvailableModuleFactoryQNames in interface LookupRegistry

Returns:

qNames of all ModuleFactory instances in the system

lookupRuntimeBeans

public Set<ObjectName> lookupRuntimeBeans()

Description copied from interface: LookupRegistry

Find all runtime beans.

Specified by:

lookupRuntimeBeans in interface LookupRegistry

Returns:

objectNames

lookupRuntimeBeans

public Set<ObjectName> lookupRuntimeBeans(String moduleName,
                                          String instanceName)

Description copied from interface: LookupRegistry

Find all runtime of specified module.

Specified by:

lookupRuntimeBeans in interface LookupRegistry

Parameters:

moduleName - of bean

instanceName - of bean

Returns:

objectNames

lookupConfigBeanByServiceInterfaceName

public ObjectName lookupConfigBeanByServiceInterfaceName(String serviceInterfaceQName,
                                                         String refName)

Description copied from interface: ServiceReferenceReadableRegistry

Lookup object name by fully qualified service interface name and service reference name.

Specified by:

lookupConfigBeanByServiceInterfaceName in interface ServiceReferenceReadableRegistry

Parameters:

serviceInterfaceQName - service interface name

refName - service reference name supplied in .api .ConfigTransactionController#saveServiceReference(String, String, javax.management.ObjectName)

getServiceMapping

public Map<String,Map<String,ObjectName>> getServiceMapping()

Description copied from interface: ServiceReferenceReadableRegistry

Get mapping of services to reference names and module object names.

Specified by:

getServiceMapping in interface ServiceReferenceReadableRegistry

lookupServiceReferencesByServiceInterfaceName

public Map<String,ObjectName> lookupServiceReferencesByServiceInterfaceName(String serviceInterfaceQName)

Description copied from interface: ServiceReferenceReadableRegistry

Get current mapping between reference names and module object names for given service interface name.

Specified by:

lookupServiceReferencesByServiceInterfaceName in interface ServiceReferenceReadableRegistry

Parameters:

serviceInterfaceQName - service interface name

lookupServiceInterfaceNames

public Set<String> lookupServiceInterfaceNames(ObjectName objectName)
                                        throws InstanceNotFoundException

Description copied from interface: ServiceReferenceReadableRegistry

Find all available service interface names of a module.

Specified by:

lookupServiceInterfaceNames in interface ServiceReferenceReadableRegistry

Parameters:

objectName - module object name

Throws:

InstanceNotFoundException - if search did not find exactly one instance

getServiceInterfaceName

public String getServiceInterfaceName(String namespace,
                                      String localName)

Description copied from interface: ServiceReferenceReadableRegistry

Get the name of the service interface.

Specified by:

getServiceInterfaceName in interface ServiceReferenceReadableRegistry

Parameters:

namespace - service interface namespace

localName - service interface local name

Returns:

fully qualified name needed by all other service reference mapping methods.

getServiceReference

public ObjectName getServiceReference(String serviceInterfaceQName,
                                      String refName)
                               throws InstanceNotFoundException

Description copied from interface: ServiceReferenceReadableRegistry

Get the reference to that service.

Specified by:

getServiceReference in interface ServiceReferenceReadableRegistry

Returns:

ObjectName with type=Service that was created using .config .api.ServiceReferenceWritableRegistry#saveServiceReference(String, String, javax.management.ObjectName)

Throws:

InstanceNotFoundException

checkServiceReferenceExists

public void checkServiceReferenceExists(ObjectName objectName)
                                 throws InstanceNotFoundException

Specified by:

checkServiceReferenceExists in interface ServiceReferenceReadableRegistry

Throws:

InstanceNotFoundException

close

public void close()

Specified by:

close in interface AutoCloseable