Top Description Fields Constructors Methods
org.springframework.transaction.interceptor

public Class NameMatchTransactionAttributeSource

extends Object
implements TransactionAttributeSource, EmbeddedValueResolverAware, InitializingBean, Serializable
Class Inheritance
All Implemented Interfaces
java.io.Serializable, org.springframework.beans.factory.InitializingBean, org.springframework.context.EmbeddedValueResolverAware, org.springframework.beans.factory.Aware, org.springframework.transaction.interceptor.TransactionAttributeSource
Annotations
@SuppressWarnings:serial
Imports
java.io.Serializable, java.lang.reflect.Method, java.util.Enumeration, .HashMap, .Map, .Properties, org.apache.commons.logging.Log, .LogFactory, org.springframework.beans.factory.InitializingBean, org.springframework.context.EmbeddedValueResolverAware, org.springframework.lang.Nullable, org.springframework.util.ClassUtils, .ObjectUtils, .PatternMatchUtils, .StringValueResolver

Simple TransactionAttributeSource implementation that allows attributes to be matched by registered name.
Author
Juergen Hoeller
Since
21.08.2003
See Also
isMatch, MethodMapTransactionAttributeSource

Field Summary

Modifier and TypeField and Description
private StringValueResolver
protected static final Log
logger

Logger available to subclasses.

private final Map<String, TransactionAttribute>
nameMap

Keys are method names; values are TransactionAttributes.

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public void
addTransactionalMethod(String
the name of the method
methodName
,
TransactionAttribute
attribute associated with the method
attr
)

Add an attribute for a transactional method.

public void
afterPropertiesSet()

Implements org.springframework.beans.factory.InitializingBean.afterPropertiesSet.

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

public boolean
equals(Object
the reference object with which to compare.
other
)

Overrides java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.
public TransactionAttribute
getTransactionAttribute(Method
the method to introspect
method
,
Class<?>
the target class (may be null, in which case the declaring class of the method must be used)
targetClass
)

Implements org.springframework.transaction.interceptor.TransactionAttributeSource.getTransactionAttribute.

Return the transaction attribute for the given method, or null if the method is non-transactional.
public int
hashCode()

Overrides java.lang.Object.hashCode.

Returns a hash code value for the object.
protected boolean

Returns:

true if the names match
isMatch
(String
the method name of the class
methodName
,
String
the name in the descriptor
mappedName
)

Determine if the given method name matches the mapped name.

public void
setEmbeddedValueResolver(StringValueResolver resolver)

Implements org.springframework.context.EmbeddedValueResolverAware.setEmbeddedValueResolver.

Set the StringValueResolver to use for resolving embedded definition values.
public void
setNameMap(Map<String, TransactionAttribute> nameMap)

Set a name/attribute map, consisting of method names (e.g. "myMethod") and TransactionAttribute instances.

public void
setProperties(Properties transactionAttributes)

Parse the given properties into a name/attribute map.

public String
toString()

Overrides java.lang.Object.toString.

Returns a string representation of the object.
Inherited from java.lang.Object:
clonefinalizegetClassnotifynotifyAllwaitwaitwait

Field Detail

embeddedValueResolverback to summary
private StringValueResolver embeddedValueResolver
Annotations
@Nullable
loggerback to summary
protected static final Log logger

Logger available to subclasses.

Static for optimal serialization.

nameMapback to summary
private final Map<String, TransactionAttribute> nameMap

Keys are method names; values are TransactionAttributes.

Constructor Detail

NameMatchTransactionAttributeSourceback to summary
public NameMatchTransactionAttributeSource()

Method Detail

addTransactionalMethodback to summary
public void addTransactionalMethod(String methodName, TransactionAttribute attr)

Add an attribute for a transactional method.

Method names can be exact matches, or of the pattern "xxx*", "*xxx", or "*xxx*" for matching multiple methods.

Parameters
methodName:String

the name of the method

attr:TransactionAttribute

attribute associated with the method

afterPropertiesSetback to summary
public void afterPropertiesSet()

Implements org.springframework.beans.factory.InitializingBean.afterPropertiesSet.

Doc from org.springframework.beans.factory.InitializingBean.afterPropertiesSet.

Invoked by the containing BeanFactory after it has set all bean properties and satisfied BeanFactoryAware, ApplicationContextAware etc.

This method allows the bean instance to perform validation of its overall configuration and final initialization when all bean properties have been set.

Annotations
@Override
equalsback to summary
public boolean equals(Object other)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

  • It is reflexive: for any non-null reference value x, x.equals(x) should return true.
  • It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
  • It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
  • It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
  • For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters
other:Object

the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations
@Override
getTransactionAttributeback to summary
public TransactionAttribute getTransactionAttribute(Method method, Class<?> targetClass)

Implements org.springframework.transaction.interceptor.TransactionAttributeSource.getTransactionAttribute.

Doc from org.springframework.transaction.interceptor.TransactionAttributeSource.getTransactionAttribute.

Return the transaction attribute for the given method, or null if the method is non-transactional.

Parameters
method:Method

the method to introspect

targetClass:Class<?>

the target class (may be null, in which case the declaring class of the method must be used)

Returns:TransactionAttribute

the matching transaction attribute, or null if none found

Annotations
@Override
@Nullable
hashCodeback to summary
public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
Returns:int

a hash code value for this object.

Annotations
@Override
isMatchback to summary
protected boolean isMatch(String methodName, String mappedName)

Determine if the given method name matches the mapped name.

The default implementation checks for "xxx*", "*xxx", and "*xxx*" matches, as well as direct equality. Can be overridden in subclasses.

Parameters
methodName:String

the method name of the class

mappedName:String

the name in the descriptor

Returns:boolean

true if the names match

See Also
org.springframework.util.PatternMatchUtils#simpleMatch(String, String)
setEmbeddedValueResolverback to summary
public void setEmbeddedValueResolver(StringValueResolver resolver)

Implements org.springframework.context.EmbeddedValueResolverAware.setEmbeddedValueResolver.

Doc from org.springframework.context.EmbeddedValueResolverAware.setEmbeddedValueResolver.

Set the StringValueResolver to use for resolving embedded definition values.

Annotations
@Override
setNameMapback to summary
public void setNameMap(Map<String, TransactionAttribute> nameMap)

Set a name/attribute map, consisting of method names (e.g. "myMethod") and TransactionAttribute instances.

See Also
setProperties, TransactionAttribute
setPropertiesback to summary
public void setProperties(Properties transactionAttributes)

Parse the given properties into a name/attribute map.

Expects method names as keys and String attributes definitions as values, parsable into TransactionAttribute instances via a TransactionAttributeEditor.

See Also
setNameMap, TransactionAttributeEditor
toStringback to summary
public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object.

Annotations
@Override