public abstract class AbstractFallbackTransactionAttributeSource extends java.lang.Object implements TransactionAttributeSource
TransactionAttributeSource
that caches
attributes for methods and implements a fallback policy: 1. specific target
method; 2. target class; 3. declaring method; 4. declaring class/interface.
Defaults to using the target class's transaction attribute if none is associated with the target method. Any transaction attribute associated with the target method completely overrides a class transaction attribute. If none found on the target class, the interface that the invoked method has been called through (in case of a JDK proxy) will be checked.
This implementation caches attributes by method after they are first used. If it is ever desirable to allow dynamic changing of transaction attributes (which is very unlikely), caching could be made configurable. Caching is desirable because of the cost of evaluating rollback rules.
Modifier and Type | Field and Description |
---|---|
private java.util.Map<java.lang.Object,TransactionAttribute> |
attributeCache
Cache of TransactionAttributes, keyed by method on a specific target class.
|
protected Log |
logger
Logger available to subclasses.
|
private static TransactionAttribute |
NULL_TRANSACTION_ATTRIBUTE
Canonical value held in cache to indicate no transaction attribute was
found for this method, and we don't need to look again.
|
Constructor and Description |
---|
AbstractFallbackTransactionAttributeSource() |
Modifier and Type | Method and Description |
---|---|
protected boolean |
allowPublicMethodsOnly()
Should only public methods be allowed to have transactional semantics?
|
protected TransactionAttribute |
computeTransactionAttribute(java.lang.reflect.Method method,
java.lang.Class<?> targetClass)
Same signature as
getTransactionAttribute(java.lang.reflect.Method, java.lang.Class<?>) , but doesn't cache the result. |
protected abstract TransactionAttribute |
findTransactionAttribute(java.lang.Class<?> clazz)
Subclasses need to implement this to return the transaction attribute for the
given class, if any.
|
protected abstract TransactionAttribute |
findTransactionAttribute(java.lang.reflect.Method method)
Subclasses need to implement this to return the transaction attribute for the
given method, if any.
|
protected java.lang.Object |
getCacheKey(java.lang.reflect.Method method,
java.lang.Class<?> targetClass)
Determine a cache key for the given method and target class.
|
TransactionAttribute |
getTransactionAttribute(java.lang.reflect.Method method,
java.lang.Class<?> targetClass)
Determine the transaction attribute for this method invocation.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
isCandidateClass
private static final TransactionAttribute NULL_TRANSACTION_ATTRIBUTE
protected final Log logger
As this base class is not marked Serializable, the logger will be recreated after serialization - provided that the concrete subclass is Serializable.
private final java.util.Map<java.lang.Object,TransactionAttribute> attributeCache
As this base class is not marked Serializable, the cache will be recreated after serialization - provided that the concrete subclass is Serializable.
public AbstractFallbackTransactionAttributeSource()
@Nullable public TransactionAttribute getTransactionAttribute(java.lang.reflect.Method method, @Nullable java.lang.Class<?> targetClass)
Defaults to the class's transaction attribute if no method attribute is found.
getTransactionAttribute
in interface TransactionAttributeSource
method
- the method for the current invocation (never null
)targetClass
- the target class for this invocation (may be null
)null
if the method
is not transactionalprotected java.lang.Object getCacheKey(java.lang.reflect.Method method, @Nullable java.lang.Class<?> targetClass)
Must not produce same key for overloaded methods. Must produce same key for different instances of the same method.
method
- the method (never null
)targetClass
- the target class (may be null
)null
)@Nullable protected TransactionAttribute computeTransactionAttribute(java.lang.reflect.Method method, @Nullable java.lang.Class<?> targetClass)
getTransactionAttribute(java.lang.reflect.Method, java.lang.Class<?>)
, but doesn't cache the result.
getTransactionAttribute(java.lang.reflect.Method, java.lang.Class<?>)
is effectively a caching decorator for this method.
As of 4.1.8, this method can be overridden.
getTransactionAttribute(java.lang.reflect.Method, java.lang.Class<?>)
@Nullable protected abstract TransactionAttribute findTransactionAttribute(java.lang.Class<?> clazz)
clazz
- the class to retrieve the attribute fornull
if none@Nullable protected abstract TransactionAttribute findTransactionAttribute(java.lang.reflect.Method method)
method
- the method to retrieve the attribute fornull
if noneprotected boolean allowPublicMethodsOnly()
The default implementation returns false
.