org.springframework.transaction.interceptor
Class AbstractFallbackTransactionAttributeSource

java.lang.Object
  extended byorg.springframework.transaction.interceptor.AbstractFallbackTransactionAttributeSource
All Implemented Interfaces:
TransactionAttributeSource
Direct Known Subclasses:
AttributesTransactionAttributeSource

public abstract class AbstractFallbackTransactionAttributeSource
extends java.lang.Object
implements TransactionAttributeSource

Abstract implementation of TransactionAttributeSource that caches attributes for methods, and implements fallback policy of 1. most specific method; 2. target class attribute; 3. declaring method; 4. declaring class.

Defaults to using 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.

This implementation caches attributes by method after they are first used. If it's ever desirable to allow dynamic changing of transaction attributes (unlikely) caching could be made configurable. Caching is desirable because of the cost of evaluating rollback rules.

Author:
Rod Johnson

Field Summary
protected  org.apache.commons.logging.Log logger
           
 
Constructor Summary
AbstractFallbackTransactionAttributeSource()
           
 
Method Summary
protected abstract  java.util.Collection findAllAttributes(java.lang.Class clazz)
          Subclasses should implement this to return all attributes for this class.
protected abstract  java.util.Collection findAllAttributes(java.lang.reflect.Method m)
          Subclasses should implement this to return all attributes for this method.
protected  TransactionAttribute findTransactionAttribute(java.util.Collection atts)
          Return the transaction attribute, given this set of attributes attached to a method or class.
 TransactionAttribute getTransactionAttribute(java.lang.reflect.Method method, java.lang.Class targetClass)
          Return 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

logger

protected final org.apache.commons.logging.Log logger
Constructor Detail

AbstractFallbackTransactionAttributeSource

public AbstractFallbackTransactionAttributeSource()
Method Detail

getTransactionAttribute

public final TransactionAttribute getTransactionAttribute(java.lang.reflect.Method method,
                                                          java.lang.Class targetClass)
Return 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 - method for the current invocation. Can't be null
targetClass - target class for this invocation. May be null.
Returns:
TransactionAttribute for this method, or null if the method is non-transactional

findAllAttributes

protected abstract java.util.Collection findAllAttributes(java.lang.reflect.Method m)
Subclasses should implement this to return all attributes for this method. We need all because of the need to analyze rollback rules.

Parameters:
m - method to retrieve attributes for
Returns:
all attributes associated with this method. May return null.

findAllAttributes

protected abstract java.util.Collection findAllAttributes(java.lang.Class clazz)
Subclasses should implement this to return all attributes for this class.

Parameters:
clazz - class to retrieve attributes for
Returns:
all attributes associated with this class. May return null.

findTransactionAttribute

protected TransactionAttribute findTransactionAttribute(java.util.Collection atts)
Return the transaction attribute, given this set of attributes attached to a method or class. Protected rather than private as subclasses may want to customize how this is done: for example, returning a TransactionAttribute affected by the values of other attributes. This implementation takes into account RollbackRuleAttributes, if the TransactionAttribute is a RuleBasedTransactionAttribute. Return null if it's not transactional.

Parameters:
atts - attributes attached to a method or class. May be null, in which case a null TransactionAttribute will be returned.
Returns:
TransactionAttribute configured transaction attribute, or null if none was found


Copyright (C) 2003-2004 The Spring Framework Project.