com.opencloud.rhino.resources.sessionownership

Interface SessionOwnershipActivityContextInterfaceFactory

public interface SessionOwnershipActivityContextInterfaceFactory

The Session Ownership Activity Context Interface Factory is used by SBBs to obtain an ActivityContextInterface object for a session ownership activity.

An SBB obtains access to a SessionOwnershipActivityContextInterfaceFactory object via its JNDI environment. The Session Ownership Activity Context Interface Factory is bound into JNDI using the name specified by JNDI_NAME. An SBB may also bind a Session Ownership Activity Context Interface Factory into another location using the activity-context-interface-factory-name element of resource-adaptor-type-binding in the SBB deployment descriptor.

Since:

Rhino 2.6.1

Field Summary

Fields

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

Method Summary

Modifier and Type	Method and Description
ActivityContextInterface	getActivityContextInterface(SessionOwnershipActivity activity) Get an ActivityContextInterface object for a session ownership activity.

Field Detail

JNDI_NAME

static final String JNDI_NAME

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

The value of this constant is "java:comp/env/rhino/sessionownership/activitycontextinterfacefactory".

Since:

Rhino 2.6.1

See Also:

Constant Field Values

Method Detail

getActivityContextInterface

ActivityContextInterface getActivityContextInterface(SessionOwnershipActivity activity)
                                              throws NullPointerException,
                                                     TransactionRequiredLocalException,
                                                     UnrecognizedActivityException,
                                                     FactoryException

Get an ActivityContextInterface object for a session ownership activity.

This method is a mandatory transactional method.

Parameters:

activity - the session ownership activity.

Returns:

an ActivityContextInterface object that encapsulates the session ownership 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 session ownership activity.

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

Since:

Rhino 2.6.1