ResourceAdaptorEntityStateChangeNotification.java

package javax.slee.management;

import java.io.ObjectOutputStream;
import java.io.IOException;
import java.io.ObjectInputStream;
import javax.management.Notification;

/**
 * This notification is emitted by a {@link ResourceManagementMBean} object to
 * indicate a change in the operational state of a resource adaptor entity.
 * <p>
 * The notification type of resource adaptor entity state change notifications is
 * specified by the {@link ResourceManagementMBean#RESOURCE_ADAPTOR_ENTITY_STATE_CHANGE_NOTIFICATION_TYPE}
 * attribute.
 * @since SLEE 1.1
 */
public final class ResourceAdaptorEntityStateChangeNotification extends Notification implements VendorExtensions {
    /**
     * Create a <code>ResourceAdaptorEntityStateChangeNotification</code> to notify
     * listeners of a change in the operational state of a resource adaptor entity.
     * Notifications are broadcast <i>after</i> the resource adaptor entity has
     * changed to the new state.
     * @param resourceManagementMBean the <code>ResourceManagementMBean</code> object
     *        that is emitting this notification.
     * @param entityName the name of the resource adaptor entity that has changed state.
     * @param newState the new operational state of the resource adaptor entity.
     * @param oldState the old operational state of the resource adaptor entity.
     * @param sequenceNumber the notification sequence number within the source
     *        <code>ResourceManagementMBean</code> object.
     * @throws NullPointerException if <code>notificationSource</code>, <code>entityName</code>,
     *        <code>newState</code>, or <code>oldState</code> is <code>null</code>.
     */
    public ResourceAdaptorEntityStateChangeNotification(ResourceManagementMBean resourceManagementMBean, String entityName, ResourceAdaptorEntityState newState, ResourceAdaptorEntityState oldState, long sequenceNumber) throws NullPointerException {
        super(ResourceManagementMBean.RESOURCE_ADAPTOR_ENTITY_STATE_CHANGE_NOTIFICATION_TYPE, resourceManagementMBean, sequenceNumber, System.currentTimeMillis(),
            "Resource adaptor entity " + entityName + " state changed from " + oldState + " to " + newState
        );

        if (resourceManagementMBean == null) throw new NullPointerException("resourceManagementMBean is null");
        if (entityName == null) throw new NullPointerException("entityName is null");
        if (newState == null) throw new NullPointerException("newState is null");
        if (oldState == null) throw new NullPointerException("oldState is null");

        this.entityName = entityName;
        this.newState = newState;
        this.oldState = oldState;
    }

    /**
     * Get the name of the resource adaptor entity that has changed state.
     * @return the resource adaptor entity name.
     */
    public String getEntityName() {
        return entityName;
    }

    /**
     * Get the new operational state of the resource adaptor entity.
     * @return the new state.
     */
    public ResourceAdaptorEntityState getNewState() {
        return newState;
    }

    /**
     * Get the state the resource adaptor entity was in before the change to the new state.
     * @return the old state.
     */
    public ResourceAdaptorEntityState getOldState() {
        return oldState;
    }

    /**
     * Enable the serialization of vendor-specific data for objects of this class.
     * This method is typically used by a SLEE implementation that wants to export
     * vendor-specific data with objects of this class to management clients.
     * <p>
     * By default, any vendor-specific data included in an object of this class will
     * not be included in the serialization stream when the object is serialized.
     * Invoking this method changes this behavior so that vendor-specific data is
     * included in the serialization stream when an object of this class is serialized.
     * <p>
     * This method should only be invoked if the vendor-specific data is serializable
     * via standard Java serialization means.
     * @see #disableVendorDataSerialization
     * @see #setVendorData
     */
    public static void enableVendorDataSerialization() {
        vendorDataSerializationEnabled = true;
    }

    /**
     * Disable the serialization of vendor-specific data for objects of this class.
     * <p>
     * If the serialization of vendor-specific data for objects of this class has
     * been enabled via the {@link #enableVendorDataSerialization} method, this
     * method disables that behavior again.
     */
    public static void disableVendorDataSerialization() {
        vendorDataSerializationEnabled = false;
    }

    /**
     * Enable the deserialization of vendor-specific data for objects of this class.
     * This method is typically used by a management client that wants to obtain any
     * vendor-specific data included in the serialization stream of objects of this
     * class.
     * <p>
     * By default, any vendor-specific data included in the serialization stream of
     * objects of this class is discarded upon deserialization.  Invoking this method
     * changes that behavior so that the vendor-specific data is also deserialized
     * when an object of this class is deserialized.  A management client that enables
     * the deserialization of vendor-specific data must ensure that any necessary
     * classes required to deserialize that data is available in the relevant
     * classloader.
     * @see #disableVendorDataDeserialization
     * @see #getVendorData
     */
    public static void enableVendorDataDeserialization() {
        vendorDataDeserializationEnabled = true;
    }

    /**
     * Disable the deserialization of vendor-specific data for objects of this class.
     * <p>
     * If the deserialization of vendor-specific data for objects of this class has
     * been enabled via the {@link #enableVendorDataDeserialization} method, this
     * method disables that behavior again.
     */
    public static void disableVendorDataDeserialization() {
        vendorDataDeserializationEnabled = false;
    }

    /**
     * Set the vendor-specific data.
     * @param vendorData the vendor-specific data.
     */
    public void setVendorData(Object vendorData) {
        this.vendorData = vendorData;
    }

    /**
     * Get the vendor-specific data.
     * @return the vendor-specific data.
     */
    public Object getVendorData() {
        return vendorData;
    }

    /**
     * Get a string representation for this notification.
     * @return a string representation for this notification.
     */
    public String toString() {
        StringBuffer buf = new StringBuffer();
        buf.append("ResourceAdaptorEntityStateChangeNotification[timestamp=")
            .append(getTimeStamp())
            .append(",entity name=")
            .append(entityName)
            .append(",old state=")
            .append(oldState)
            .append(",new state=")
            .append(newState);
        if (vendorData != null) buf.append(",vendor data=").append(vendorData);
        buf.append("]");
        return buf.toString();
    }


    // special handling of serialization
    private void writeObject(ObjectOutputStream out) throws IOException {
        VendorExtensionUtils.writeObject(out, vendorDataSerializationEnabled ? vendorData : null);
    }

    // special handling of deserialization
    private void readObject(ObjectInputStream in) throws IOException, ClassNotFoundException {
        vendorData = VendorExtensionUtils.readObject(in, vendorDataDeserializationEnabled);
    }


    private final String entityName;
    private final ResourceAdaptorEntityState newState;
    private final ResourceAdaptorEntityState oldState;

    private static volatile boolean vendorDataSerializationEnabled = false;
    private static volatile boolean vendorDataDeserializationEnabled = false;
    private transient Object vendorData;
}