Spec-Zone.ru › OpenJDK 27

Класс StringMonitor

java.lang.Object
javax.management.NotificationBroadcasterSupport
javax.management.monitor.Monitor
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
Модификатор и тип Поле Описание
protected int alreadyNotified
Устарело.
эквивалентно Monitor.alreadyNotifieds[0].
protected int[] alreadyNotifieds
Выбранные ошибки монитора, о которых уже отправлены уведомления.
protected static final int capacityIncrement
Величина, на которую автоматически увеличивается ёмкость массивов монитора, когда их размер становится больше ёмкости.
protected String dbgTag
Устарело.
Замены нет.
protected int elementCount
Количество действительных компонентов в векторе наблюдаемых объектов.
protected static final int OBSERVED_ATTRIBUTE_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого атрибута произошло уведомление.
protected static final int OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого объекта или наблюдаемого атрибута произошло уведомление.
protected static final int OBSERVED_OBJECT_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого объекта произошло уведомление.
protected static final int RESET_FLAGS_ALREADY_NOTIFIED
Этот флаг используется для сброса атрибута монитора alreadyNotifieds.
protected static final int RUNTIME_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого объекта или наблюдаемого атрибута произошло уведомление.
protected MBeanServer server
Ссылка на сервер MBean.

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

Конструктор Описание
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
Модификатор и тип Метод Описание
void addObservedObject(ObjectName object)
Добавляет указанный объект в набор наблюдаемых MBean, если этот объект ещё не присутствует в наборе.
boolean containsObservedObject(ObjectName object)
Проверяет, входит ли указанный объект в набор наблюдаемых MBean.
long getGranularityPeriod()
Возвращает период дискретизации (в миллисекундах).
String getObservedAttribute()
Возвращает наблюдаемый атрибут.
ObjectName getObservedObject()
Устарело.
Начиная с JMX 1.2 заменён методом Monitor.getObservedObjects()
ObjectName[] getObservedObjects()
Возвращает массив, содержащий наблюдаемые объекты.
boolean isActive()
Проверяет, активен ли MBean монитора.
void postDeregister()
Позволяет MBean монитора выполнить все необходимые действия после его отмены регистрации сервером MBean.
void postRegister(Boolean registrationDone)
Позволяет MBean монитора выполнить все необходимые действия после его регистрации на сервере MBean или после сбоя регистрации.
void preDeregister()
Позволяет MBean монитора выполнить все необходимые действия до отмены его регистрации сервером MBean.
ObjectName preRegister(MBeanServer server, ObjectName name)
Позволяет MBean монитора выполнить все необходимые действия до его регистрации на сервере MBean.
void removeObservedObject(ObjectName object)
Удаляет указанный объект из набора наблюдаемых MBean.
void setGranularityPeriod(long period)
Задаёт период дискретизации (в миллисекундах).
void setObservedAttribute(String attribute)
Задаёт наблюдаемый атрибут.
void setObservedObject(ObjectName object)
Устарело.
Начиная с JMX 1.2 заменён методом Monitor.addObservedObject(ObjectName)

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

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification
Модификатор и тип Метод Описание
void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
Добавляет слушателя.
protected void handleNotification(NotificationListener listener, Notification notif, Object handback)
Этот метод вызывается методом sendNotification для каждого слушателя, чтобы отправить уведомление этому слушателю.
void removeNotificationListener(NotificationListener listener)
Удаляет слушателя из этого MBean.
void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
Удаляет слушателя из этого MBean.
void sendNotification(Notification notification)
Отправляет уведомление.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создаёт и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли другой объект этому объекту.
protected void finalize()
Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии.
Финализация устарела и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

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(String)

setStringToCompare

public void setStringToCompare(String value) throws IllegalArgumentException
Задаёт строку для сравнения с наблюдаемым атрибутом, общую для всех наблюдаемых MBean.
Определён в:
setStringToCompare в интерфейсе StringMonitorMBean
Параметры:
value — строковое значение.
Исключения:
IllegalArgumentException — указанная строка для сравнения равна null.
См. также:
  • getStringToCompare()

getNotifyMatch

public boolean getNotifyMatch()
Возвращает общее для всех наблюдаемых MBean значение переключателя уведомления о совпадении.
Определён в:
getNotifyMatch в интерфейсе StringMonitorMBean
Возвращает:
true, если строковый монитор отправляет уведомление при совпадении со строкой для сравнения, и false в противном случае.
См. также:
  • setNotifyMatch(boolean)

setNotifyMatch

public void setNotifyMatch(boolean value)
Задаёт общее для всех наблюдаемых MBean значение переключателя уведомления о совпадении.
Определён в:
setNotifyMatch в интерфейсе StringMonitorMBean
Параметры:
value — значение переключателя уведомления о совпадении.
См. также:
  • getNotifyMatch()

getNotifyDiffer

public boolean getNotifyDiffer()
Возвращает общее для всех наблюдаемых MBean значение переключателя уведомления об отличии.
Определён в:
getNotifyDiffer в интерфейсе StringMonitorMBean
Возвращает:
true, если строковый монитор отправляет уведомление при отличии от строки для сравнения, и false в противном случае.
См. также:
  • setNotifyDiffer(boolean)

setNotifyDiffer

public void setNotifyDiffer(boolean value)
Задаёт общее для всех наблюдаемых MBean значение переключателя уведомления об отличии.
Определён в:
setNotifyDiffer в интерфейсе StringMonitorMBean
Параметры:
value — значение переключателя уведомления об отличии.
См. также:
  • getNotifyDiffer()

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()
Возвращает объект NotificationInfo, содержащий имя Java-класса уведомления и типы уведомлений, отправляемых строковым монитором.
Определён в:
getNotificationInfo в интерфейсе NotificationBroadcaster
Возвращает:
массив возможных уведомлений.

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API