Serializable
, NotificationFilter
MBeanServerNotificationFilter
public class NotificationFilterSupport extends Object implements NotificationFilter
NotificationFilter
interface.
The filtering is performed on the notification type attribute.
Manages a list of enabled notification types. A method allows users to enable/disable as many notification types as required.
Then, before sending a notification to a listener registered with a filter, the notification broadcaster compares this notification type with all notification types enabled by the filter. The notification will be sent to the listener only if its filter enables this notification type.
Example:
The listenerNotificationFilterSupport myFilter = new NotificationFilterSupport(); myFilter.enableType("my_example.my_type"); myBroadcaster.addListener(myListener, myFilter, null);
myListener
will only receive notifications the type of which equals/starts with "my_example.my_type".Constructor | Description |
---|---|
NotificationFilterSupport() |
Modifier and Type | Method | Description |
---|---|---|
void |
disableAllTypes() |
Disables all notification types.
|
void |
disableType(String prefix) |
Removes the given prefix from the prefix list.
|
void |
enableType(String prefix) |
Enables all the notifications the type of which starts with the specified prefix
to be sent to the listener.
|
Vector<String> |
getEnabledTypes() |
Gets all the enabled notification types for this filter.
|
boolean |
isNotificationEnabled(Notification notification) |
Invoked before sending the specified notification to the listener.
|
public boolean isNotificationEnabled(Notification notification)
true
.isNotificationEnabled
in interface NotificationFilter
notification
- The notification to be sent.true
if the notification should be sent to the listener, false
otherwise.public void enableType(String prefix) throws IllegalArgumentException
Example:
Note that:// 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.*");
will no match any notification type.prefix
- The prefix.IllegalArgumentException
- The prefix parameter is null.public void disableType(String prefix)
prefix
- The prefix.public void disableAllTypes()
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps