6311N/A * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 2362N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 2362N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2362N/A * or visit www.oracle.com if you need additional information or have any 0N/A * A notification of a change in the Relation Service. 0N/A * A RelationNotification notification is sent when a relation is created via 0N/A * the Relation Service, or an MBean is added as a relation in the Relation 0N/A * Service, or a role is updated in a relation, or a relation is removed from 0N/A * the Relation Service. 0N/A * <p>The <b>serialVersionUID</b> of this class is <code>-6871117877523310399L</code>. 0N/A // Serialization compatibility stuff: 0N/A // Two serial forms are supported in this class. The selected form depends 0N/A // on system property "jmx.serial.form": 0N/A // - "1.0" for JMX 1.0 0N/A // - any other value for JMX 1.1 and higher 0N/A // Serial version for old serial form 0N/A // Serial version for new serial form 0N/A // Serializable fields in old serial form 0N/A // Serializable fields in new serial form 0N/A // Actual serial version and serial form 0N/A * @serialField relationId String Relation identifier of 0N/A * @serialField relationTypeName String Relation type name of 0N/A * @serialField relationObjName ObjectName {@link ObjectName} of 0N/A * the relation is represented by an MBean) 0N/A * @serialField unregisterMBeanList List List of {@link 0N/A * ObjectName}s of referenced MBeans to be unregistered due to 0N/A * @serialField roleName String Name of updated role (only for role update) 0N/A * @serialField oldRoleValue List Old role value ({@link 0N/A * ArrayList} of {@link ObjectName}s) (only for role update) 0N/A * @serialField newRoleValue List New role value ({@link 0N/A * ArrayList} of {@link ObjectName}s) (only for role update) 0N/A // OK : Too bad, no compat with 1.0 0N/A // END Serialization compatibility stuff 0N/A // Notification types 0N/A * Type for the creation of an internal relation. 0N/A * Type for the relation MBean added into the Relation Service. 0N/A * Type for an update of an internal relation. 0N/A * Type for the update of a relation MBean. 0N/A * Type for the removal from the Relation Service of an internal relation. 0N/A * Type for the removal from the Relation Service of a relation MBean. 0N/A * (only if the relation is represented by an MBean) 0N/A * @serial List of {@link ObjectName}s of referenced MBeans to be unregistered due to 0N/A * @serial Name of updated role (only for role update) 0N/A * @serial Old role value ({@link ArrayList} of {@link ObjectName}s) (only for role update) 0N/A * @serial New role value ({@link ArrayList} of {@link ObjectName}s) (only for role update) 0N/A * Creates a notification for either a relation creation (RelationSupport 0N/A * object created internally in the Relation Service, or an MBean added as a 0N/A * relation) or for a relation removal from the Relation Service. 0N/A * @param notifType type of the notification; either: 0N/A * <P>- RELATION_BASIC_CREATION 0N/A * <P>- RELATION_MBEAN_CREATION 0N/A * <P>- RELATION_BASIC_REMOVAL 0N/A * <P>- RELATION_MBEAN_REMOVAL 0N/A * @param sourceObj source object, sending the notification. This is either 0N/A * an ObjectName or a RelationService object. In the latter case it must be 0N/A * the MBean emitting the notification; the MBean Server will rewrite the 0N/A * source to be the ObjectName under which that MBean is registered. 0N/A * @param sequence sequence number to identify the notification 0N/A * @param timeStamp time stamp 0N/A * @param message human-readable message describing the notification 0N/A * @param id relation id identifying the relation in the Relation 0N/A * @param typeName name of the relation type 0N/A * @param objectName ObjectName of the relation object if it is an MBean 0N/A * (null for relations internally handled by the Relation Service) 0N/A * @param unregMBeanList list of ObjectNames of referenced MBeans 0N/A * expected to be unregistered due to relation removal (only for removal, 0N/A * due to CIM qualifiers, can be null) 0N/A * @exception IllegalArgumentException if: 0N/A * <P>- no value for the notification type 0N/A * <P>- the notification type is not RELATION_BASIC_CREATION, 0N/A * RELATION_MBEAN_CREATION, RELATION_BASIC_REMOVAL or 0N/A * RELATION_MBEAN_REMOVAL 0N/A * <P>- no source object 0N/A * <P>- the source object is not a Relation Service 0N/A * <P>- no relation id 0N/A * <P>- no relation type name 0N/A * Creates a notification for a role update in a relation. 0N/A * @param notifType type of the notification; either: 0N/A * <P>- RELATION_BASIC_UPDATE 0N/A * <P>- RELATION_MBEAN_UPDATE 0N/A * @param sourceObj source object, sending the notification. This is either 0N/A * an ObjectName or a RelationService object. In the latter case it must be 0N/A * the MBean emitting the notification; the MBean Server will rewrite the 0N/A * source to be the ObjectName under which that MBean is registered. 0N/A * @param sequence sequence number to identify the notification 0N/A * @param timeStamp time stamp 0N/A * @param message human-readable message describing the notification 0N/A * @param id relation id identifying the relation in the Relation 0N/A * @param typeName name of the relation type 0N/A * @param objectName ObjectName of the relation object if it is an MBean 0N/A * (null for relations internally handled by the Relation Service) 0N/A * @param name name of the updated role 0N/A * @param newValue new role value (List of ObjectName objects) 0N/A * @param oldValue old role value (List of ObjectName objects) 0N/A * @exception IllegalArgumentException if null parameter 0N/A * @return the relation id. 0N/A * @return the relation type name. 0N/A * Returns the ObjectName of the 0N/A * @return the ObjectName if the relation is an MBean, otherwise null. 0N/A * Returns the list of ObjectNames of MBeans expected to be unregistered 0N/A * due to a relation removal (only for relation removal). 0N/A * @return a {@link List} of {@link ObjectName}. 0N/A * Returns name of updated role of updated relation (only for role update). 0N/A * @return the name of the updated role. 0N/A * Returns old value of updated role (only for role update). 0N/A * @return the old value of the updated role. 0N/A * Returns new value of updated role (only for role update). 0N/A * @return the new value of the updated role. 0N/A // Initializes members 0N/A // -param notifType type of the notification; either: 0N/A // - RELATION_BASIC_UPDATE 0N/A // - RELATION_MBEAN_UPDATE 0N/A // for an update, or: 0N/A // - RELATION_BASIC_CREATION 0N/A // - RELATION_MBEAN_CREATION 0N/A // - RELATION_BASIC_REMOVAL 0N/A // - RELATION_MBEAN_REMOVAL 0N/A // for a creation or removal 0N/A // -param sourceObj source object, sending the notification. Will always 0N/A // be a RelationService object. 0N/A // -param sequence sequence number to identify the notification 0N/A // -param timeStamp time stamp 0N/A // -param message human-readable message describing the notification 0N/A // -param id relation id identifying the relation in the Relation 0N/A // -param typeName name of the relation type 0N/A // -param objectName ObjectName of the relation object if it is an MBean 0N/A // (null for relations internally handled by the Relation Service) 0N/A // -param unregMBeanList list of ObjectNames of MBeans expected to be 0N/A // removed due to relation removal 0N/A // -param name name of the updated role 0N/A // -param newValue new value (List of ObjectName objects) 0N/A // -param oldValue old value (List of ObjectName objects) 0N/A // -exception IllegalArgumentException if: 0N/A // - no value for the notification type 0N/A // - incorrect notification type 0N/A // - no source object 0N/A // - the source object is not a Relation Service 0N/A // - no relation type name 0N/A // - no role name (for role update) 0N/A // - no role old value (for role update) 0N/A // - no role new value (for role update) 6311N/A // NPE thrown if we attempt to add null object 0N/A * Deserializes a {@link RelationNotification} from an {@link ObjectInputStream}. 6311N/A // Validate fields we just read, throw InvalidObjectException 6311N/A // assign deserialized vaules to object fields 0N/A * Serializes a {@link RelationNotification} to an {@link ObjectOutputStream}. 0N/A // Serializes this instance in the old serial form 0N/A // Serializes this instance in the new serial form