Package Summary  Overview Summary

class:RelationNotification [NONE]
All Implemented Interfaces:
Serializable 
public class RelationNotification
extends Notification
A notification of a change in the Relation Service. A RelationNotification notification is sent when a relation is created via the Relation Service, or an MBean is added as a relation in the Relation Service, or a role is updated in a relation, or a relation is removed from the Relation Service.

The serialVersionUID of this class is -6871117877523310399L.

Since:
1.5
See Also:
Serialized Form

field:RELATION_BASIC_CREATION [NONE]

  • RELATION_BASIC_CREATION

    public static final  String RELATION_BASIC_CREATION
    Type for the creation of an internal relation.
    See Also:
    Constant Field Values

    • field:RELATION_MBEAN_CREATION [NONE]

    RELATION_MBEAN_CREATION

    public static final  String RELATION_MBEAN_CREATION
    Type for the relation MBean added into the Relation Service.
    See Also:
    Constant Field Values

    field:RELATION_BASIC_UPDATE [NONE]

    RELATION_BASIC_UPDATE

    public static final  String RELATION_BASIC_UPDATE
    Type for an update of an internal relation.
    See Also:
    Constant Field Values

    field:RELATION_MBEAN_UPDATE [NONE]

    RELATION_MBEAN_UPDATE

    public static final  String RELATION_MBEAN_UPDATE
    Type for the update of a relation MBean.
    See Also:
    Constant Field Values

    field:RELATION_BASIC_REMOVAL [NONE]

    RELATION_BASIC_REMOVAL

    public static final  String RELATION_BASIC_REMOVAL
    Type for the removal from the Relation Service of an internal relation.
    See Also:
    Constant Field Values

    field:RELATION_MBEAN_REMOVAL [NONE]

    RELATION_MBEAN_REMOVAL

    public static final  String RELATION_MBEAN_REMOVAL
    Type for the removal from the Relation Service of a relation MBean.
    See Also:
    Constant Field Values

    constructor:RelationNotification(java.lang.String,java.lang.Object,long,long,java.lang.String,java.lang.String,java.lang.String,javax.management.ObjectName,java.util.List) [NONE]

  • RelationNotification

    public RelationNotification?(String notifType, Object sourceObj, long sequence, long timeStamp, String message, String id, String typeName, ObjectName objectName, List<ObjectName> unregMBeanList) throws IllegalArgumentException
    Creates a notification for either a relation creation (RelationSupport object created internally in the Relation Service, or an MBean added as a relation) or for a relation removal from the Relation Service.
    Parameters:
    notifType - type of the notification; either:

    - RELATION_BASIC_CREATION

    - RELATION_MBEAN_CREATION

    - RELATION_BASIC_REMOVAL

    - RELATION_MBEAN_REMOVAL

    sourceObj - source object, sending the notification. This is either an ObjectName or a RelationService object. In the latter case it must be the MBean emitting the notification; the MBean Server will rewrite the source to be the ObjectName under which that MBean is registered.
    sequence - sequence number to identify the notification
    timeStamp - time stamp
    message - human-readable message describing the notification
    id - relation id identifying the relation in the Relation Service
    typeName - name of the relation type
    objectName - ObjectName of the relation object if it is an MBean (null for relations internally handled by the Relation Service)
    unregMBeanList - list of ObjectNames of referenced MBeans expected to be unregistered due to relation removal (only for removal, due to CIM qualifiers, can be null)
    Throws:
    IllegalArgumentException - if:

    - no value for the notification type

    - the notification type is not RELATION_BASIC_CREATION, RELATION_MBEAN_CREATION, RELATION_BASIC_REMOVAL or RELATION_MBEAN_REMOVAL

    - no source object

    - the source object is not a Relation Service

    - no relation id

    - no relation type name

    • constructor:RelationNotification(java.lang.String,java.lang.Object,long,long,java.lang.String,java.lang.String,java.lang.String,javax.management.ObjectName,java.lang.String,java.util.List,java.util.List) [NONE]

    RelationNotification

    public RelationNotification?(String notifType, Object sourceObj, long sequence, long timeStamp, String message, String id, String typeName, ObjectName objectName, String name, List<ObjectName> newValue, List<ObjectName> oldValue) throws IllegalArgumentException
    Creates a notification for a role update in a relation.
    Parameters:
    notifType - type of the notification; either:

    - RELATION_BASIC_UPDATE

    - RELATION_MBEAN_UPDATE

    sourceObj - source object, sending the notification. This is either an ObjectName or a RelationService object. In the latter case it must be the MBean emitting the notification; the MBean Server will rewrite the source to be the ObjectName under which that MBean is registered.
    sequence - sequence number to identify the notification
    timeStamp - time stamp
    message - human-readable message describing the notification
    id - relation id identifying the relation in the Relation Service
    typeName - name of the relation type
    objectName - ObjectName of the relation object if it is an MBean (null for relations internally handled by the Relation Service)
    name - name of the updated role
    newValue - new role value (List of ObjectName objects)
    oldValue - old role value (List of ObjectName objects)
    Throws:
    IllegalArgumentException - if null parameter

    method:getRelationId() [NONE]

  • getRelationId

    public String getRelationId()
    Returns the relation identifier of created/removed/updated relation.
    Returns:
    the relation id.

    • method:getRelationTypeName() [NONE]

    getRelationTypeName

    public String getRelationTypeName()
    Returns the relation type name of created/removed/updated relation.
    Returns:
    the relation type name.

    method:getObjectName() [NONE]

    getObjectName

    public ObjectName getObjectName()
    Returns the ObjectName of the created/removed/updated relation.
    Returns:
    the ObjectName if the relation is an MBean, otherwise null.

    method:getMBeansToUnregister() [NONE]

    getMBeansToUnregister

    public List<ObjectName> getMBeansToUnregister()
    Returns the list of ObjectNames of MBeans expected to be unregistered due to a relation removal (only for relation removal).
    Returns:
    a List of ObjectName.

    method:getRoleName() [NONE]

    getRoleName

    public String getRoleName()
    Returns name of updated role of updated relation (only for role update).
    Returns:
    the name of the updated role.

    method:getOldRoleValue() [NONE]

    getOldRoleValue

    public List<ObjectName> getOldRoleValue()
    Returns old value of updated role (only for role update).
    Returns:
    the old value of the updated role.

    method:getNewRoleValue() [NONE]

    getNewRoleValue

    public List<ObjectName> getNewRoleValue()
    Returns new value of updated role (only for role update).
    Returns:
    the new value of the updated role.

    © 2020 Oracle Corporation and/or its affiliates