Minor Releases

Any patch release made for an Axon project is tailored towards resolving bugs. This page aims to provide a dedicated overview of patch releases per project.

Release 4.5

Release 4.5.15

Enhancements

[#2290] TrackingEventProcessor does not wait for his worker threads to shut down #2292
TrackingEventProcessor does not wait for his worker threads to shut down #2290

Bug Fixes

Improve the concurrent behaviour of the tracking event processor. #2311
Fix a problem where when a shutdown takes places while the worklaunch… #2305
Remove update handler registration on UpdateHandlerRegistration#complete #2300
Canceled subscription query remains active if updates Flux is not subscribed, causing error on emit #2299
Fix duplicate command handler detection. #2298
TrackingEventProcessor cannot be reset immediately after shutdown in very rare cases #2293
[#2289] Incorrect warning message in case of shutdown timeout #2291
Incorrect warning message in case of shutdown timeout #2289
Duplicate command handler resolver is triggered in polymorphic aggregates #2243

Dependency Upgrade

Upgrade Axon Server Connector Java to 4.5.7 #2313
Bump mysql-connector-java from 8.0.29 to 8.0.30 #2303

Release 4.5.14

Bug Fixes

TrackingEventProcessors shutdown is not working correctly in 4.5.13 #2287
Snapshots are not read with snapshot filter and same serializer for events and snapshots #2286
Snapshots are not considered during loading of an Aggregate using Axon-Server-Connector #2285

Release 4.5.13

Features

Make the shutdown timeout configurable #1981

Enhancements

Pooled Streaming Event Processor configuration enhancement #2276
Introduce mechanism to interrupt TrackingEventProcessor worker threads #2041
Allow lifecycle phase timeout configuration #2037

Bug Fixes

Retry to initialize the token store correctly on exception for PSEP. #2277
Process events with identical TrackingToken together in the PooledStreamingEventProcessor #2275
PooledStreamingEventProcessor does not Retry if initialization fails #2274

Dependency Upgrade

Bump projectreactor.version from 3.4.20 to 3.4.21 #2284
Bump axonserver-connector-java from 4.5.4 to 4.5.5 #2278
Bump axonserver-connector-java from 4.5.5 to 4.5.6 #2282

Release 4.5.12

Bug Fixes

Ensure commands and queries are processed in FIFO order #2263
Commands with same priority are not handled in the correct order #2257

Release 4.5.11

Enhancements

Release announcement on discuss #2256

Bug Fixes

[#2242] Correctly support null-identifier and no-event scenarios from Command Handling constructors, Always, and Create-If-Missing creation policies #2248
Check attribute filter deep equals #2246
Fix Duplicate command handler resolver is triggered in polymorphic ag… #2245
Duplicate command handler resolver is triggered in polymorphic aggregates #2243
AggregateTestFixture throws AggregateNotFoundException when a command handler with a creation policy applies no events #2242

Dependency Upgrade

Bump spring-framework-bom from 5.3.20 to 5.3.21 #2255
Bump metrics-core from 4.1.31 to 4.1.32 #2247

Release 4.5.10

Axon's test fixtures perform a "deep equals" operation, using reflection as they go. JDK17, rightfully so, does not allow that for all classes. To solve scenarios where users utilize objects from, for example, java.lang, we have introduced a distinct DeepEqualsMatcher in pull request #2210. This matcher implementation considers the situation that an InaccessibleObjectException might be thrown from Axon's test fixtures, correctly dealing with the scenario by assuming the assertion failed.
Contributor fabio-couto noticed a predicament within the PooledStreamingEventProcessor (PSEP for short) when they were facing connectivity issues with their RDBMS. In the face of these issues, the PSEP coordinator is incapable of fetching events, resulting in canceled work packages. As part of canceling, the PSEP actively tries to release token claims, which is yet another database operation. This loop of several connectivity issues causes the PSEP to enter a state it could not recover from. Pull request #2225, provided by fabio-couto, solves this predicament.
A fix was introduced to the EventTypeUpcaster to solve issues further down the upcasting chain. Contributor dakr0013 noted that upcaster invoked after an EventTypeUpcaster failed because the expected intermediate event type was adjusted to Object. dakr0013 provided a pull request, which we made some adjustments in PR #2177 to accommodate additional scenarios.

You can check out the release notes when you're looking for an exhaustive list of all the changes.

Release 4.5.9

This release brings three adjustments worth mentioning to the framework, namely:

Contributor oysteing opened issue #2154, describing that the ReplayStatus enumeration never entered the REPLAY status for a PooledStreamingEventProcessor. We resolved this finding in pull request #2168 by ensuring the TrackingToken carries the replay status as intended.
The AggregateTestFixture incorrectly assumed a test succeeded in the absence of an exception when you would use the expectExceptionMessage validation step. We resolved this predicament in pull request #2127.
Lastly, we further upgraded the XStream dependency for a CVE in this pull request. This time, for CVE-2021-43859.

For an exhaustive list of the changes in 4.5.9, we refer to the release notes.

Release 4.5.8

This release brings two adjustments worth mentioning to the framework. Namely:

We spotted a bug within the PooledStreamingEventProcessor (PSEP). More specifically, whenever a subset of the tokens for the PSEP existed, calculating the lower bound of a token would cause failures. We addressed this predicament in pull request #2082.
We introduce an enhancement in the API of the CommandGateway. You can now directly insert MetaData whenever using the CommandGateway#send or CommandGateway#sendAndWait operations. You can verify the changes #here.

Release 4.5.7

This release contains a single fix. Namely, pull request #2067. This pull request solves a bug that had the PooledStreamingEventProcessor not handle new events resulting from an EventMultiUpcaster. The kudos for spotting the bug go to Magnus Heino, which started a discussion on our forum after he noticed the issue.

Release 4.5.6

Although Axon Framework doesn't use the log4j-core dependency directly, we updated it to the most recent version for ease of mind. You can follow these increments in issues #2038, #2040 and #2052.
Contributor jasperfect spotted a predicament with duplicate aggregate creation combined with using caches. Axon didn't invalidate the cache as it should have, causing unexpected behavior. You can find the issue description here. Additionally, you can find the pull request solving the problem here.
Contributor shubhojitr stated in issue #2051 that the axonserver-connector-java project pulled in a non-secure version of grpc-netty. As this isn't an issue on Axon Framework itself, we solved the problem under the connector project. As a follow-up, we incremented the framework's version for the axonserver-connector-java project to 4.5.4, which contains the most recent version of the grpc-bom.

For an exhaustive list of all the changes, check out the 4.5.6 release notes.

Release 4.5.5

The auto-configuration we introduced for XStream used a suboptimal approach. We assumed searching for the @ComponentScan would suffice but didn't consider that Spring enabled SpEL operations in the annotation's properties. This approach thus caused some applications to break on start-up. As such, this approach is replaced entirely by using the outcome of the AutoConfigurationPackages#get(BeanFactory) method. For those interested in the details of the solution, check out this pull request. Kudos to contributor maverick1601 for drafting issue #1963 explaining the predicament.
We introduced an optimization towards updating the TrackingToken. In (distributed) environments where the configuration states several segments per Streaming Processor, there are always threads receiving events that they're not in charge of due to the configured SequencingPolicy. The old implementation eagerly updated the token in such scenarios, but this didn't benefit the end-user immediately. Pull request #1999 introduce a wait period for 'event-less-batches', for both the TrackingEventProcessor and PooledStreamingEventProcessor. This adjustment minimizes the number of token updates performed by both processor implementations.
The introduction of Spring Boot version 2.6.0 brought an issue to light within Axon's Spring usage. The AbstractAnnotationHandlerBeanPostProcessor took FactoryBean instances into account when searching for message handling methods. This approach, however, is not recommended by Spring, which they enforced in their latest release. The result was circular dependency exceptions on start-up whenever somebody used Spring Boot 2.6.0. The fix was simple, though, as we should simply ignore FactoryBean instances. After spotting the issue, we resolved it in this pull request.

For an exhaustive list of all the changes, check out the 4.5.5 release notes.

Release 4.5.4

First and foremost, we updated the XStream version to 1.4.18. This upgrade was a requirement since several CVE's were noted for XStream version 1.4.17. As a consequence of XStream's solution imposed through the CVE's, everybody is required to specify the security context of an XStream instance. This change also has an impact on Axon Framework since the XStreamSerializer is the default serializer. So as of this release, any usages of the default XStreamSerializer will come with warnings, stating it is highly recommended to use an XStream instance for which the security context is set through types or wildcards. When your application uses Spring Boot, Axon will default to selecting the secured types based on your @ComponentScan annotated beans (e.g., like the @SpringBootApplication annotation). For those interested in the details of the solution, check out this pull request.
User 'nils-christian' noted in issue #1892 that Axon executed Upcaster beans in a Spring environment in the incorrect order. This ordering issue was due to a misconception in deducing the @Order annotation on upcaster beans. We resolved the problem in pull request #1895.
We noticed a TokenStore operation that Axon did not invoke within a transaction. In most scenarios, this worked out, but when using Micronaut, for example, this (correctly) caused an exception. After spotting the issue, we resolved it in this pull request.

For an exhaustive list of all the changes, check out the 4.5.4 release notes.

Release 4.5.3

One new feature has been introduced in 4.5.3: the PropertySequencingPolicy by contributor nils-christian. This sequencing policy can be configured to look for a common property in the events.
The version of the axonserver-connector-java has been updated to 4.5.2. This update resolves a troublesome issue around permit updates for subscription queries, which exhausted the number of queries an application could have running. For those curious about the solution, pull request 85 addresses this issue.
The WorkerLauncher runnable, used by the TrackingEventProcessor to start its threads, was not considered when you shut down a tracking processor. As a consequence, it could start new segment operations while shutdown already completed "successfully." Pull request 1866 resolves this problem, ensuring a tracking processor shuts down as intended.
Issue 1853 describes an issue where the creation policy always. Exceptions thrown from within a command handler annotated with @CreationPolicy(ALWAYS) weren't correctly propagated. Pull request 1854 solves this issue.

For an exhaustive list of all the changes, check out the 4.5.3 release notes.

Release 4.5.2

Added a missing isReplaying flag on the StreamingEventProcessor. Pull request #1821 reintroduces this functionality in this release.
Some enhancements in regards to logging Exceptions and stacktraces when initialization fails. This commit reintroduces this functionality in this release.
Improved Axon Framework (AxonServerEventStore) which will now rethrown Exceptions that has a valid Status.Code. Pull request #1842 reintroduces this functionality in this release.
General improvements on the PooledStreamingEventProcessor made across several Pull Requests.

For a detailed perspective on the release notes, please check this page.

Release 4.5.1

Some internals have changed concerning command handling exceptions. Within a single JVM, Axon Framework knows whether the exception is transient or not. This piece of information allows the RetryScheduler to retry a non-transient exception since those are retryable. With the move towards distributed environments, the information whether an exception is transient was lost when we moved to the dedicated CommandHandlingException containing a details object. Pull request #1742 reintroduces this functionality in this release.
The new RevisionSnapshotFilter introduced in release 4.5 sneaked in a bug by not validating the aggregate type upon filtering. Pull request #1771 describes and solves the problem by introducing the aggregate type to the RevisionSnapshotFilter.
By enabling the CreationPolicy for the DisruptorCommandBus, a timing issue was introduced with handling events. Contributor "junkdog" marked the problem in issue #1778, after which pull request #1792 solved it.
Contributor "michaelbub" noted in issue #1786 that resetting a StreamingEventProcessor to a point in the future reacted differently when no token was stored yet. This followed from the implementation of the ReplayToken, which wrongfully assumed that if the given 'token at reset' was null, the start position should be null too. However, the start position might be the future, and hence it should be used in favor of null. This issue is addressed under this pull request.

For a detailed perspective on the release notes, please check this page.

Release 4.4

Release 4.4.9

Release 4.4.9 of Axon Framework has incremented all used dependencies towards their latest bug release. This has done to resolve potentially security issues, as was reported with XStream 1.4.14 (that was resolved in 1.4.16).

For those looking for the set of adjustments please take a look at tag 4.4.9

Release 4.4.8

A bug was noted whenever a query handler returned a Future/CompletableFuture in combination with a subscription query, with Axon Server as the infrastructure. In this format, Axon would incorrectly use the scatter-gather query for the initial result of the subscription query. Whenever the returned result was completed, this didn't cause any issues. However, for a Future/CompletableFuture a TimeoutException would be thrown. The issue was luckily easily mitigated by changing the "number of expected results" from within the QueryRequest to default to 1 instead of zero. As an effect, the point-to-point would be invoked instead of scatter-gather. For reference, the issue can be found here.
Whenever an interface is used as the type of an @AggregateMember annotated field, Axon would throw a NullPointerException. This is far from friendly, and has been changed towards an AxonConfigurationException in pull request #1742.

Note that the named issues comprise the complete changelist for Axon Framework 4.4.8.

Release 4.4.7

The Axon Server Connector Java version 4.4.7 has been included in this release as well. As such, it's fixes (found here) are thus also part of this release.
Contributor "krosenvold" noticed that the SQL to retrieve a stream of events was performed twice in quick concession. The provided solution (in pull request #1689) would resolve this, but the problem was spotted to originate elsewhere. Commit 16b7152 saw an end to this occurrence by making a minor tweak in the EmbeddedEventStore.
As rightfully noticed by user "pepperbob", there was a type discrepancy when reading events through a tracking token. An event would always become a DomainEventMessage when read through the EventStorageEngine, whereas it might originally have been a regular EventMessage. The problem has been fixed in commit c61a95b. Furthermore, the entire description of the issue can be found here.
Through the use of the AxonServerQueryBus, a cancelled subscription query was wrongfully completed normally where it should complete exceptionally. This problem is marked and resolved under pull request #1695.

For a detailed perspective on the release notes, please check this page.

Release 4.4.6

Contributor "Rafaesp" noted that a registered CommandHandlerInterceptor in the AggregateTestFixture could be invoked more often than desired. This only occurred if the fixture's givenCommands(...) method was invoked, but nonetheless this behaviour was incorrect. The issue is marked under #1665 and resolved in pull request #1666.
In 4.4.4, a fix was introduced which ensured a ChildEntity (read, the Aggregate Members) was no longer duplicated in an aggregate hierarchy. This fix had the troublesome side effect that aggregate member command handlers weren't registered on every level of the aggregate hierarchy anymore. The resolution to this problem can be found in pull request #1674.
Using the subscription query in a distributed environment had a possible troublesome side effect. If a consumer of updates was closed for whatever reason, it could also close the producing side. This is obviously undesired, as no single consumer should influence if the producer should still dispatch updates to other consumers. The problem was marked under issue #1680 and resolved in this commit.
Right before we aimed to release 4.4.6, contributor "haraldk" provided a thorough issue description when using the SequenceEventStorageEngine. He noted that if snapshots were used for an aggregate, there was a window of opportunity that the 'active' EventStorageEngine in the sequencing engine did not return any events. This followed from the sequence number logic, which wrongfully defaulted to position "0", even though the starting sequence number is per definition higher if a snapshot has been found. The clarifying issue can be found here, with its resolution present in pull request #1683.

For a complete overview of all the changes you can check the release notes here.

Release 4.4.5

When creating a TrackingToken at a certain position through StreamableMessageSource#createTokenAt(Instant), a tail token was wrongfully returned if the provided timestamp exceeded the timestamp of the last event. Instead, the token closests to the provided timestamp should be returned, was equals the head token. This discrepancy between documentation and implementation was marked by mbreevoort and resolved in pull request #1607.
A certain path within the AxonServerEventStore allowed for event retrieval without correctly deserializing the MetaData of the events. If someone tried to access the MetaData, a CannotConvertBetweenTypesException was being thrown. This problem, among others, was remedied in pull request #1612, by ensuring the correct Serializer taking gRPC message types into account is consistently used.

For a complete set of the release notes, please check here.

Release 4.4.4

There was a bug which made it so that an @ResetHandler annotated method without any parameters was included for validation if a component could handle a specific type of event. This exact validation is used to filter out events from the event stream to optimize the entire stream. The optimization was thus mitigated by the simple fact of introducing a default @ResetHandler. The problem was marked by @kad-hesseg (for which thanks) and resolved in pull request #1597.
A new SnapshotTriggerDefinition called AggregateLoadTimeSnapShotTriggerDefinition has been introduced, which uses the load time of an aggregate to trigger a snapshot creation.
When using an aggregate class hierarchy, @AggregateMember annotated fields present on the root would be duplicated for every class in the hierarchy which included message handling functions. This problem was traced back to the AnnotatedAggregateMetaModelFactory.AnnotatedAggregateModel which looped over an inconsistent set of classes to find these members. The issue was marked by @kad-malota and resolved in pull request #1595.

For a complete set of the release notes, please check here.

Release 4.4.3

An optimization in the snapshotting process was introduced in pull request #1510. This PR ensures no unnecessary snapshots are staged in the AbstractSnapshotter by validating none have been scheduled yet. This fix will resolve potential high I.O. when snapshots are being recreated for aggregates which have a high number of events.
The assignment rules used by the EventProcessingConfigurer weren't always taken into account as desired. This inconsistency compared to regular assignment through the @ProcessingGroup annotation has been resolved in this pull request.
Heartbeat messages between Axon Server and an Axon Framework application were already configurable, but only from the server's side. Properties have been introduced to also enables this from the clients end, as specified further in this pull request. Enabling heartbeat messages will ensure the connection is preemptively closed if no response has been received in the configured time frame.

To check out all fixes introduced in 4.4.3, you can check them out on this page.

Release 4.4.2

A persistent loop of 500ms was spotted during event consumption from Axon Server. Credits go to Damir Murat who has spotted the issue. With his help the issue was found quickly and eventually resolved in pull request #1484.
A serialization issue was found when working with the ConfigToken and de-/serialize it through the JacksonSerializer. This problem was uncovered in issue #1482 and resolved in pull request #1485.
The introduction of the AxonServer Connector for Java to simplify the framework's integration with Axon Server introduced some configuration issues. For example, the AxonServerConfiguration#isForceReadFromLeader wasn't used when opening an event stream (resolved in PR #1488).
Furthermore, properties like the max-message-size, gRPC keep alive settings and processorNotificationRate weren't used when forming a connection with Axon Server. This issue was covered by pull request #1487.

This page shares a complete list of all resolved issues for this release.

Release 4.4.1

A single fix was performed as soon as possible to release 4.4, in conjunction with the new Axon Server Connector used by this release. There was an off by one scenario when an Event Processor started reading events from the beginning of time. This meant that the first event in the event store was systematically skipped. The bug was resolved in this commit.