Module java.management
Package javax.management.monitor

# Interface StringMonitorMBean

All Superinterfaces:
  `MonitorMBean`

All Known Implementing Classes:
  `StringMonitor`

public interface StringMonitorMBean extends MonitorMBean
Exposes the remote management interface of the string monitor MBean.

Since:
  1.5

## Method Summary

Modifier and Type
Method
Description
`String`
`getDerivedGauge()`
Deprecated.
As of JMX 1.2, replaced by `getDerivedGauge(ObjectName)`
`String`
`getDerivedGauge(ObjectName object)`
Gets the derived gauge for the specified MBean.
`long`
`getDerivedGaugeTimeStamp()`
Deprecated.
As of JMX 1.2, replaced by `getDerivedGaugeTimeStamp(ObjectName)`
`long`
`getDerivedGaugeTimeStamp(ObjectName object)`
Gets the derived gauge timestamp for the specified MBean.
`boolean`
`getNotifyDiffer()`
Gets the differing notification's on/off switch value.
`boolean`
`getNotifyMatch()`
Gets the matching notification's on/off switch value.
`String`
`getStringToCompare()`
Gets the string to compare with the observed attribute.
`void`
`setNotifyDiffer(boolean value)`
Sets the differing notification's on/off switch value.
`void`
`setNotifyMatch(boolean value)`
Sets the matching notification's on/off switch value.
`void`
`setStringToCompare(String value)`
Sets the string to compare with the observed attribute.

### Methods declared in interface javax.management.monitor.MonitorMBean

`addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, removeObservedObject, setGranularityPeriod, setObservedAttribute, setObservedObject, start, stop`

## Method Details

### getDerivedGauge

@Deprecated String getDerivedGauge()
Deprecated.
As of JMX 1.2, replaced by `getDerivedGauge(ObjectName)`
Gets the derived gauge.

Returns:
  The derived gauge.

### getDerivedGaugeTimeStamp

@Deprecated long getDerivedGaugeTimeStamp()
Deprecated.
As of JMX 1.2, replaced by `getDerivedGaugeTimeStamp(ObjectName)`
Gets the derived gauge timestamp.

Returns:
  The derived gauge timestamp.

### getDerivedGauge

String getDerivedGauge(ObjectName object)
Gets the derived gauge for the specified MBean.

Parameters:
  `object` - the MBean for which the derived gauge is to be returned
Returns:
  The derived gauge for the specified MBean if this MBean is in the set of observed MBeans, or `null` otherwise.

### getDerivedGaugeTimeStamp

long getDerivedGaugeTimeStamp(ObjectName object)
Gets the derived gauge timestamp for the specified MBean.

Parameters:
  `object` - the MBean for which the derived gauge timestamp is to be returned
Returns:
  The derived gauge timestamp for the specified MBean if this MBean is in the set of observed MBeans, or `null` otherwise.

### getStringToCompare

String getStringToCompare()
Gets the string to compare with the observed attribute.

Returns:
  The string value.
See Also:
  - `setStringToCompare(java.lang.String)`

### setStringToCompare

void setStringToCompare(String value) throws IllegalArgumentException
Sets the string to compare with the observed attribute.

Parameters:
  `value` - The string value.
Throws:
  `IllegalArgumentException` - The specified string to compare is null.
See Also:
  - `getStringToCompare()`

### getNotifyMatch

boolean getNotifyMatch()
Gets the matching notification's on/off switch value.

Returns:
  `true` if the string monitor notifies when matching, `false` otherwise.
See Also:
  - `setNotifyMatch(boolean)`

### setNotifyMatch

void setNotifyMatch(boolean value)
Sets the matching notification's on/off switch value.

Parameters:
  `value` - The matching notification's on/off switch value.
See Also:
  - `getNotifyMatch()`

### getNotifyDiffer

boolean getNotifyDiffer()
Gets the differing notification's on/off switch value.

Returns:
  `true` if the string monitor notifies when differing, `false` otherwise.
See Also:
  - `setNotifyDiffer(boolean)`

### setNotifyDiffer

void setNotifyDiffer(boolean value)
Sets the differing notification's on/off switch value.

Parameters:
  `value` - The differing notification's on/off switch value.
See Also:
  - `getNotifyDiffer()`