类 TransactionAspectSupport

字段详细资料

• logger

  protected final Log logger

构造器详细资料

• TransactionAspectSupport

  public TransactionAspectSupport()

方法详细资料

• currentTransactionInfo

  protected static TransactionAspectSupport.TransactionInfo currentTransactionInfo()
                                                                            throws NoTransactionException

  Subclasses can use this to return the current TransactionInfo. Only subclasses that cannot handle all operations in one method, such as an AspectJ aspect involving distinct before and after advice, need to use this mechanism to get at the current TransactionInfo. An around advice such as an AOP Alliance MethodInterceptor can hold a reference to the TransactionInfo throughout the aspect method.

  A TransactionInfo will be returned even if no transaction was created. The TransactionInfo.hasTransaction() method can be used to query this.

  To find out about specific transaction characteristics, consider using TransactionSynchronizationManager's isSynchronizationActive() and/or isActualTransactionActive() methods.

  返回:

  the TransactionInfo bound to this thread, or null if none

  抛出:

  NoTransactionException

  另请参阅:

  TransactionAspectSupport.TransactionInfo.hasTransaction(), TransactionSynchronizationManager.isSynchronizationActive(), TransactionSynchronizationManager.isActualTransactionActive()

• currentTransactionStatus

  public static TransactionStatus currentTransactionStatus()
                                                    throws NoTransactionException

  Return the transaction status of the current method invocation. Mainly intended for code that wants to set the current transaction rollback-only but not throw an application exception.

  抛出:

  NoTransactionException - if the transaction info cannot be found, because the method was invoked outside an AOP invocation context

• setTransactionManagerBeanName

  public void setTransactionManagerBeanName​(String transactionManagerBeanName)

  Specify the name of the default transaction manager bean.

• getTransactionManagerBeanName

  protected final String getTransactionManagerBeanName()

  Return the name of the default transaction manager bean.

• setTransactionManager

  public void setTransactionManager​(PlatformTransactionManager transactionManager)

  Specify the default transaction manager to use to drive transactions.

  The default transaction manager will be used if a qualifier has not been declared for a given transaction or if an explicit name for the default transaction manager bean has not been specified.

  另请参阅:

  setTransactionManagerBeanName(java.lang.String)

• getTransactionManager

  public PlatformTransactionManager getTransactionManager()

  Return the default transaction manager, or null if unknown.

• setTransactionAttributes

  public void setTransactionAttributes​(Properties transactionAttributes)

  Set properties with method names as keys and transaction attribute descriptors (parsed via TransactionAttributeEditor) as values: e.g. key = "myMethod", value = "PROPAGATION_REQUIRED,readOnly".

  Note: Method names are always applied to the target class, no matter if defined in an interface or the class itself.

  Internally, a NameMatchTransactionAttributeSource will be created from the given properties.

  另请参阅:

  setTransactionAttributeSource(org.springframework.transaction.interceptor.TransactionAttributeSource), TransactionAttributeEditor, NameMatchTransactionAttributeSource

• setTransactionAttributeSources

  public void setTransactionAttributeSources​(TransactionAttributeSource... transactionAttributeSources)

  Set multiple transaction attribute sources which are used to find transaction attributes. Will build a CompositeTransactionAttributeSource for the given sources.

  另请参阅:

  CompositeTransactionAttributeSource, MethodMapTransactionAttributeSource, NameMatchTransactionAttributeSource, AnnotationTransactionAttributeSource

• setTransactionAttributeSource

  public void setTransactionAttributeSource​(TransactionAttributeSource transactionAttributeSource)

  Set the transaction attribute source which is used to find transaction attributes. If specifying a String property value, a PropertyEditor will create a MethodMapTransactionAttributeSource from the value.

  另请参阅:

  TransactionAttributeSourceEditor, MethodMapTransactionAttributeSource, NameMatchTransactionAttributeSource, AnnotationTransactionAttributeSource

• getTransactionAttributeSource

  public TransactionAttributeSource getTransactionAttributeSource()

  Return the transaction attribute source.

• setBeanFactory

  public void setBeanFactory​(BeanFactory beanFactory)

  Set the BeanFactory to use for retrieving PlatformTransactionManager beans.

  指定者:

  setBeanFactory 在接口中 BeanFactoryAware

  参数:

  beanFactory - owning BeanFactory (never null). The bean can immediately call methods on the factory.

  另请参阅:

  BeanInitializationException

