Spec-Zone.ru › OpenJDK 21

Класс 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]) вычисляется следующим образом:

  • если (счётчик[t] - счётчик[t-GP]) положительно, то V[t] = счётчик[t] - счётчик[t-GP]
  • если (счётчик[t] - счётчик[t-GP]) отрицательно, то V[t] = счётчик[t] - счётчик[t-GP] + MODULUS
Эта реализация монитора счётчика требует, чтобы наблюдаемый атрибут был целого типа (Byte, Integer, Short, Long).
С момента:
1.5

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

Поля, объявленные в классе javax.management.monitor.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

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

Конструктор Описание
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(java.lang.Number)
void start()
Запускает монитор счётчика.
void stop()
Останавливает монитор счётчика.

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

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

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

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

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

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

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

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

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(java.lang.Number)

getInitThreshold

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

setThreshold

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

getOffset

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

setOffset

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

getModulus

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

© 1993, 2023, 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/21/docs/api/java.management/javax/management/monitor/CounterMonitor.html

Spec-Zone.ru

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