public RelationNotification(String notifType,
    Object sourceObj,
    long sequence,
    long timeStamp,
    String message,
    String id,
    String typeName,
    ObjectName objectName,
    List<ObjectName> unregMBeanList) throws IllegalArgumentException 
{
        super(notifType, sourceObj, sequence, timeStamp, message);
        // Can throw IllegalArgumentException
        initMembers(1,
                    notifType,
                    sourceObj,
                    sequence,
                    timeStamp,
                    message,
                    id,
                    typeName,
                    objectName,
                    unregMBeanList,
                    null,
                    null,
                    null);
        return;
}

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


exception: 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

 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 
{
        super(notifType, sourceObj, sequence, timeStamp, message);
        // Can throw IllegalArgumentException
        initMembers(2,
                    notifType,
                    sourceObj,
                    sequence,
                    timeStamp,
                    message,
                    id,
                    typeName,
                    objectName,
                    null,
                    name,
                    newValue,
                    oldValue);
        return;
}

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

exception: IllegalArgumentException - if null parameter

 public List<ObjectName> getMBeansToUnregister() 
{
        List< ObjectName > result;
        if (unregisterMBeanList != null) {
            result = new ArrayList< ObjectName >(unregisterMBeanList);
        } else {
            result = Collections.emptyList();
        }
        return result;
}

Returns the list of ObjectNames of MBeans expected to be unregistered due to a relation removal (only for relation removal).

 public List<ObjectName> getNewRoleValue() 
{
        List< ObjectName > result;
        if (newRoleValue != null) {
            result = new ArrayList< ObjectName >(newRoleValue);
        } else {
            result = Collections.emptyList();
        }
        return result;
}

Returns new value of updated role (only for role update).

 public ObjectName getObjectName() 
{
        return relationObjName;
}

Returns the ObjectName of the created/removed/updated relation.

 public List<ObjectName> getOldRoleValue() 
{
        List< ObjectName > result;
        if (oldRoleValue != null) {
            result = new ArrayList< ObjectName >(oldRoleValue);
        } else {
            result = Collections.emptyList();
        }
        return result;
}

Returns old value of updated role (only for role update).

 public String getRelationId() 
{
        return relationId;
}

Returns the relation identifier of created/removed/updated relation.

 public String getRelationTypeName() 
{
        return relationTypeName;
}

Returns the relation type name of created/removed/updated relation.

 public String getRoleName() 
{
        String result = null;
        if (roleName != null) {
            result = roleName;
        }
        return result;
}

Returns name of updated role of updated relation (only for role update).