• getBeanFactory

  protected final BeanFactory getBeanFactory()

  Return the BeanFactory to use for retrieving PlatformTransactionManager beans.

• afterPropertiesSet

  public void afterPropertiesSet()

  Check that required properties were set.

  指定者:

  afterPropertiesSet 在接口中 InitializingBean

• invokeWithinTransaction

  protected Object invokeWithinTransaction​(Method method,
                                           Class<?> targetClass,
                                           TransactionAspectSupport.InvocationCallback invocation)
                                    throws Throwable

  General delegate for around-advice-based subclasses, delegating to several other template methods on this class. Able to handle CallbackPreferringPlatformTransactionManager as well as regular PlatformTransactionManager implementations.

  参数:

  method - the Method being invoked

  targetClass - the target class that we're invoking the method on

  invocation - the callback to use for proceeding with the target invocation

  返回:

  the return value of the method, if any

  抛出:

  Throwable - propagated from the target invocation

• clearTransactionManagerCache

  protected void clearTransactionManagerCache()

  Clear the transaction manager cache.

• determineTransactionManager

  protected PlatformTransactionManager determineTransactionManager​(TransactionAttribute txAttr)

  Determine the specific transaction manager to use for the given transaction.

• methodIdentification

  protected String methodIdentification​(Method method,
                                        Class<?> targetClass)

  Convenience method to return a String representation of this Method for use in logging. Can be overridden in subclasses to provide a different identifier for the given method.

  The default implementation returns null, indicating the use of DefaultTransactionAttribute.getDescriptor() instead, ending up as ClassUtils.getQualifiedMethodName(Method, Class).

  参数:

  method - the method we're interested in

  targetClass - the class that the method is being invoked on

  返回:

  a String representation identifying this method

  另请参阅:

  ClassUtils.getQualifiedMethodName(java.lang.reflect.Method)

• createTransactionIfNecessary

  protected TransactionAspectSupport.TransactionInfo createTransactionIfNecessary​(PlatformTransactionManager tm,
                                                                                  TransactionAttribute txAttr,
                                                                                  String joinpointIdentification)

  Create a transaction if necessary based on the given TransactionAttribute.

  Allows callers to perform custom TransactionAttribute lookups through the TransactionAttributeSource.

  参数:

  txAttr - the TransactionAttribute (may be null)

  joinpointIdentification - the fully qualified method name (used for monitoring and logging purposes)

  返回:

  a TransactionInfo object, whether or not a transaction was created. The hasTransaction() method on TransactionInfo can be used to tell if there was a transaction created.

  另请参阅:

  getTransactionAttributeSource()

• prepareTransactionInfo

  protected TransactionAspectSupport.TransactionInfo prepareTransactionInfo​(PlatformTransactionManager tm,
                                                                            TransactionAttribute txAttr,
                                                                            String joinpointIdentification,
                                                                            TransactionStatus status)

  Prepare a TransactionInfo for the given attribute and status object.

  参数:

  txAttr - the TransactionAttribute (may be null)

  joinpointIdentification - the fully qualified method name (used for monitoring and logging purposes)

  status - the TransactionStatus for the current transaction

  返回:

  the prepared TransactionInfo object

• commitTransactionAfterReturning

  protected void commitTransactionAfterReturning​(TransactionAspectSupport.TransactionInfo txInfo)

  Execute after successful completion of call, but not after an exception was handled. Do nothing if we didn't create a transaction.

  参数:

  txInfo - information about the current transaction

• completeTransactionAfterThrowing

  protected void completeTransactionAfterThrowing​(TransactionAspectSupport.TransactionInfo txInfo,
                                                  Throwable ex)

  Handle a throwable, completing the transaction. We may commit or roll back, depending on the configuration.

  参数:

  txInfo - information about the current transaction

  ex - throwable encountered

• cleanupTransactionInfo

  protected void cleanupTransactionInfo​(TransactionAspectSupport.TransactionInfo txInfo)

  Reset the TransactionInfo ThreadLocal.

  Call this in all cases: exception or normal return!

  参数:

  txInfo - information about the current transaction (may be null)