1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// org.springframework.transaction.annotation.EnableTransactionManagement
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Import(TransactionManagementConfigurationSelector.class)
public @interface EnableTransactionManagement {

	// 指示是否要创建基于子类的（CGLIB）代理（`true`），而不是基于标准 Java 接口的代理（`false`）。
    // 默认值为 `false`。仅在 `mode()` 设置为 `AdviceMode.PROXY` 时适用。
    // 请注意，将此属性设置为 `true` 将影响所有需要代理的 Spring 管理的 Bean，而不仅仅是那些标记为 `@Transactional` 的 Bean。
    // 例如，标记为 Spring 的 `@Async` 注解的其他 Bean 也会同时升级为子类代理。在实践中，这种方法通常不会产生负面影响，除非明确期望一种类型的代理而不是另一种，例如在测试中。
	boolean proxyTargetClass() default false;

	// 指示事务通知应该如何应用。
    // 默认值是 `AdviceMode.PROXY`。
    // 请注意，代理模式仅允许拦截通过代理进行的调用。同一类内的本地调用无法以这种方式被拦截；在本地调用中，`@Transactional` 注解的方法将被忽略，因为 Spring 的拦截器在这种运行时场景中甚至不会启动。
    // 对于更高级的拦截模式，可以考虑将其切换为 `AdviceMode.ASPECTJ`。
	AdviceMode mode() default AdviceMode.PROXY;

	// 指示当多个通知应用于特定连接点时，事务通知器的执行顺序。
    // 默认值为 Ordered.LOWEST_PRECEDENCE。
	int order() default Ordered.LOWEST_PRECEDENCE;

}    

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

// org.springframework.transaction.annotation.Transactional
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Transactional {
    // 参见 transactionManager
	@AliasFor("transactionManager")
	String value() default "";

    // 指定事务的限定符值。
    // 可用于确定目标事务管理器，匹配特定事务管理器 Bean 定义的限定符值（或 Bean 名称）。
	@AliasFor("value")
	String transactionManager() default "";

    // 定义零个或多个事务标签。
    // 标签可用于描述事务，并且可以由各个事务管理器进行评估。标签可能仅用于描述目的，也可以映射到预定义的事务管理器特定选项。
	String[] label() default {};

    // 事务传播类型。
    // 默认值为 Propagation.REQUIRED。
	Propagation propagation() default Propagation.REQUIRED;

    // 事务隔离级别。
    // 默认值为 Isolation.DEFAULT。
    // 仅适用于 Propagation.REQUIRED 或 Propagation.REQUIRES_NEW，因为它仅适用于新启动的事务。
    // 如果您希望在参与具有不同隔离级别的现有事务时拒绝隔离级别声明，请考虑将事务管理器的 "validateExistingTransactions" 标志设置为 "true"。
	Isolation isolation() default Isolation.DEFAULT;

    // 此事务的超时时间（以秒为单位）。
    // 默认值为底层事务系统的默认超时时间。
    // 仅适用于 Propagation.REQUIRED 或 Propagation.REQUIRES_NEW，因为它仅适用于新启动的事务。
    // 禁止`timeout`与`timeoutString`同时配置。
	int timeout() default TransactionDefinition.TIMEOUT_DEFAULT;

    // 此事务的超时时间（以秒为单位）。
    // 默认值为底层事务系统的默认超时时间。
    // 仅适用于 Propagation.REQUIRED 或 Propagation.REQUIRES_NEW，因为它仅适用于新启动的事务。
    // 禁止`timeout`与`timeoutString`同时配置。
	String timeoutString() default "";

    // 一个布尔标志，如果事务实际上是只读的，可以将其设置为 true，从而在运行时允许进行相应的优化。
    // 默认值为 false。
    // 这只是一个对实际事务子系统的提示；它不会必然导致写入访问尝试失败。无法解释只读提示的事务管理器在被要求提供只读事务时不会抛出异常，而是会默默地忽略该提示。
	boolean readOnly() default false;

    // 配置回滚规则
	Class<? extends Throwable>[] rollbackFor() default {};

    // 配置回滚规则
	String[] rollbackForClassName() default {};

    // 配置回滚规则
	Class<? extends Throwable>[] noRollbackFor() default {};

    // 配置回滚规则
	String[] noRollbackForClassName() default {};

}