Класс NotificationFilterSupport

java.lang.Object

javax.management.NotificationFilterSupport

Все реализованные интерфейсы:: Serializable, NotificationFilter

Непосредственные известные подклассы:: MBeanServerNotificationFilter

public class NotificationFilterSupport extends Object implements NotificationFilter

Реализует интерфейс NotificationFilter. Фильтрация выполняется по атрибуту типа уведомления.

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

Перед отправкой уведомления слушателю, зарегистрированному с фильтром, рассылка уведомлений сравнивает тип этого уведомления со всеми типами уведомлений, включенными в фильтр. Уведомление будет отправлено слушателю только в том случае, если его фильтр включает этот тип уведомления.

Пример:

 NotificationFilterSupport myFilter = new NotificationFilterSupport();
 myFilter.enableType("my_example.my_type");
 myBroadcaster.addListener(myListener, myFilter, null);

Слушатель myListener будет получать только уведомления, тип которых равен/начинается с "my_example.my_type".

С момента:

1.5

См. также:

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

Конструктор	Описание
`NotificationFilterSupport()`	Создает `NotificationFilterSupport`.

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

Модификатор и тип	Метод	Описание
`void`	`disableAllTypes()`	Отключает все типы уведомлений.
`void`	`disableType(String prefix)`	Удаляет указанный префикс из списка префиксов.
`void`	`enableType(String prefix)`	Включает все уведомления, тип которых начинается с указанного префикса, для отправки слушателю.
`Vector<String>`	`getEnabledTypes()`	Получает все включенные типы уведомлений для данного фильтра.
`boolean`	`isNotificationEnabled(Notification notification)`	Вызывается перед отправкой указанного уведомления слушателю.

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

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

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

NotificationFilterSupport

public NotificationFilterSupport()

Создает NotificationFilterSupport.

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

isNotificationEnabled

public boolean isNotificationEnabled(Notification notification)

Вызывается перед отправкой указанного уведомления слушателю.
Этот фильтр сравнивает тип указанного уведомления с каждым включенным типом. Если тип уведомления совпадает с одним из включенных типов, уведомление должно быть отправлено слушателю, и этот метод возвращает true.

Определено в:: isNotificationEnabled в интерфейсе NotificationFilter
Параметры:: notification - Уведомление, которое должно быть отправлено.
Возвращает:: true, если уведомление должно быть отправлено слушателю, false в противном случае.

enableType

public void enableType(String prefix) throws IllegalArgumentException

Включает все уведомления, тип которых начинается с указанного префикса, для отправки слушателю.
Если указанный префикс уже находится в списке включенных типов уведомлений, этот метод не имеет эффекта.

Пример:

 // Enables all notifications the type of which starts with "my_example" to be sent.
 myFilter.enableType("my_example");
 // Enables all notifications the type of which is "my_example.my_type" to be sent.
 myFilter.enableType("my_example.my_type");

Обратите внимание, что:

myFilter.enableType("my_example.*");

не будет соответствовать ни одному типу уведомления.

Параметры:: prefix - Префикс.
Исключения:: IllegalArgumentException - Параметр префикса имеет значение null.

disableType

public void disableType(String prefix)

Удаляет указанный префикс из списка префиксов.
Если указанный префикс не находится в списке включенных типов уведомлений, этот метод не имеет эффекта.

Параметры:: prefix - Префикс.

disableAllTypes

public void disableAllTypes()

Отключает все типы уведомлений.

getEnabledTypes

public Vector<String> getEnabledTypes()

Получает все включенные типы уведомлений для данного фильтра.

Возвращает:: Список, содержащий все включенные типы уведомлений.

© 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://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/NotificationFilterSupport.html