javax.slee.profile

Interface ProfileRemovedEvent

public interface ProfileRemovedEvent

This interface is implemented by profile removed events generated by ProfileProvisioningMBean objects when a profile is removed from a profile table.

The event type name of profile removed events is "javax.slee.profile.ProfileRemovedEvent".

Method Summary

Methods

Modifier and Type	Method and Description
ProfileID	getProfile() Get the profile identifier for the profile that was removed.
Address	getProfileAddress() Get the address of the profile that was removed.
Object	getRemovedProfile() Deprecated. Replaced with getRemovedProfileLocal() which returns an object implementing the Profile Local Interface rather than the Profile CMP Interface.
ProfileLocalObject	getRemovedProfileLocal() Get a profile local object associated with the committed state of the profile before it was updated.

Method Detail

getProfile

ProfileID getProfile()

Get the profile identifier for the profile that was removed.

Returns:

the profile identifier for the profile that was removed.

getProfileAddress

Address getProfileAddress()

Get the address of the profile that was removed. The address plan of this address is AddressPlan.SLEE_PROFILE.

Returns:

the address of the profile that was removed.

getRemovedProfile

Object getRemovedProfile()

Deprecated. Replaced with getRemovedProfileLocal() which returns an object implementing the Profile Local Interface rather than the Profile CMP Interface.

Get the committed state of the profile just before it was removed. The actual type of the return value is the Profile CMP Interface defined by the profile specification of the profile table in which the profile resided, and may be safely typecast using the normal Java typecast mechanism.

The object returned from this method is only valid within the event-handler transaction in which the event was delivered to an SBB entity. The state contained in the object is read-only and cannot be modified.

Returns:

the committed state of the profile just before it was removed. This method may return null in the case where the required profile specification classes are not available in the classloader of the calling SLEE component, eg. the SLEE component's deployment descriptor has not defined a reference to the profile specification of this event's profile table.

getRemovedProfileLocal

ProfileLocalObject getRemovedProfileLocal()

Get a profile local object associated with the committed state of the profile before it was updated. The actual type of the return value is the Profile Local Interface defined by the profile specification of the profile table in which the profile resides, and may be safely typecast using the normal Java typecast mechanism.

The object returned from this method is only valid within the event-handler transaction in which the event was delivered to an SBB entity. The state accessed via the profile local object is read-only and cannot be modified.

Returns:

a profile local object associated with the committed state of the profile before it was removed. This method may return null in the case where the required profile specification classes are not available in the classloader of the calling SLEE component, eg. the SLEE component's deployment descriptor has not defined a reference to the profile specification of this event's profile table.

Since:

SLEE 1.1