Класс 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)`	Вызывается перед отправкой указанного уведомления прослушивателю.

Методы, объявленные в классе 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 - Параметр prefix равен 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://docs.oracle.com/en/java/javase/25/docs/api/java.management/javax/management/NotificationFilterSupport.html