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

Fields

Modifier and Type	Field and Description
static String	JNDI_NAME Constant declaring the JNDI name where a ServiceActivityContextInterfaceFactory object is bound into an SBB's JNDI environment.

Method Summary

Methods

Modifier and Type	Method and Description
ActivityContextInterface	getActivityContextInterface(ServiceActivity activity) Get an ActivityContextInterface object for a Service activity.

Field Detail

JNDI_NAME

static final 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 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:

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.