root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 8 Packages Projects Releases Wiki Activity

Polish @Transactional documentation in reference manual

This commit is contained in:
Sam Brannen 2020-05-07 18:42:02 +02:00
parent 247662de6b
commit 21800a5fa6
1 changed files with 13 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
src/docs/asciidoc/data-access.adoc
View File

@ -1443,11 +1443,12 @@ name of the transaction would be: `com.example.BusinessService.handlePayment`.
Most Spring applications need only a single transaction manager, but there may be Most Spring applications need only a single transaction manager, but there may be
situations where you want multiple independent transaction managers in a single situations where you want multiple independent transaction managers in a single
application. You can use the `value` attribute of the `@Transactional` annotation to application. You can use the `value` or `transactionManager` attribute of the
optionally specify the identity of the `PlatformTransactionManager` to be used. `@Transactional` annotation to optionally specify the identity of the
This can either be the bean name or the qualifier value of the transaction manager bean. `PlatformTransactionManager` to be used. This can either be the bean name or the
For example, using the qualifier notation, you can combine the following Java code with qualifier value of the transaction manager bean. For example, using the qualifier
the following transaction manager bean declarations in the application context: notation, you can combine the following Java code with the following transaction manager
bean declarations in the application context:
[source,java,indent=0,subs="verbatim,quotes",role="primary"] [source,java,indent=0,subs="verbatim,quotes",role="primary"]
.Java .Java
@ -1501,11 +1502,11 @@ managers, differentiated by the `order` and `account` qualifiers. The default
specifically qualified `PlatformTransactionManager` bean is found. specifically qualified `PlatformTransactionManager` bean is found.
[[tx-custom-attributes]] [[tx-custom-attributes]]
===== Custom Shortcut Annotations ===== Custom Composed Annotations
If you find you repeatedly use the same attributes with `@Transactional` on many different If you find you repeatedly use the same attributes with `@Transactional` on many different
methods, <<core.adoc#beans-meta-annotations, Spring's meta-annotation support>> lets you methods, <<core.adoc#beans-meta-annotations, Spring's meta-annotation support>> lets you
define custom shortcut annotations for your specific use cases. For example, consider the define custom composed annotations for your specific use cases. For example, consider the
following annotation definitions: following annotation definitions:
[source,java,indent=0,subs="verbatim,quotes",role="primary"] [source,java,indent=0,subs="verbatim,quotes",role="primary"]
@ -1513,13 +1514,13 @@ following annotation definitions:
---- ----
@Target({ElementType.METHOD, ElementType.TYPE}) @Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME) @Retention(RetentionPolicy.RUNTIME)
@Transactional(value = "order", label = "causal-consistency") @Transactional(transactionManager = "order", label = "causal-consistency")
public @interface OrderTx { public @interface OrderTx {
} }
@Target({ElementType.METHOD, ElementType.TYPE}) @Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME) @Retention(RetentionPolicy.RUNTIME)
@Transactional(value = "account", label = "retryable") @Transactional(transactionManager = "account", label = "retryable")
public @interface AccountTx { public @interface AccountTx {
} }
---- ----
@ -1528,16 +1529,16 @@ following annotation definitions:
---- ----
@Target(AnnotationTarget.FUNCTION, AnnotationTarget.TYPE) @Target(AnnotationTarget.FUNCTION, AnnotationTarget.TYPE)
@Retention(AnnotationRetention.RUNTIME) @Retention(AnnotationRetention.RUNTIME)
@Transactional(value = "order", label = ["causal-consistency"]) @Transactional(transactionManager = "order", label = ["causal-consistency"])
annotation class OrderTx annotation class OrderTx
@Target(AnnotationTarget.FUNCTION, AnnotationTarget.TYPE) @Target(AnnotationTarget.FUNCTION, AnnotationTarget.TYPE)
@Retention(AnnotationRetention.RUNTIME) @Retention(AnnotationRetention.RUNTIME)
@Transactional(value = "account", label = ["retryable"]) @Transactional(transactionManager = "account", label = ["retryable"])
annotation class AccountTx annotation class AccountTx
---- ----
The preceding annotations lets us write the example from the previous section as follows: The preceding annotations let us write the example from the previous section as follows:
[source,java,indent=0,subs="verbatim,quotes",role="primary"] [source,java,indent=0,subs="verbatim,quotes",role="primary"]
.Java .Java