public enum TransactionAttributeType extends Enum<TransactionAttributeType>
TransactionAttributeType
is used with the
TransactionAttribute
annotation to specify whether the
methods of a session bean or message driven bean are called with a
valid transaction context.
For a message-driven bean's message listener methods (or interface), only
the REQUIRED
and NOT_SUPPORTED
values may be used.
For an enterprise bean's timeout callback methods, only the
REQUIRED
, REQUIRES_NEW
and NOT_SUPPORTED
values may be used.
For a session bean's asynchronous business methods, only the
REQUIRED
, REQUIRES_NEW
, and NOT_SUPPORTED
values may be used.
For a singleton session bean's PostConstruct
and PreDestroy
lifecycle callback interceptor methods, only the REQUIRED
,
REQUIRES_NEW
, and NOT_SUPPORTED
values may be used.
If an enterprise bean implements the SessionSynchronization
interface
or uses any of the session synchronization annotations, only the following values
may be used for the transaction attributes of the bean's methods:
REQUIRED
, REQUIRES_NEW
, MANDATORY
.
TransactionAttribute
Enum Constant and Description |
---|
MANDATORY
If a client invokes the enterprise bean's method while the client
is associated with a transaction context, the container invokes the
enterprise bean's method in the client's transaction context.
|
NEVER
The client is required to call without a transaction context, otherwise
an exception is thrown.
|
NOT_SUPPORTED
The container invokes an enterprise bean method whose transaction
attribute
NOT_SUPPORTED with an unspecified transaction context. |
REQUIRED
If a client invokes the enterprise bean's method while the client is
associated with a transaction context, the container invokes the
enterprise bean's method in the client's transaction context.
|
REQUIRES_NEW
The container must invoke an enterprise bean method whose transaction
attribute is set to
REQUIRES_NEW with a new transaction context. |
SUPPORTS
If the client calls with a transaction context, the container performs
the same steps as described in the
REQUIRED case. |
Modifier and Type | Method and Description |
---|---|
static TransactionAttributeType |
valueOf(String name)
Returns the enum constant of this type with the specified name.
|
static TransactionAttributeType[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final TransactionAttributeType MANDATORY
If there is no existing transaction, an exception is thrown.
public static final TransactionAttributeType REQUIRED
If the client invokes the enterprise bean's method while the client is not associated with a transaction context, the container automatically starts a new transaction before delegating a method call to the enterprise bean method.
public static final TransactionAttributeType REQUIRES_NEW
REQUIRES_NEW
with a new transaction context.
If the client invokes the enterprise bean's method while the client is not associated with a transaction context, the container automatically starts a new transaction before delegating a method call to the enterprise bean business method.
If a client calls with a transaction context, the container suspends the association of the transaction context with the current thread before starting the new transaction and invoking the method. The container resumes the suspended transaction association after the method and the new transaction have been completed.
public static final TransactionAttributeType SUPPORTS
REQUIRED
case.
If the client calls without a transaction context, the container performs the
same steps as described in the NOT_SUPPORTED
case.
The SUPPORTS
transaction attribute must be used with caution.
This is because of the different transactional semantics provided by the
two possible modes of execution. Only enterprise beans that will execute
correctly in both modes should use the SUPPORTS
transaction attribute.
public static final TransactionAttributeType NOT_SUPPORTED
NOT_SUPPORTED
with an unspecified transaction context.
If a client calls with a transaction context, the container suspends the association of the transaction context with the current thread before invoking the enterprise bean's business method. The container resumes the suspended association when the business method has completed.
public static final TransactionAttributeType NEVER
public static TransactionAttributeType[] values()
for (TransactionAttributeType c : TransactionAttributeType.values()) System.out.println(c);
public static TransactionAttributeType valueOf(String name)
name
- the name of the enum constant to be returned.IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is nullCopyright © 1996-2017, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.