Spec-Zone.ru › OpenJDK 27

Класс CounterMonitor

java.lang.Object
javax.management.NotificationBroadcasterSupport
javax.management.monitor.Monitor
javax.management.monitor.CounterMonitor
Все реализуемые интерфейсы:
MBeanRegistration, CounterMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter
public class CounterMonitor extends Monitor implements CounterMonitorMBean
Определяет MBean-монитор, предназначенный для наблюдения за значениями атрибута-счетчика.

Монитор-счетчик отправляет threshold notification, когда значение счетчика достигает или превышает порог, называемый уровнем сравнения. Флаг уведомления должен иметь значение true.

Кроме того, механизм смещения позволяет обнаруживать определенные интервалы счета. Если значение смещения не равно нулю, каждый раз при срабатывании порога из-за того, что значение счетчика достигает уровня сравнения, этот уровень сравнения увеличивается на значение смещения. Считается, что это происходит мгновенно, то есть до увеличения счетчика. Таким образом, для каждого уровня порог вызывает уведомление о событии всякий раз, когда счетчик увеличивается на интервал, равный значению смещения.

Если счетчик может перейти через максимальное значение и обнулиться, необходимо указать модуль. Модуль — это значение, при достижении которого счетчик сбрасывается в ноль.

Если используется режим разности счетчика, значение производного показателя вычисляется как разность между наблюдаемыми значениями счетчика при двух последовательных наблюдениях. Если эта разность отрицательна, значение производного показателя увеличивается на значение модуля. Значение производного показателя (V[t]) вычисляется следующим образом:

  • если (counter[t] - counter[t-GP]) положительно, то V[t] = counter[t] - counter[t-GP]
  • если (counter[t] - counter[t-GP]) отрицательно, то V[t] = counter[t] - counter[t-GP] + MODULUS
В этой реализации монитора-счетчика тип наблюдаемого атрибута должен быть целочисленным (Byte, Integer, Short, Long).
С момента версии:
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.

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

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

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

Модификатор и тип Метод Описание
Number getDerivedGauge()
Устарело.
Начиная с JMX 1.2 заменен на getDerivedGauge(ObjectName)
Number getDerivedGauge(ObjectName object)
Возвращает производный показатель указанного объекта, если этот объект входит в набор наблюдаемых MBean, или null в противном случае.
long getDerivedGaugeTimeStamp()
Устарело.
Начиная с JMX 1.2 заменен на getDerivedGaugeTimeStamp(ObjectName)
long getDerivedGaugeTimeStamp(ObjectName object)
Возвращает временную метку производного показателя указанного объекта, если этот объект входит в набор наблюдаемых MBean, или 0 в противном случае.
boolean getDifferenceMode()
Возвращает значение флага режима разности, общее для всех наблюдаемых MBean.
Number getInitThreshold()
Возвращает начальное значение порога, общее для всех наблюдаемых объектов.
Number getModulus()
Возвращает значение модуля, общее для всех наблюдаемых MBean.
MBeanNotificationInfo[] getNotificationInfo()
Возвращает объект NotificationInfo, содержащий имя Java-класса уведомления и типы уведомлений, отправляемых монитором-счетчиком.
boolean getNotify()
Возвращает общее для всех наблюдаемых MBean значение переключателя отправки уведомлений.
Number getOffset()
Возвращает значение смещения, общее для всех наблюдаемых MBean.
Number getThreshold()
Устарело.
Начиная с JMX 1.2 заменен на getThreshold(ObjectName)
Number getThreshold(ObjectName object)
Возвращает текущее значение порога указанного объекта, если этот объект входит в набор наблюдаемых MBean, или null в противном случае.
void setDifferenceMode(boolean value)
Задает значение флага режима разности, общее для всех наблюдаемых MBean.
void setInitThreshold(Number value)
Задает начальное значение порога, общее для всех наблюдаемых объектов.
void setModulus(Number value)
Задает значение модуля, общее для всех наблюдаемых MBean.
void setNotify(boolean value)
Задает общее для всех наблюдаемых MBean значение переключателя отправки уведомлений.
void setOffset(Number value)
Задает значение смещения, общее для всех наблюдаемых MBean.
void setThreshold(Number value)
Устарело.
Начиная с JMX 1.2 заменен на setInitThreshold(Number)
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()
Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

CounterMonitor

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

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

start

public void start()
Запускает монитор-счетчик.
Определен в:
start в интерфейсе MonitorMBean
Переопределяет:
start в классе Monitor

stop

public void stop()
Останавливает монитор-счетчик.
Определен в:
stop в интерфейсе MonitorMBean
Переопределяет:
stop в классе Monitor

getDerivedGauge

