javax.slee.nullactivity
Interface NullActivityContextInterfaceFactory

public interface NullActivityContextInterfaceFactory

The Null Activity Context Interface Factory is used by SBBs to obtain an ActivityContextInterface object for a null activity.

An SBB obtains access to a NullActivityContextInterfaceFactory object via its JNDI environment. The Null Activity Context Interface Factory is bound into JNDI using the name specified by JNDI_NAME.

See Also:

NullActivity, NullActivityFactory

Field Summary

static java.lang.String

JNDI_NAME Constant declaring the JNDI name where a NullActivityContextInterfaceFactory object is bound into an SBB's JNDI environment.

Method Summary

ActivityContextInterface

getActivityContextInterface(NullActivity activity) Get an ActivityContextInterface object for a null activity.

Field Detail

JNDI_NAME

static final java.lang.String JNDI_NAME

Constant declaring the JNDI name where a NullActivityContextInterfaceFactory object is bound into an SBB's JNDI environment.

The value of this constant is "java:comp/env/slee/nullactivity/activitycontextinterfacefactory".

Since:

SLEE 1.1

See Also:

Constant Field Values

Method Detail

getActivityContextInterface

ActivityContextInterface getActivityContextInterface(NullActivity activity)
                                                     throws java.lang.NullPointerException,
                                                            TransactionRequiredLocalException,
                                                            UnrecognizedActivityException,
                                                            FactoryException

Get an ActivityContextInterface object for a null activity.

This method is a mandatory transactional method.

Parameters:

activity - the null activity.

Returns:

an ActivityContextInterface object that encapsulates the null activity.

Throws:

java.lang.NullPointerException - if activity is null.

TransactionRequiredLocalException - if this method is invoked without a valid transaction context.

UnrecognizedActivityException - if activity is not a valid null activity created by the SLEE.

FactoryException - if the ActivityContextInterface object could not be created due to a system-level failure.