com.opencloud.rhino.management.profile

Interface ProfileTableUsageMBean

All Superinterfaces:

ProfileTableUsageMBean

public interface ProfileTableUsageMBean
extends ProfileTableUsageMBean

Rhino extensions to SLEE Profile Table Usage MBeans.

To simplify matters, Rhino only emits Usage Notifications on Usage MBeans representing cluster-wide usage state, created using the ProfileTableUsageMBean.getUsageMBean() or getUsageMBean(String) methods. Usage MBeans created using the getUsageMBean(int) or getUsageMBean(String, int) methods, representing usage state on a single node, will not emit any usage notifications.

Field Summary

Fields

Modifier and Type	Field and Description
static String	NAMESPACE_KEY The JMX Object Name property key that identifies the namespace that the Profile Table Usage MBean belongs to.

Fields inherited from interface javax.slee.management.ProfileTableUsageMBean

BASE_OBJECT_NAME, PROFILE_TABLE_NAME_KEY

Method Summary

Methods

Modifier and Type	Method and Description
ObjectName	getUsageMBean(int nodeID) Get the JMX Object Name of a UsageMBean object that provides management access to the unnamed usage parameter set on the specified node for the profile table that this MBean is providing usage management access for.
ObjectName	getUsageMBean(String paramSetName)
ObjectName	getUsageMBean(String paramSetName, int nodeID) Get the JMX Object Name of a UsageMBean object that provides management access to the named usage parameter set on the specified node for the profile table that this MBean is providing usage management access for.
ObjectName	getUsageNotificationManagerMBean(String upiType) Get the JMX Object Name of a UsageNotificationManagerMBean that provides management access to the usage notification manager for the specified usage parameters interface type for the profile table that this MBean is providing usage management access for.
String[]	getUsageParametersInterfaceTypes() Get the names of the usage parameters interface types that the profile specification of the profile table that this MBean is providing usage management access for has declared.

Methods inherited from interface javax.slee.management.ProfileTableUsageMBean

close, createUsageParameterSet, getProfileTableName, getUsageMBean, getUsageNotificationManagerMBean, getUsageParameterSets, removeUsageParameterSet, resetAllUsageParameters

Field Detail

NAMESPACE_KEY

static final String NAMESPACE_KEY

The JMX Object Name property key that identifies the namespace that the Profile Table Usage MBean belongs to. This key is equal to the string "namespace". This key is only present in the Object Name if the Profile Table Usage MBean resides in a user-defined namespace, rather than the default namespace. The value of this key, if present, is the quoted name of the namespace.

Since:

Rhino 2.5.0

See Also:

Constant Field Values

Method Detail

getUsageMBean

ObjectName getUsageMBean(int nodeID)
                         throws ManagementException

Get the JMX Object Name of a UsageMBean object that provides management access to the unnamed usage parameter set on the specified node for the profile table that this MBean is providing usage management access for.

The Usage MBean referenced by the Object Name returned by this method will operate only on the usage state stored by the specified node, in contrast to the Usage MBean referenced by ProfileTableUsageMBean.getUsageMBean() which will operate on and/or aggregate usage state from the entire cluster.

The Usage MBean referenced by the Object Name does not emit usage notifications. Usage notifications are only emitted by the Usage MBean referenced by ProfileTableUsageMBean.getUsageMBean().

Parameters:

nodeID - the node ID of the node whose usage state should be accessed by the Usage MBean.

Returns:

the Object Name of a UsageMBean object for the unnamed usage parameter set for the profile table.

Throws:

ManagementException - if the Object Name could not be obtained due to a system-level failure.

getUsageMBean

ObjectName getUsageMBean(String paramSetName,
                       int nodeID)
                         throws NullPointerException,
                                UnrecognizedUsageParameterSetNameException,
                                ManagementException

Get the JMX Object Name of a UsageMBean object that provides management access to the named usage parameter set on the specified node for the profile table that this MBean is providing usage management access for.

The Usage MBean referenced by the Object Name returned by this method will operate only on the usage state stored by the specified node, in contrast to the Usage MBean referenced by getUsageMBean(String) which will operate on and/or aggregate usage state from the entire cluster.

The Usage MBean referenced by the Object Name does not emit usage notifications. Usage notifications are only emitted by the Usage MBean referenced by getUsageMBean(String).

Parameters:

paramSetName - the name of the usage parameter set. The name must be one of the names returned by ProfileTableUsageMBean.getUsageParameterSets().

nodeID - the node ID of the node whose usage state should be accessed by the Usage MBean.

Returns:

the Object Name of a UsageMBean object for the named usage parameter set for the profile table.

Throws:

NullPointerException - if paramSetName is null.

UnrecognizedUsageParameterSetNameException - if the named usage parameter set has not been created for the profilet table.

ManagementException - if the Object Name could not be obtained due to a system-level failure.

getUsageMBean

ObjectName getUsageMBean(String paramSetName)
                         throws NullPointerException,
                                UnrecognizedUsageParameterSetNameException,
                                ManagementException

Specified by:

getUsageMBean in interface ProfileTableUsageMBean

Throws:

NullPointerException

UnrecognizedUsageParameterSetNameException

ManagementException

getUsageParametersInterfaceTypes

String[] getUsageParametersInterfaceTypes()
                                          throws ManagementException

Get the names of the usage parameters interface types that the profile specification of the profile table that this MBean is providing usage management access for has declared. This method only returns a non zero-length result if the profile specification has declared usage parameter interfaces using the Rhino extension mechanism.

Returns:

the names of the usage parameters interface types that the profile specification has declared.

Throws:

ManagementException - if the names could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0

getUsageNotificationManagerMBean

ObjectName getUsageNotificationManagerMBean(String upiType)
                                            throws UnrecognizedUsageParametersInterfaceTypeException,
                                                   ManagementException

Get the JMX Object Name of a UsageNotificationManagerMBean that provides management access to the usage notification manager for the specified usage parameters interface type for the profile table that this MBean is providing usage management access for.

Parameters:

upiType - the the usage parameters interface type. This type must be one of the type names returned by getUsageParametersInterfaceTypes.

Throws:

UnrecognizedUsageParametersInterfaceTypeException - if the named usage parameters interface type does not exist for the profile table.

ManagementException - if the Object Name could not be obtained due to a system-level failure.

Since:

Rhino 2.4.0