public Number getDerivedGauge(ObjectName object)
Возвращает производный показатель указанного объекта, если этот объект входит в набор наблюдаемых MBean, или null в противном случае.
Определен в:
getDerivedGauge в интерфейсе CounterMonitorMBean
Параметры:
object — имя объекта, производный показатель которого требуется вернуть.
Возвращает:
Производный показатель указанного объекта.

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)
Возвращает временную метку производного показателя указанного объекта, если этот объект входит в набор наблюдаемых MBean, или 0 в противном случае.
Определен в:
getDerivedGaugeTimeStamp в интерфейсе CounterMonitorMBean
Параметры:
object — имя объекта, временную метку производного показателя которого требуется вернуть.
Возвращает:
Временная метка производного показателя указанного объекта.

getThreshold

public Number getThreshold(ObjectName object)
Возвращает текущее значение порога указанного объекта, если этот объект входит в набор наблюдаемых MBean, или null в противном случае.
Определен в:
getThreshold в интерфейсе CounterMonitorMBean
Параметры:
object — имя объекта, порог которого требуется вернуть.
Возвращает:
Значение порога указанного объекта.
См. также:
  • CounterMonitorMBean.setThreshold(Number)

getInitThreshold

public Number getInitThreshold()
Возвращает начальное значение порога, общее для всех наблюдаемых объектов.
Определен в:
getInitThreshold в интерфейсе CounterMonitorMBean
Возвращает:
Начальный порог.
См. также:
  • setInitThreshold(Number)

setInitThreshold

public void setInitThreshold(Number value) throws IllegalArgumentException
Задает начальное значение порога, общее для всех наблюдаемых объектов.
Текущий порог каждого объекта в наборе наблюдаемых MBean соответственно обновляется.
Определен в:
setInitThreshold в интерфейсе CounterMonitorMBean
Параметры:
value — начальное значение порога.
Вызывает исключение:
IllegalArgumentException — указанный порог равен null или значение порога меньше нуля.
См. также:
  • getInitThreshold()

getDerivedGauge

@Deprecated public Number getDerivedGauge()
Устарело.
Начиная с JMX 1.2 заменен на getDerivedGauge(ObjectName)
Возвращает производный показатель первого объекта в наборе наблюдаемых MBean.
Определен в:
getDerivedGauge в интерфейсе CounterMonitorMBean
Возвращает:
Производный показатель.

getDerivedGaugeTimeStamp

@Deprecated public long getDerivedGaugeTimeStamp()
Устарело.
Начиная с JMX 1.2 заменен на getDerivedGaugeTimeStamp(ObjectName)
Возвращает временную метку производного показателя первого объекта в наборе наблюдаемых MBean.
Определен в:
getDerivedGaugeTimeStamp в интерфейсе CounterMonitorMBean
Возвращает:
Временная метка производного показателя.

getThreshold

@Deprecated public Number getThreshold()
Устарело.
Начиная с JMX 1.2 заменен на getThreshold(ObjectName)
Возвращает значение порога первого объекта в наборе наблюдаемых MBean.
Определен в:
getThreshold в интерфейсе CounterMonitorMBean
Возвращает:
Значение порога.
См. также:
  • setThreshold(Number)

setThreshold

@Deprecated public void setThreshold(Number value) throws IllegalArgumentException
Устарело.
Начиная с JMX 1.2 заменен на setInitThreshold(Number)
Задает начальное значение порога.
Определен в:
setThreshold в интерфейсе CounterMonitorMBean
Параметры:
value — начальное значение порога.
Вызывает исключение:
IllegalArgumentException — указанный порог равен null или значение порога меньше нуля.
См. также:
  • getThreshold()

getOffset

public Number getOffset()
Возвращает значение смещения, общее для всех наблюдаемых MBean.
Определен в:
getOffset в интерфейсе CounterMonitorMBean
Возвращает:
Значение смещения.
См. также:
  • setOffset(Number)

setOffset

public void setOffset(Number value) throws IllegalArgumentException
Задает значение смещения, общее для всех наблюдаемых MBean.
Определен в:
setOffset в интерфейсе CounterMonitorMBean
Параметры:
value — значение смещения.
Вызывает исключение:
IllegalArgumentException — указанное смещение равно null или значение смещения меньше нуля.
См. также:
  • getOffset()

getModulus

public Number getModulus()
Возвращает значение модуля, общее для всех наблюдаемых MBean.
Определен в:
getModulus в интерфейсе CounterMonitorMBean
Возвращает:
Значение модуля.
См. также:
  • setModulus(Number)

setModulus

public void setModulus(Number value) throws IllegalArgumentException
Задает значение модуля, общее для всех наблюдаемых MBean.
Определен в:
setModulus в интерфейсе CounterMonitorMBean
Параметры:
value — значение модуля.
Вызывает исключение:
IllegalArgumentException — указанный модуль равен null или значение модуля меньше нуля.
См. также:
  • getModulus()

getNotify

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

setNotify

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

getDifferenceMode

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

setDifferenceMode

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

getNotificationInfo

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

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

© 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