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.
|