This Axon Framework module provides support for the CDI programming model. It is a CDI portable extension integrating the Axon Framework and providing some intelligent defaults while still allowing for configuring overrides.
The current minimum supported versions are:
- Axon Framework 3.3.5
- CDI 1.2/Java EE 7
- Java SE 8
We have so far tested sucessfully against Payara, WildFly, JBoss EAP, TomEE and WebLogic. We will test the module with Thorntail (formerly WildFly Swarm) and WebSphere Liberty/Open Liberty. A contribution testing against WebSphere classic is welcome.
To use the module, simply add the following dependency from Maven Central:
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-cdi</artifactId>
<version>3.3-alpha1</version>
</dependency>
To use the snapshot version on the master branch, you will need to build it locally for the time being. Once you have built the artifact locally, simply add the following dependency:
<dependency>
<groupId>org.axonframework</groupId>
<artifactId>axon-cdi</artifactId>
<version>3.3-alpha2-SNAPSHOT</version>
</dependency>
The base Axon Framework is extremely powerful and flexible. What this extension does is to provide a number of sensible defaults for Axon applications while still allowing you reasonable configuration flexibility - including the ability to override defaults. As soon as you include the module in your project, you will be able to inject a number of Axon APIs into your code using CDI. These APIs represent the most important Axon Framework building blocks:
You can provide configuration overrides for the following Axon artifacts by creating CDI producers for them:
- EntityManagerProvider
- EventStorageEngine
- TransactionManager (in case of JTA, make sure this is a transaction manager that will work with JTA. For your convenience, we have provided a JtaTransactionManager that should work in most CMT and BMT situations.)
- EventBus
- CommandBus
- QueryBus
- CommandGateway
- QueryGateway
- TokenStore
- Serializer (both a global serializer and an event serializer may be overriden. To override an event serializer, please name the producer "eventSerializer" via the @Named annotation. It is purely optional, but you can use @Named to name your global serializer "serializer". If no @Named annotation is present, the serializer is assumed to be global)
- ErrorHandler
- ListenerInvocationErrorHandler
- CorrelationDataProvider
- ModuleConfiguration
- EventUpcaster
- Configurer
For more details on these objects and the Axon Framework, please consult the Axon Framework Reference Guide.
You can define aggregate roots by placing a simple annotation org.axonframework.cdi.stereotype.Aggregate on your class. It will be automatically collected by the CDI container and registered.
Event handlers and query handlers must be CDI beans. They will be automatically registered with Axon for you.
Please have a look at the examples in the example folder.
The Java EE example demonstrates usage inside any Java EE 7+ compatible application server much as Payara or WildFly. The example is a generic Maven web application you should be able to build on any IDE, generate a Java EE 7 war and deploy to your favorite application server. We have so far tested sucessfully against Payara, WildFly, JBoss EAP, TomEE and WebLogic.
For convenience, we have added Cargo configurations in separate Maven profiles for most supported and tested application servers.
- To run the example against WildFly, simply execute the Maven target:
mvn package cargo:run -Pwildfly - To run the example against JBoss EAP, simply execute the Maven target:
mvn package cargo:run -Pjboss - To run the example against TomEE, simply execute the Maven target:
mvn package cargo:run -Ptomee
The Java SE example demonstrates usage in a non-Java EE, Java SE environment that is CDI enabled (that could include a Servlet-only
environment with CDI). Note that while the extension targets CDI 1.1, the example uses the CDI 2 Java SE bootstrap API. It is also easily possible to
achieve the same functionality in CDI 1.1 using CDI implementation (such as Weld) specific Java SE bootstrap APIs (in the same vein it is possible to
use the CDI 2 Java SE bootstrap API in Servlet containers). The example is a generic Maven Java SE application you should be able to build on any
IDE, generate a Java SE executable jar and run from the command line using java -jar.
For convenience, we have added a Maven exec Java plugin in the Maven configuration. You can run the application by simply executing the
Maven target: mvn package exec:java
If you want to use the JPA based event store inside of a container (e.g. Payara or WildFly), you have to configure the following facilities:
- EntityManagerProvider
- TransactionManager (in case of JTA, make sure this is a transaction manager that will work with JTA. For your convenience, we have provided a JtaTransactionManager that should work in most CMT and BMT situations.)
- EventStorageEngine
- TokenStore
Please see the examples for details.
The module is currently in very early alpha state but is likely fairly feature complete. We are actively maturing it to a first release stage. We welcome early adopters and contributors.
The following are the known issues with the extension. Please also look at our GitHub issue tracker.
- We have tested but do not currently support GlassFish due to numerous critical bugs that have been fixed in GlassFish derivative Payara.
The work for Axon to support CDI started in the community. The earliest CDI support for Axon came from the following folks:
A few other folks took this community-driven work a step much further by more closely aligning with newer versions of Axon:
The official Axon support for CDI is based on the collective hard work of these folks in the community. AxonIQ is very grateful to all direct and indirect community contributors to this module.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent