AbstractFallbackTransactionAttributeSource

java.lang.Object
- org.springframework.transaction.interceptor.AbstractFallbackTransactionAttributeSource

All Implemented Interfaces:

TransactionAttributeSource

Direct Known Subclasses:

AnnotationTransactionAttributeSource
```
public abstract class AbstractFallbackTransactionAttributeSource
extends java.lang.Object
implements TransactionAttributeSource
```
Abstract implementation of 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.

Since:

1.1

Author:

Rod Johnson, Juergen Hoeller

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

private static class AbstractFallbackTransactionAttributeSource.DefaultCacheKey
Default cache key for the TransactionAttribute cache.

Nested Classes
Modifier and Type	Class and Description
`private static class`	`AbstractFallbackTransactionAttributeSource.DefaultCacheKey` Default cache key for the TransactionAttribute cache.

Field Summary

Fields
Modifier and Type	Field and Description
`(package private) java.util.Map<java.lang.Object,TransactionAttribute>`	`attributeCache` Cache of TransactionAttributes, keyed by DefaultCacheKey (Method + 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 Summary

Constructors
Constructor and Description

AbstractFallbackTransactionAttributeSource()

Constructors
Constructor and Description
`AbstractFallbackTransactionAttributeSource()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
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.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - NULL_TRANSACTION_ATTRIBUTE
```
private static final 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.
  - logger
```
protected final Log logger
```
    Logger available to subclasses.
    As this base class is not marked Serializable, the logger will be recreated after serialization - provided that the concrete subclass is Serializable.
  - attributeCache
```
final java.util.Map<java.lang.Object,TransactionAttribute> attributeCache
```
    Cache of TransactionAttributes, keyed by DefaultCacheKey (Method + target Class).
    As this base class is not marked Serializable, the cache will be recreated after serialization - provided that the concrete subclass is Serializable.
- Constructor Detail
  - AbstractFallbackTransactionAttributeSource
```
public AbstractFallbackTransactionAttributeSource()
```
- Method Detail
  - getTransactionAttribute
```
public TransactionAttribute getTransactionAttribute(java.lang.reflect.Method method,
                                                    java.lang.Class<?> targetClass)
```
    Determine the transaction attribute for this method invocation.
    Defaults to the class's transaction attribute if no method attribute is found.
    
    Specified by:
    
    getTransactionAttribute in interface TransactionAttributeSource
    
    Parameters:
    
    method - the method for the current invocation (never null)
    
    targetClass - the target class for this invocation (may be null)
    
    Returns:
    
    TransactionAttribute for this method, or null if the method is not transactional
  - getCacheKey
```
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.
    Must not produce same key for overloaded methods. Must produce same key for different instances of the same method.
    
    Parameters:
    
    method - the method (never null)
    
    targetClass - the target class (may be null)
    
    Returns:
    
    the cache key (never null)
  - computeTransactionAttribute
```
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. 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.
    
    Since:
    
    4.1.8
    
    See Also:
    
    getTransactionAttribute(java.lang.reflect.Method, java.lang.Class<?>)
  - findTransactionAttribute
```
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.
    
    Parameters:
    
    method - the method to retrieve the attribute for
    
    Returns:
    
    all transaction attribute associated with this method (or null if none)
  - findTransactionAttribute
```
protected abstract TransactionAttribute findTransactionAttribute(java.lang.Class<?> clazz)
```
    Subclasses need to implement this to return the transaction attribute for the given class, if any.
    
    Parameters:
    
    clazz - the class to retrieve the attribute for
    
    Returns:
    
    all transaction attribute associated with this class (or null if none)
  - allowPublicMethodsOnly
```
protected boolean allowPublicMethodsOnly()
```
    Should only public methods be allowed to have transactional semantics?
    The default implementation returns false.

Class AbstractFallbackTransactionAttributeSource

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

NULL_TRANSACTION_ATTRIBUTE

logger

attributeCache

Constructor Detail

AbstractFallbackTransactionAttributeSource

Method Detail

getTransactionAttribute

getCacheKey

computeTransactionAttribute

findTransactionAttribute

findTransactionAttribute

allowPublicMethodsOnly