javax.slee.management

Class SleeStateChangeNotification

java.lang.Object

java.util.EventObject

javax.management.Notification

javax.slee.management.SleeStateChangeNotification

All Implemented Interfaces:

Serializable, VendorExtensions

public final class SleeStateChangeNotification
extends Notification
implements VendorExtensions

This notification is emitted by a 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 SleeManagementMBean.SLEE_STATE_CHANGE_NOTIFICATION_TYPE attribute.

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.management.Notification

source

Constructor Summary

Constructors

Constructor and Description
SleeStateChangeNotification(SleeManagementMBean sleeManagementMBean, SleeState newState, SleeState oldState, long sequenceNumber) Create a SleeStateChangeNotification to notify listeners of a change in the operational state of the SLEE.

Method Summary

Methods

Modifier and Type	Method and Description
static void	disableVendorDataDeserialization() Disable the deserialization of vendor-specific data for objects of this class.
static void	disableVendorDataSerialization() Disable the serialization of vendor-specific data for objects of this class.
static void	enableVendorDataDeserialization() Enable the deserialization of vendor-specific data for objects of this class.
static void	enableVendorDataSerialization() Enable the serialization of vendor-specific data for objects of this class.
SleeState	getNewState() Get the new operational state of the SLEE.
SleeState	getOldState() Get the state the SLEE was in before the change to the new state.
Object	getVendorData() Get the vendor-specific data.
void	setVendorData(Object vendorData) Set the vendor-specific data.
String	toString() Get a string representation for this notification.

Methods inherited from class javax.management.Notification

getMessage, getSequenceNumber, getTimeStamp, getType, getUserData, setSequenceNumber, setSource, setTimeStamp, setUserData

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SleeStateChangeNotification

public SleeStateChangeNotification(SleeManagementMBean sleeManagementMBean,
                           SleeState newState,
                           SleeState oldState,
                           long sequenceNumber)
                            throws NullPointerException

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.

Parameters:

sleeManagementMBean - the SleeManagementMBean object that is emitting this notification.

newState - the new operational state of the SLEE.

oldState - the old operational state of the SLEE.

sequenceNumber - the notification sequence number within the source SleeManagementMBean object.

Throws:

NullPointerException - if notificationSource, newState, or oldState is null.

Method Detail

getNewState

public SleeState getNewState()

Get the new operational state of the SLEE.

Returns:

the new state.

getOldState

public SleeState getOldState()

Get the state the SLEE was in before the change to the new state.

Returns:

the old state.

enableVendorDataSerialization

public static void enableVendorDataSerialization()

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

disableVendorDataSerialization(), setVendorData(java.lang.Object)

disableVendorDataSerialization

public static void disableVendorDataSerialization()

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 enableVendorDataSerialization() method, this method disables that behavior again.

Since:

SLEE 1.1

enableVendorDataDeserialization

public static void enableVendorDataDeserialization()

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

disableVendorDataDeserialization(), getVendorData()

disableVendorDataDeserialization

public static void disableVendorDataDeserialization()

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 enableVendorDataDeserialization() method, this method disables that behavior again.

Since:

SLEE 1.1

setVendorData

public void setVendorData(Object vendorData)

Set the vendor-specific data.

Specified by:

setVendorData in interface VendorExtensions

Parameters:

vendorData - the vendor-specific data.

Since:

SLEE 1.1

getVendorData

public Object getVendorData()

Get the vendor-specific data.

Specified by:

getVendorData in interface VendorExtensions

Returns:

the vendor-specific data.

Since:

SLEE 1.1

toString

public String toString()

Get a string representation for this notification.

Overrides:

toString in class Notification

Returns:

a string representation for this notification.