javax.slee.serviceactivity
Interface ServiceActivityContextInterfaceFactory

public interface ServiceActivityContextInterfaceFactory

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

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

See Also:

ServiceActivity, ServiceActivityFactory

Field Summary

static java.lang.String

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

Method Summary

ActivityContextInterface

getActivityContextInterface(ServiceActivity activity) Get an ActivityContextInterface object for a Service activity.

Field Detail

JNDI_NAME

static final java.lang.String JNDI_NAME

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

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

Since:

SLEE 1.1

See Also:

Constant Field Values

Method Detail

getActivityContextInterface

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

Get an ActivityContextInterface object for a Service activity.

This method is a mandatory transactional method.

Parameters:

activity - the Service activity.

Returns:

an ActivityContextInterface object that encapsulates the Service 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 Service activity created by the SLEE.

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