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. + *
The value of this type string is 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; + } + +}