Interface MonitorMBean

All Known Subinterfaces:

CounterMonitorMBean, GaugeMonitorMBean, StringMonitorMBean

All Known Implementing Classes:

CounterMonitor, GaugeMonitor, Monitor, StringMonitor

public interface MonitorMBean

Exposes the remote management interface of monitor MBeans.

Since:

1.5

Methods

start

void start()

Starts the monitor.

stop

void stop()

Stops the monitor.

addObservedObject

void addObservedObject(ObjectName object)
                throws IllegalArgumentException

Adds the specified object in the set of observed MBeans.

Parameters:

object - The object to observe.

Throws:

IllegalArgumentException - the specified object is null.

removeObservedObject

void removeObservedObject(ObjectName object)

Removes the specified object from the set of observed MBeans.

Parameters:

object - The object to remove.

containsObservedObject

boolean containsObservedObject(ObjectName object)

Tests whether the specified object is in the set of observed MBeans.

Parameters:

object - The object to check.

Returns:

true if the specified object is in the set, false otherwise.

getObservedObjects

ObjectName[] getObservedObjects()

Returns an array containing the objects being observed.

Returns:

The objects being observed.

getObservedObject

@Deprecated
ObjectName getObservedObject()

Deprecated. As of JMX 1.2, replaced by getObservedObjects()

Gets the object name of the object being observed.

Returns:

The object being observed.

See Also:

setObservedObject(javax.management.ObjectName)

setObservedObject

@Deprecated
void setObservedObject(ObjectName object)

Deprecated. As of JMX 1.2, replaced by addObservedObject(javax.management.ObjectName)

Sets the object to observe identified by its object name.

Parameters:

object - The object to observe.

See Also:

getObservedObject()

getObservedAttribute

String getObservedAttribute()

Gets the attribute being observed.

Returns:

The attribute being observed.

See Also:

setObservedAttribute(java.lang.String)

setObservedAttribute

void setObservedAttribute(String attribute)

Sets the attribute to observe.

Parameters:

attribute - The attribute to observe.

See Also:

getObservedAttribute()

getGranularityPeriod

long getGranularityPeriod()

Gets the granularity period (in milliseconds).

Returns:

The granularity period.

See Also:

setGranularityPeriod(long)

setGranularityPeriod

void setGranularityPeriod(long period)
                   throws IllegalArgumentException

Sets the granularity period (in milliseconds).

Parameters:

period - The granularity period.

Throws:

IllegalArgumentException - The granularity period is less than or equal to zero.

See Also:

getGranularityPeriod()

isActive

boolean isActive()

Tests if the monitor MBean is active. A monitor MBean is marked active when the start method is called. It becomes inactive when the stop method is called.

Returns:

true if the monitor MBean is active, false otherwise.