[5.0 only]Container ActivitySession assembly properties for EJB modules

Use this page to specify how a container must manage the scope of an ActivitySession for an enterprise bean's method invocations.

Name
Specifies a name for the mapping between an ActivitySession attribute and one or more methods.
Datatype String
Description
Contains text that describes the mapping
Datatype String
Methods
The methods to which the ActivitySession attribute applies.

To add a new method, click Add. Expand the tree to select the method or methods from the EJB module

ActivitySession attribute
How the container must manage the activity session boundaries when delegating a method invocation to an enterprise bean's business method
Default Supports
Range
Not supported
The container invokes bean methods without an ActivitySession context. If a client invokes a bean method from within an ActivitySession context, the container suspends the association between the ActivitySession and the current thread before invoking the method on the enterprise bean instance. The container then resumes the suspended association when the method invocation returns. The suspended ActivitySession context is not passed to any enterprise bean objects or resources that are used by this bean method.
Required
The container invokes the bean method within an ActivitySession context. If a client invokes a bean method from within an ActivitySession context, the container invokes the bean method within the client ActivitySession context. If a client invokes a bean method outside an ActivitySession context, the container creates a new ActivitySession context and invokes the bean method from within that context. The ActivitySession context is passed to any enterprise bean objects or resources that are used by this bean method.
Supports
If the client invokes the bean method within an ActivitySession, the container invokes the bean method within an ActivitySession context. If the client invokes the bean method without a ActivitySession context, the container invokes the bean method without an ActivitySession context. The ActivitySession context is passed to any enterprise bean objects or resources that are used by this bean method.
Requires new
The container always invokes the bean method within a new ActivitySession context, regardless of whether the client invokes the method within or outside an ActivitySession context. The new ActivitySession context is passed to any enterprise bean objects or resources that are used by this bean method.

Any received ActivitySession context is suspended for the duration of the method and resumed after the method ends. The container starts a new ActivitySession before method dispatch and completes it after the method ends.

Mandatory
The container always invokes the bean method within the ActivitySession context associated with the client. If the client attempts to invoke the bean method without an ActivitySession context, the container throws an ActivityRequiredException exception to the client. The ActivitySession context is passed to any EJB object or resource accessed by an enterprise bean method.

The ActivityRequiredException exception is defined as a javax.rmi.RemoteException that is propagated over an ORB boundary as a CORBA.ACTIVITY_REQUIRED system exception.

EJB clients that access these entity beans must do so within an existing ActivitySession. For other enterprise beans, the enterprise bean or bean method must implement bean-managed ActivitySessions or use the Required or Requires New value. For non-enterprise bean EJB clients, the client must invoke an ActivitySession by using the UserActivitySession interface.

Never
The container invokes bean methods without an ActivitySession context.
  • If the client invokes a bean method from within an ActivitySession context, the container throws an InvalidActivityException exception, which is defined as a javax.rmi.RemoteException that is propagated over an ORB boundary as a CORBA.INVALID_ACTIVITY system exception.
  • If the client invokes a bean method from outside an ActivitySession context, the container behaves in the same way as if the Not Supported value was set. The client must call the method without an ActivitySession context.

Related tasks
Setting EJB module ActivitySession deployment attributes with the Application Assembly Tool



Searchable topic ID:   uaat_ejbass
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/aat_pme/ui/uaat_ejbass.html

Library | Support | Terms of Use | Feedback