javax.slee.management.SleeStateChangeNotification Maven / Gradle / Ivy
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 SleeManagementMBean} object to
* indicate a change in the operational state of the SLEE.
*
* The notification type of slee state change notifications is specified by the
* {@link SleeManagementMBean#SLEE_STATE_CHANGE_NOTIFICATION_TYPE} attribute.
*/
public final class SleeStateChangeNotification extends Notification implements VendorExtensions {
/**
* Create a SleeStateChangeNotification to notify listeners of a
* change in the operational state of the SLEE. Notifications are broadcast
* after the SLEE has changed to the new state.
* @param sleeManagementMBean the SleeManagementMBean object that is
* emitting this notification.
* @param newState the new operational state of the SLEE.
* @param oldState the old operational state of the SLEE.
* @param sequenceNumber the notification sequence number within the source
* SleeManagementMBean object.
* @throws NullPointerException if notificationSource, newState,
* or oldState is null.
*/
public SleeStateChangeNotification(SleeManagementMBean sleeManagementMBean, SleeState newState, SleeState oldState, long sequenceNumber) throws NullPointerException {
super(SleeManagementMBean.SLEE_STATE_CHANGE_NOTIFICATION_TYPE, sleeManagementMBean, sequenceNumber, System.currentTimeMillis(),
"SLEE state changed from " + oldState + " to " + newState
);
if (sleeManagementMBean == null) throw new NullPointerException("sleeManagementMBean is null");
if (newState == null) throw new NullPointerException("newState is null");
if (oldState == null) throw new NullPointerException("oldState is null");
this.newState = newState;
this.oldState = oldState;
}
/**
* Get the new operational state of the SLEE.
* @return the new state.
*/
public SleeState getNewState() {
return newState;
}
/**
* Get the state the SLEE was in before the change to the new state.
* @return the old state.
*/
public SleeState 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.
*
* 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.
*
* This method should only be invoked if the vendor-specific data is serializable
* via standard Java serialization means.
* @since SLEE 1.1
* @see #disableVendorDataSerialization
* @see #setVendorData
*/
public static void enableVendorDataSerialization() {
vendorDataSerializationEnabled = true;
}
/**
* Disable the serialization of vendor-specific data for objects of this class.
*
* 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.
* @since SLEE 1.1
*/
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.
*
* 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.
* @since SLEE 1.1
* @see #disableVendorDataDeserialization
* @see #getVendorData
*/
public static void enableVendorDataDeserialization() {
vendorDataDeserializationEnabled = true;
}
/**
* Disable the deserialization of vendor-specific data for objects of this class.
*
* 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.
* @since SLEE 1.1
*/
public static void disableVendorDataDeserialization() {
vendorDataDeserializationEnabled = false;
}
/**
* Set the vendor-specific data.
* @param vendorData the vendor-specific data.
* @since SLEE 1.1
*/
public void setVendorData(Object vendorData) {
this.vendorData = vendorData;
}
/**
* Get the vendor-specific data.
* @return the vendor-specific data.
* @since SLEE 1.1
*/
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("SleeStateChangeNotification[timestamp=")
.append(getTimeStamp())
.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 SleeState newState;
private final SleeState oldState;
private static volatile boolean vendorDataSerializationEnabled = false;
private static volatile boolean vendorDataDeserializationEnabled = false;
private transient Object vendorData;
}