1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
/* * @(#)AttributeChangeNotificationFilter.java 4.28 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package javax.management; // java import import java.util.Enumeration; import java.util.Vector; /** * This class implements of the {@link javax.management.NotificationFilter NotificationFilter} * interface for the {@link javax.management.AttributeChangeNotification attribute change notification}. * The filtering is performed on the name of the observed attribute. * <P> * It manages a list of enabled attribute names. * A method allows users to enable/disable as many attribute names as required. * * @since 1.5 */ public class AttributeChangeNotificationFilter implements NotificationFilter { /* Serial version */ private static final long serialVersionUID = -6347317584796410029L; /** * @serial {@link Vector} that contains the enabled attribute names. * The default value is an empty vector. */ private Vector<String> enabledAttributes = new Vector<String>(); /** * Invoked before sending the specified notification to the listener. * <BR>This filter compares the attribute name of the specified attribute change notification * with each enabled attribute name. * If the attribute name equals one of the enabled attribute names, * the notification must be sent to the listener and this method returns <CODE>true</CODE>. * * @param notification The attribute change notification to be sent. * @return <CODE>true</CODE> if the notification has to be sent to the listener, <CODE>false</CODE> otherwise. */ public synchronized boolean isNotificationEnabled(Notification notification) { String type = notification.getType(); if ((type == null) || (type.equals(AttributeChangeNotification.ATTRIBUTE_CHANGE) == false) || (!(notification instanceof AttributeChangeNotification))) { return false; } String attributeName = ((AttributeChangeNotification)notification).getAttributeName(); return enabledAttributes.contains(attributeName); } /** * Enables all the attribute change notifications the attribute name of which equals * the specified name to be sent to the listener. * <BR>If the specified name is already in the list of enabled attribute names, * this method has no effect. * * @param name The attribute name. * @exception java.lang.IllegalArgumentException The attribute name parameter is null. */ public synchronized void enableAttribute(String name) throws java.lang.IllegalArgumentException { if (name == null) { throw new java.lang.IllegalArgumentException("The name cannot be null."); } if (!enabledAttributes.contains(name)) { enabledAttributes.addElement(name); } } /** * Disables all the attribute change notifications the attribute name of which equals * the specified attribute name to be sent to the listener. * <BR>If the specified name is not in the list of enabled attribute names, * this method has no effect. * * @param name The attribute name. */ public synchronized void disableAttribute(String name) { enabledAttributes.removeElement(name); } /** * Disables all the attribute names. */ public synchronized void disableAllAttributes() { enabledAttributes.removeAllElements(); } /** * Gets all the enabled attribute names for this filter. * * @return The list containing all the enabled attribute names. */ public synchronized Vector<String> getEnabledAttributes() { return enabledAttributes; } }