Класс StringMonitor

javax.management.monitor.StringMonitor

Все реализованные интерфейсы:: MBeanRegistration, MonitorMBean, StringMonitorMBean, NotificationBroadcaster, NotificationEmitter

public class StringMonitor extends Monitor implements StringMonitorMBean

Определяет MBean монитора, предназначенный для наблюдения за значениями строкового атрибута.

Строковый монитор отправляет уведомления следующим образом:

если значение атрибута совпадает со строкой для сравнения, отправляется match notification. Флаг уведомления о совпадении должен быть установлен в true.
Последующие совпадения со строкой для сравнения не вызывают новых уведомлений, пока значение атрибута не будет отличаться от строки для сравнения.
если значение атрибута отличается от строки для сравнения, отправляется differ notification. Флаг уведомления об отличии должен быть установлен в true.
Последующие отличия от строки для сравнения не вызывают новых уведомлений, пока значение атрибута не совпадёт со строкой для сравнения.

С версии:: 1.5

Краткое описание полей

Поля, объявленные в классе Monitor

alreadyNotified, alreadyNotifieds, capacityIncrement, dbgTag, elementCount, OBSERVED_ATTRIBUTE_ERROR_NOTIFIED, OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED, OBSERVED_OBJECT_ERROR_NOTIFIED, RESET_FLAGS_ALREADY_NOTIFIED, RUNTIME_ERROR_NOTIFIED, server

Краткое описание конструкторов

Конструктор	Описание
`StringMonitor()`	Конструктор по умолчанию.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getDerivedGauge()`	Устарел. Начиная с JMX 1.2 заменён на `getDerivedGauge(ObjectName)`
`String`	`getDerivedGauge(ObjectName object)`	Возвращает производное значение указанного объекта, если этот объект входит в набор наблюдаемых MBean, или `null` в противном случае.
`long`	`getDerivedGaugeTimeStamp()`	Устарел. Начиная с JMX 1.2 заменён на `getDerivedGaugeTimeStamp(ObjectName)`
`long`	`getDerivedGaugeTimeStamp(ObjectName object)`	Возвращает временную метку производного значения указанного объекта, если этот объект входит в набор наблюдаемых MBean, или `0` в противном случае.
`MBeanNotificationInfo[]`	`getNotificationInfo()`	Возвращает объект `NotificationInfo`, содержащий имя Java-класса уведомления и типы уведомлений, отправляемых строковым монитором.
`boolean`	`getNotifyDiffer()`	Возвращает общее для всех наблюдаемых MBean значение переключателя уведомлений об отличии.
`boolean`	`getNotifyMatch()`	Возвращает общее для всех наблюдаемых MBean значение переключателя уведомлений о совпадении.
`String`	`getStringToCompare()`	Возвращает строку для сравнения с наблюдаемым атрибутом, общую для всех наблюдаемых MBean.
`void`	`setNotifyDiffer(boolean value)`	Устанавливает общее для всех наблюдаемых MBean значение переключателя уведомлений об отличии.
`void`	`setNotifyMatch(boolean value)`	Устанавливает общее для всех наблюдаемых MBean значение переключателя уведомлений о совпадении.
`void`	`setStringToCompare(String value)`	Устанавливает строку для сравнения с наблюдаемым атрибутом, общую для всех наблюдаемых MBean.
`void`	`start()`	Запускает строковый монитор.
`void`	`stop()`	Останавливает строковый монитор.

Методы, объявленные в классе Monitor

addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, postDeregister, postRegister, preDeregister, preRegister, removeObservedObject, setGranularityPeriod, setObservedAttribute, setObservedObject

Методы, объявленные в классе NotificationBroadcasterSupport

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

Методы, объявленные в классе Object

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

Методы, объявленные в интерфейсе MonitorMBean

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

Подробное описание конструкторов

StringMonitor

public StringMonitor()

Конструктор по умолчанию.

Подробное описание методов

start

public void start()

Запускает строковый монитор.

Определено в:: start в интерфейсе MonitorMBean
Переопределено в:: start в классе Monitor

stop

public void stop()

Останавливает строковый монитор.

Определено в:: stop в интерфейсе MonitorMBean
Переопределено в:: stop в классе Monitor

getDerivedGauge

public String getDerivedGauge(ObjectName object)

Возвращает производное значение указанного объекта, если этот объект входит в набор наблюдаемых MBean, или null в противном случае.

Определено в:: getDerivedGauge в интерфейсе StringMonitorMBean
Параметры:: object — имя MBean, производное значение которого требуется получить.
Возвращает:: Производное значение указанного объекта.

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)

Возвращает временную метку производного значения указанного объекта, если этот объект входит в набор наблюдаемых MBean, или 0 в противном случае.

Определено в:: getDerivedGaugeTimeStamp в интерфейсе StringMonitorMBean
Параметры:: object — имя объекта, временную метку производного значения которого нужно вернуть.
Возвращает:: Временная метка производного значения указанного объекта.

getDerivedGauge

@Deprecated public String getDerivedGauge()

Устарел.

Начиная с JMX 1.2 заменён на getDerivedGauge(ObjectName)

Возвращает производное значение первого объекта в наборе наблюдаемых MBean.

Определено в:: getDerivedGauge в интерфейсе StringMonitorMBean
Возвращает:: Производное значение.

getDerivedGaugeTimeStamp

@Deprecated public long getDerivedGaugeTimeStamp()

Устарел.

Начиная с JMX 1.2 заменён на getDerivedGaugeTimeStamp(ObjectName)

Возвращает временную метку производного значения первого объекта в наборе наблюдаемых MBean.

Определено в:: getDerivedGaugeTimeStamp в интерфейсе StringMonitorMBean
Возвращает:: Временная метка производного значения.

getStringToCompare

public String getStringToCompare()

Возвращает строку для сравнения с наблюдаемым атрибутом, общую для всех наблюдаемых MBean.

Определено в:

getStringToCompare в интерфейсе StringMonitorMBean

Возвращает:

Строковое значение.

См. также:

setStringToCompare

public void setStringToCompare(String value) throws IllegalArgumentException

Устанавливает строку для сравнения с наблюдаемым атрибутом, общую для всех наблюдаемых MBean.

Определено в:

setStringToCompare в интерфейсе StringMonitorMBean

Параметры:

value — строковое значение.

Исключения:

IllegalArgumentException — указанная строка для сравнения равна null.

См. также:

getNotifyMatch

public boolean getNotifyMatch()

Возвращает общее для всех наблюдаемых MBean значение переключателя уведомлений о совпадении.

Определено в:

getNotifyMatch в интерфейсе StringMonitorMBean

Возвращает:

true, если строковый монитор отправляет уведомление при совпадении со строкой для сравнения, и false в противном случае.

См. также:

setNotifyMatch

public void setNotifyMatch(boolean value)

Устанавливает общее для всех наблюдаемых MBean значение переключателя уведомлений о совпадении.

Определено в:

setNotifyMatch в интерфейсе StringMonitorMBean

Параметры:

value — значение переключателя уведомлений о совпадении.

См. также:

getNotifyDiffer

public boolean getNotifyDiffer()

Возвращает общее для всех наблюдаемых MBean значение переключателя уведомлений об отличии.

Определено в:

getNotifyDiffer в интерфейсе StringMonitorMBean

Возвращает:

true, если строковый монитор отправляет уведомление при отличии от строки для сравнения, и false в противном случае.

См. также:

setNotifyDiffer

public void setNotifyDiffer(boolean value)

Устанавливает общее для всех наблюдаемых MBean значение переключателя уведомлений об отличии.

Определено в:

setNotifyDiffer в интерфейсе StringMonitorMBean

Параметры:

value — значение переключателя уведомлений об отличии.

См. также:

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

Возвращает объект NotificationInfo, содержащий имя Java-класса уведомления и типы уведомлений, отправляемых строковым монитором.

Определено в:: getNotificationInfo в интерфейсе NotificationBroadcaster
Возвращает:: массив возможных уведомлений.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.management/javax/management/monitor/StringMonitor.html