Spring/spring-modulith
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

GH-322 - Move @ApplicationModuleListener into ….modulith.events in spring-modulith-events-api.

Browse Source
This commit is contained in:
Oliver Drotbohm
2023-10-15 17:13:45 +02:00
parent c8b81e0737
commit db1c2b813e
11 changed files with 77 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
spring-modulith-api/src/main/java/org/springframework/modulith/ApplicationModuleListener.java
View File

@@ -28,18 +28,20 @@ import org.springframework.transaction.annotation.Transactional;
import org.springframework.transaction.event.TransactionalEventListener;
/**
* An {@link ApplicationModuleListener} is an {@link Async} Spring {@link TransactionalEventListener} that
* runs in a transaction itself. Thus, the annotation serves as syntactic sugar for the generally recommend setup to
* integrate application modules via events. The setup makes sure that an original business transaction completes
* successfully and the integration asynchronously runs in a transaction itself to decouple the integration as much as
* possible from the original unit of work.
* An {@link ApplicationModuleListener} is an {@link Async} Spring {@link TransactionalEventListener} that runs in a
* transaction itself. Thus, the annotation serves as syntactic sugar for the generally recommend setup to integrate
* application modules via events. The setup makes sure that an original business transaction completes successfully and
* the integration asynchronously runs in a transaction itself to decouple the integration as much as possible from the
* original unit of work.
* <p>
* It is advisable that you use these integration listeners in combination with the Spring Modulith Event Publication
* Registry to make sure that the event publication does not get lost in case of an application or listener failure.
*
* @author Oliver Drotbohm
* @see <a href="https://docs.spring.io/spring-modulith/docs/current/reference/html/#events.publication-registry">Spring
* Modulith Event Publication Registry - Reference Documentation</a>
* @deprecated since, 1.1. Prefer {@code org.springframework.modulith.events.ApplicationModuleListener} in
* {@code spring-modulith-events-api}.
* @see <a href="https://docs.spring.io/spring-modulith/reference/events.html#publication-registry">Spring Modulith
* Event Publication Registry - Reference Documentation</a>
*/
@Async
@Transactional(propagation = Propagation.REQUIRES_NEW)
@@ -47,6 +49,7 @@ import org.springframework.transaction.event.TransactionalEventListener;
@Documented
@Target({ ElementType.METHOD, ElementType.ANNOTATION_TYPE })
@Retention(RetentionPolicy.RUNTIME)
@Deprecated(since = "1.1", forRemoval = true)
public @interface ApplicationModuleListener {
/**