diff -r 4ebc2e2fb97c -r 71c04702a3d5 src/java.management/share/classes/javax/management/AttributeChangeNotification.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/java.management/share/classes/javax/management/AttributeChangeNotification.java Tue Sep 12 19:03:39 2017 +0200 @@ -0,0 +1,146 @@ +/* + * Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +package javax.management; + + + +/** + * Provides definitions of the attribute change notifications sent by MBeans. + *
+ * It's up to the MBean owning the attribute of interest to create and send
+ * attribute change notifications when the attribute change occurs.
+ * So the NotificationBroadcaster
interface has to be implemented
+ * by any MBean for which an attribute change is of interest.
+ *
+ * Example:
+ * If an MBean called myMbean
needs to notify registered listeners
+ * when its attribute:
+ *
+ * String myString
+ *
+ * is modified, myMbean
creates and emits the following notification:
+ *
+ * new AttributeChangeNotification(myMbean, sequenceNumber, timeStamp, msg,
+ * "myString", "String", oldValue, newValue);
+ *
+ *
+ * @since 1.5
+ */
+public class AttributeChangeNotification extends javax.management.Notification {
+
+ /* Serial version */
+ private static final long serialVersionUID = 535176054565814134L;
+
+ /**
+ * Notification type which indicates that the observed MBean attribute value has changed.
+ * jmx.attribute.change
.
+ */
+ public static final String ATTRIBUTE_CHANGE = "jmx.attribute.change";
+
+
+ /**
+ * @serial The MBean attribute name.
+ */
+ private String attributeName = null;
+
+ /**
+ * @serial The MBean attribute type.
+ */
+ private String attributeType = null;
+
+ /**
+ * @serial The MBean attribute old value.
+ */
+ private Object oldValue = null;
+
+ /**
+ * @serial The MBean attribute new value.
+ */
+ private Object newValue = null;
+
+
+ /**
+ * Constructs an attribute change notification object.
+ * In addition to the information common to all notification, the caller must supply the name and type
+ * of the attribute, as well as its old and new values.
+ *
+ * @param source The notification producer, that is, the MBean the attribute belongs to.
+ * @param sequenceNumber The notification sequence number within the source object.
+ * @param timeStamp The date at which the notification is being sent.
+ * @param msg A String containing the message of the notification.
+ * @param attributeName A String giving the name of the attribute.
+ * @param attributeType A String containing the type of the attribute.
+ * @param oldValue An object representing value of the attribute before the change.
+ * @param newValue An object representing value of the attribute after the change.
+ */
+ public AttributeChangeNotification(Object source, long sequenceNumber, long timeStamp, String msg,
+ String attributeName, String attributeType, Object oldValue, Object newValue) {
+
+ super(AttributeChangeNotification.ATTRIBUTE_CHANGE, source, sequenceNumber, timeStamp, msg);
+ this.attributeName = attributeName;
+ this.attributeType = attributeType;
+ this.oldValue = oldValue;
+ this.newValue = newValue;
+ }
+
+
+ /**
+ * Gets the name of the attribute which has changed.
+ *
+ * @return A String containing the name of the attribute.
+ */
+ public String getAttributeName() {
+ return attributeName;
+ }
+
+ /**
+ * Gets the type of the attribute which has changed.
+ *
+ * @return A String containing the type of the attribute.
+ */
+ public String getAttributeType() {
+ return attributeType;
+ }
+
+ /**
+ * Gets the old value of the attribute which has changed.
+ *
+ * @return An Object containing the old value of the attribute.
+ */
+ public Object getOldValue() {
+ return oldValue;
+ }
+
+ /**
+ * Gets the new value of the attribute which has changed.
+ *
+ * @return An Object containing the new value of the attribute.
+ */
+ public Object getNewValue() {
+ return newValue;
+ }
+
+}