|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectorg.springframework.transaction.support.DefaultTransactionDefinition
public class DefaultTransactionDefinition
Default implementation of the TransactionDefinition interface,
offering bean-style configuration and sensible default values
(PROPAGATION_REQUIRED, ISOLATION_DEFAULT, TIMEOUT_DEFAULT, readOnly=false).
Base class for both TransactionTemplate and
DefaultTransactionAttribute.
| Field Summary | |
|---|---|
static String |
PREFIX_ISOLATION
Prefix for the isolation constants defined in TransactionDefinition |
static String |
PREFIX_PROPAGATION
Prefix for the propagation constants defined in TransactionDefinition |
static String |
PREFIX_TIMEOUT
Prefix for transaction timeout values in description strings |
static String |
READ_ONLY_MARKER
Marker for read-only transactions in description strings |
| Fields inherited from interface org.springframework.transaction.TransactionDefinition |
|---|
ISOLATION_DEFAULT, ISOLATION_READ_COMMITTED, ISOLATION_READ_UNCOMMITTED, ISOLATION_REPEATABLE_READ, ISOLATION_SERIALIZABLE, PROPAGATION_MANDATORY, PROPAGATION_NESTED, PROPAGATION_NEVER, PROPAGATION_NOT_SUPPORTED, PROPAGATION_REQUIRED, PROPAGATION_REQUIRES_NEW, PROPAGATION_SUPPORTS, TIMEOUT_DEFAULT |
| Constructor Summary | |
|---|---|
DefaultTransactionDefinition()
Create a new DefaultTransactionDefinition, with default settings. |
|
DefaultTransactionDefinition(int propagationBehavior)
Create a new DefaultTransactionDefinition with the the given propagation behavior. |
|
DefaultTransactionDefinition(TransactionDefinition other)
Copy constructor. |
|
| Method Summary | |
|---|---|
boolean |
equals(Object other)
This implementation compares the toString() results. |
protected StringBuilder |
getDefinitionDescription()
Return an identifying description for this transaction definition. |
int |
getIsolationLevel()
Return the isolation level. |
String |
getName()
Return the name of this transaction. |
int |
getPropagationBehavior()
Return the propagation behavior. |
int |
getTimeout()
Return the transaction timeout. |
int |
hashCode()
This implementation returns toString()'s hash code. |
boolean |
isReadOnly()
Return whether to optimize as a read-only transaction. |
void |
setIsolationLevel(int isolationLevel)
Set the isolation level. |
void |
setIsolationLevelName(String constantName)
Set the isolation level by the name of the corresponding constant in TransactionDefinition, e.g. |
void |
setName(String name)
Set the name of this transaction. |
void |
setPropagationBehavior(int propagationBehavior)
Set the propagation behavior. |
void |
setPropagationBehaviorName(String constantName)
Set the propagation behavior by the name of the corresponding constant in TransactionDefinition, e.g. |
void |
setReadOnly(boolean readOnly)
Set whether to optimize as read-only transaction. |
void |
setTimeout(int timeout)
Set the timeout to apply, as number of seconds. |
String |
toString()
Return an identifying description for this transaction definition. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
public static final String PREFIX_PROPAGATION
public static final String PREFIX_ISOLATION
public static final String PREFIX_TIMEOUT
public static final String READ_ONLY_MARKER
| Constructor Detail |
|---|
public DefaultTransactionDefinition()
setPropagationBehavior(int),
setIsolationLevel(int),
setTimeout(int),
setReadOnly(boolean),
setName(java.lang.String)public DefaultTransactionDefinition(TransactionDefinition other)
setPropagationBehavior(int),
setIsolationLevel(int),
setTimeout(int),
setReadOnly(boolean),
setName(java.lang.String)public DefaultTransactionDefinition(int propagationBehavior)
propagationBehavior - one of the propagation constants in the
TransactionDefinition interfacesetIsolationLevel(int),
setTimeout(int),
setReadOnly(boolean)| Method Detail |
|---|
public final void setPropagationBehaviorName(String constantName)
throws IllegalArgumentException
constantName - name of the constant
IllegalArgumentException - if the supplied value is not resolvable
to one of the PROPAGATION_ constants or is nullsetPropagationBehavior(int),
TransactionDefinition.PROPAGATION_REQUIREDpublic final void setPropagationBehavior(int propagationBehavior)
IllegalArgumentException - if the supplied value is not
one of the PROPAGATION_ constantsTransactionDefinition.PROPAGATION_REQUIREDpublic final int getPropagationBehavior()
TransactionDefinitionMust return one of the PROPAGATION_XXX constants
defined on this interface.
getPropagationBehavior in interface TransactionDefinitionTransactionDefinition.PROPAGATION_REQUIRED,
TransactionSynchronizationManager.isActualTransactionActive()
public final void setIsolationLevelName(String constantName)
throws IllegalArgumentException
constantName - name of the constant
IllegalArgumentException - if the supplied value is not resolvable
to one of the ISOLATION_ constants or is nullsetIsolationLevel(int),
TransactionDefinition.ISOLATION_DEFAULTpublic final void setIsolationLevel(int isolationLevel)
IllegalArgumentException - if the supplied value is not
one of the ISOLATION_ constantsTransactionDefinition.ISOLATION_DEFAULTpublic final int getIsolationLevel()
TransactionDefinitionMust return one of the ISOLATION_XXX constants
defined on this interface.
Only makes sense in combination with TransactionDefinition.PROPAGATION_REQUIRED
or TransactionDefinition.PROPAGATION_REQUIRES_NEW.
Note that a transaction manager that does not support custom isolation levels
will throw an exception when given any other level than TransactionDefinition.ISOLATION_DEFAULT.
getIsolationLevel in interface TransactionDefinitionpublic final void setTimeout(int timeout)
TransactionDefinition.TIMEOUT_DEFAULTpublic final int getTimeout()
TransactionDefinitionMust return a number of seconds, or TransactionDefinition.TIMEOUT_DEFAULT.
Only makes sense in combination with TransactionDefinition.PROPAGATION_REQUIRED
or TransactionDefinition.PROPAGATION_REQUIRES_NEW.
Note that a transaction manager that does not support timeouts will throw
an exception when given any other timeout than TransactionDefinition.TIMEOUT_DEFAULT.
getTimeout in interface TransactionDefinitionpublic final void setReadOnly(boolean readOnly)
public final boolean isReadOnly()
TransactionDefinitionThe read-only flag applies to any transaction context, whether
backed by an actual resource transaction
(TransactionDefinition.PROPAGATION_REQUIRED/TransactionDefinition.PROPAGATION_REQUIRES_NEW) or
operating non-transactionally at the resource level
(TransactionDefinition.PROPAGATION_SUPPORTS). In the latter case, the flag will
only apply to managed resources within the application, such as a
Hibernate Session.
<< *
This just serves as a hint for the actual transaction subsystem; it will not necessarily cause failure of write access attempts. A transaction manager which cannot interpret the read-only hint will not throw an exception when asked for a read-only transaction.
isReadOnly in interface TransactionDefinitiontrue if the transaction is to be optimized as read-onlyTransactionSynchronization.beforeCommit(boolean),
TransactionSynchronizationManager.isCurrentTransactionReadOnly()public final void setName(String name)
This will be used as transaction name to be shown in a transaction monitor, if applicable (for example, WebLogic's).
public final String getName()
TransactionDefinitionnull.
This will be used as the transaction name to be shown in a transaction monitor, if applicable (for example, WebLogic's).
In case of Spring's declarative transactions, the exposed name will be
the fully-qualified class name + "." + method name (by default).
getName in interface TransactionDefinitionTransactionAspectSupport,
TransactionSynchronizationManager.getCurrentTransactionName()public boolean equals(Object other)
toString() results.
equals in class ObjecttoString()public int hashCode()
toString()'s hash code.
hashCode in class ObjecttoString()public String toString()
The format matches the one used by
TransactionAttributeEditor,
to be able to feed toString results into bean properties of type
TransactionAttribute.
Has to be overridden in subclasses for correct equals
and hashCode behavior. Alternatively, equals(java.lang.Object)
and hashCode() can be overridden themselves.
toString in class ObjectgetDefinitionDescription(),
TransactionAttributeEditorprotected final StringBuilder getDefinitionDescription()
Available to subclasses, for inclusion in their toString() result.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||