javax.slee.profile

Interface ProfileManagement

Deprecated.

Renamed to Profile, as a Profile Abstract Class may be implemented for both management and component interaction with a profile.

public interface ProfileManagement

This interface must be implemented by a Profile Abstract Class if a profile specification includes such a class.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isProfileDirty() Deprecated. Due to changes in the Profile model in SLEE 1.1, this method has been deprecated with no replacement.
boolean	isProfileValid(ProfileID id) Deprecated. The same functionality can be obtained in the SLEE 1.1 profile model as follows: ProfileContext context = ... context.getProfileTable(id.getProfileTableName()).find(id.getProfileName()) If the result of the find method is null, the profile does not exist in the specified profile table.
void	markProfileDirty() Deprecated. Due to changes in the Profile model in SLEE 1.1, this method has been deprecated with no replacement. A profile is still implicitly flagged as dirty if a CMP field of the profile is updated.
void	profileInitialize() Deprecated. Replaced with Profile.profileInitialize().
void	profileLoad() Deprecated. Replaced with Profile.profileLoad().
void	profileStore() Deprecated. Replaced with Profile.profileStore().
void	profileVerify() Deprecated. Replaced with Profile.profileVerify().

Method Detail

profileInitialize

void profileInitialize()

Deprecated. Replaced with Profile.profileInitialize().

The SLEE invokes this operation once the persistence representation for the profile has been created. The profile may initialize its transient or CMP fields during this method. This method is only invoked once for each profile table that is created, and provides the initial values for the profile table's default profile.

This method is invoked with an active transaction context. The SLEE follows a call to this method with a call to profileStore() and profileVerify() in the same transaction.

profileLoad

void profileLoad()

Deprecated. Replaced with Profile.profileLoad().

The SLEE invokes this method on a profile when the state of the profile object needs to be synchronized with the state in the underlying data source. The profile object should reload from CMP fields any transient state that depends on the state stored in those CMP fields.

This method is invoked with an active transaction context.

profileStore

void profileStore()

Deprecated. Replaced with Profile.profileStore().

The SLEE invokes this operation when the state of the underlying data source needs to be synchronized with the state of the profile. The profile object should store into CMP fields any transient state that depends on the state stored in those CMP fields.

This method is invoked with an active transaction context.

profileVerify

void profileVerify()
                   throws ProfileVerificationException

Deprecated. Replaced with Profile.profileVerify().

The SLEE invokes this operation in response to a request by the Administrator to commit any changes made to the profile. The profile object should verify that the contents of its CMP fields at exit from this method form a valid configuration for SBB instances. If not, a ProfileVerificationException should be thrown.

Throws:

ProfileVerificationException - if the profile fails any verification check.

markProfileDirty

void markProfileDirty()

Deprecated. Due to changes in the Profile model in SLEE 1.1, this method has been deprecated with no replacement. A profile is still implicitly flagged as dirty if a CMP field of the profile is updated.

Mark the profile as being dirty, that is, that it has been modified since it was last committed. Modifying a CMP field automatically flags the profile as being dirty, so this method only needs to be called, for example, if transient state changes.

An SBB Developer must not implement this operation. It is implemented by the SLEE at deployment time.

This method must be invoked with a valid transaction context.

isProfileDirty

boolean isProfileDirty()

Deprecated. Due to changes in the Profile model in SLEE 1.1, this method has been deprecated with no replacement.

Determine if the profile has been dirtied by an uncommitted change to its state.

An SBB Developer must not implement this operation. It is implemented by the SLEE at deployment time.

This method must be invoked with a valid transaction context.

Returns:

true if the profile has been modified since last being committed, false otherwise.

isProfileValid

boolean isProfileValid(ProfileID id)
                       throws NullPointerException,
                              SLEEException

Deprecated. The same functionality can be obtained in the SLEE 1.1 profile model as follows:

ProfileContext context = ...
context.getProfileTable(id.getProfileTableName()).find(id.getProfileName())

If the result of the find method is null, the profile does not exist in the specified profile table.

Determine if the profile referenced by a specified profile identifier currently exists.

An SBB Developer must not implement this operation. It is implemented by the SLEE at deployment time.

This method must be invoked with a valid transaction context.

Parameters:

id - the profile identifier.

Returns:

true if the profile referenced by the profile identifier currently exists, false otherwise.

Throws:

NullPointerException - if id is null.

SLEEException - if the profile identifier could not be validated due to a system-level failure.