Package org.apache.derby.impl.services.jmxnone

Class NoManagementService

java.lang.Object

org.apache.derby.impl.services.jmxnone.NoManagementService

All Implemented Interfaces:

ManagementService, ManagementMBean

public final class NoManagementService
extends java.lang.Object
implements ManagementService

Dummy management service for environments that do not support JMX, such as Java SE compact profile 2.

Field Summary

Fields inherited from interface org.apache.derby.iapi.services.jmx.ManagementService

DERBY_JMX_DOMAIN

Constructor Summary

Constructors

Constructor	Description
NoManagementService()

Method Summary

Modifier and Type	Method	Description
java.lang.String	getSystemIdentifier()	Get the system identifier that this MBean is managing.
boolean	isManagementActive()	Is Derby's JMX management active.
java.lang.String	quotePropertyValue(java.lang.String value)	Quote an MBean key property value, so that it is safe to pass to ManagementService.registerMBean(T, java.lang.Class<T>, java.lang.String) even if it potentially contains special characters.
<T> java.lang.Object	registerMBean(T bean, java.lang.Class<T> beanInterface, java.lang.String keyProperties)	Registers an MBean with the MBean server.
void	startManagement()	Inform Derby to start its JMX management by registering MBeans relevant to its current state.
void	stopManagement()	Inform Derby to stop its JMX management by unregistering its MBeans.
void	unregisterMBean(java.lang.Object mbeanIdentifier)	Unregister a mbean previously registered with registerMBean.

Methods inherited from class java.lang.Object

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

Constructor Detail

NoManagementService

public NoManagementService()

Method Detail

registerMBean

public <T> java.lang.Object registerMBean(T bean,
                                          java.lang.Class<T> beanInterface,
                                          java.lang.String keyProperties)

Description copied from interface: ManagementService

Registers an MBean with the MBean server. The mbean will be unregistered automatically when Derby shuts down.

Specified by:

registerMBean in interface ManagementService

Parameters:

bean - The MBean to wrap with a StandardMBean and register

beanInterface - The management interface for the MBean.

keyProperties - The String representation of the MBean's key properties, they will be added into the ObjectName with Derby's domain. Key type should be first with a short name for the bean, typically the class name without the package.

Returns:

An identifier that can later be used to unregister the mbean.

unregisterMBean

public void unregisterMBean(java.lang.Object mbeanIdentifier)

Description copied from interface: ManagementService

Unregister a mbean previously registered with registerMBean.

Specified by:

unregisterMBean in interface ManagementService

Parameters:

mbeanIdentifier - An identifier returned by registerMBean.

isManagementActive

public boolean isManagementActive()

Description copied from interface: ManagementMBean

Is Derby's JMX management active. If active then Derby has registered MBeans relevant to its current state.

Specified by:

isManagementActive in interface ManagementMBean

Returns:

true Derby has registered beans, false Derby has not registered any beans.

startManagement

public void startManagement()

Description copied from interface: ManagementMBean

Inform Derby to start its JMX management by registering MBeans relevant to its current state. If Derby is not booted then no action is taken.

Require SystemPermission("jmx", "control") if a security manager is installed.

Specified by:

startManagement in interface ManagementMBean

See Also:

SystemPermission

stopManagement

public void stopManagement()

Description copied from interface: ManagementMBean

Inform Derby to stop its JMX management by unregistering its MBeans. If Derby is not booted then no action is taken.

Require SystemPermission("jmx", "control") if a security manager is installed.

Specified by:

stopManagement in interface ManagementMBean

See Also:

SystemPermission

getSystemIdentifier

public java.lang.String getSystemIdentifier()

Description copied from interface: ManagementMBean

Get the system identifier that this MBean is managing. The system identifier is a runtime value to disambiguate multiple Derby systems in the same virtual machine but different class loaders.

Specified by:

getSystemIdentifier in interface ManagementMBean

Returns:

Runtime identifier for the system, null if Derby is not running.

quotePropertyValue

public java.lang.String quotePropertyValue(java.lang.String value)

Description copied from interface: ManagementService

Quote an MBean key property value, so that it is safe to pass to ManagementService.registerMBean(T, java.lang.Class<T>, java.lang.String) even if it potentially contains special characters.

Specified by:

quotePropertyValue in interface ManagementService

Parameters:

value - the value to quote

Returns:

the quoted value

See Also:

ObjectName.quote(String)