Axoniq Framework Major Releases

All the enhancements and features which have been introduced to our major releases of the Axoniq Framework are noted here.

Release 5.4

Features

Enhancements

Bug fixes

  • Distinguish a rejected append from an undetermined one (#299, PR #300, by @schananas)

  • Collect QueryResponseMessages when clientSupportsStreaming is false to support list-queries from AF4 into AF5 (PR #358, by @smcvb)

  • Use repeatable read isolation for query with 2 statements (PR #369, by @hjohn)

  • Ensure DistributedQueryBus adheres to ProcessingContext lifecycle for subscription query operations (#317, PR #375, by @smcvb)

  • Don’t assume autocommit is false (PR #382, by @hjohn)

  • Multi-tenant QueryBus closes subscription query streams upon tenant removal (PR #385, by @smcvb)

  • fix(connector): subscribe a command or query name exactly once (PR #389, by @abuijze)

  • Process entire batch in PersistentStreamConnection regardless of closed PersistentStreamSegment (PR #392, by @smcvb)

  • Fix silently skipped *IntegrationTest.java tests; rely on Surefire/Failsafe defaults (PR #459, by @hjohn)

  • Fix time parsing and false SUCCESS on timeout (PR #465, by @hjohn)

  • Fix Axon Server test license CI path after integrationtests split (PR #470, by @hjohn)

  • Gate retry attempts behind an accepted RETRY_STARTED append (#408, PR #472, by @schananas)

  • fix(407): StepIndeterminateException keeps its type across the durable round-trip (#407, PR #474, by @schananas)

  • Fix memory leak in AxonServerCommandBusConnector (#476, PR #477, by @hatzlj)

  • ServiceLoader for DeadLetterMultiTenancyConfigurationEnhancer fails when multi-tenancy is used without the DLQ module (#480, PR #495, by @jangalinski)

  • fix persistent streams autoconfig ordering after optional dead…​ (#504, PR #505, by @hatzlj)

  • Workflow: start the engine processor at the head of the stream, use the engine Clock for step events (PR #512, by @schananas)

  • Don’t fail fingerprint script when reactor has zero SNAPSHOT deps (PR #514, by @hjohn)

  • Fix decorator spy test double and re-enable snapshotter IT tests (PR #525, by @hjohn)

  • Fix dead letter processor resolution for multiply decorated event handling components (#531, PR #533, by @hatzlj)

  • Keep a workflow instance registered when its body stops without ending (#479, PR #534, by @schananas)

  • Harmonized API between WorkflowState and WorkflowContext (#539, PR #540, by @zambrovski)

  • Re-enable SpringBootJdbcDeadLetteringIT and SpringBootJpaDeadLetteringIT (#460, PR #543, by @hjohn)

  • Hold the workflow checkpoint until a wake’s completion is durable (#551, PR #553, by @schananas)

  • Allow null values in the workflow payload snapshot (#536, PR #555, by @schananas)

  • Spring Cloud connector: fix lost and dropped subscription query updates (PR #570, by @MateuszNaKodach)

  • Ensure all Persistent Stream events are actually read (PR #571, by @smcvb)

  • Enable and finalize WorkflowConfigurerTest (#427, PR #580, by @smcvb)

  • Make the Spring Boot starter depend on the Axon Server connector (PR #591, by @abuijze)

  • Spring Cloud connector: identify members by node id, support Kubernetes discovery (#577, PR #600, by @abuijze)

  • Spring Cloud connector: announce leaving on subscription queries at a clean shutdown (#586, PR #602, by @abuijze)

  • DLQ Metadata conversion - read as HashMap i.o. Map (#601, PR #605, by @smcvb)

  • Save workflow checkpoints inside the Spring transaction (#587, PR #606, by @schananas)

Documentation

Contributors

A heartfelt thank you to all contributors who worked on this section:

Release 5.3

Features

Enhancements

  • Split off big parts from PostgresqlEventStorageEngine to reduce the main engine code size (PR #248, by @hjohn)

  • EventStorageEngine#source and SnapshotStore methods - add ProcessingContext parameter (PR #255, by @MateuszNaKodach)

  • Add mutual TLS configuration properties for Axon Server connections (PR #256, by @abuijze)

  • Disable some tests for coordination with Axon Framework (PR #264, by @hjohn)

  • Improve watch.js for local doc rendering / improve docs readme / gitignore localLinks (PR #267, by @hatzlj)

  • Switch default test SLF4J binding from Logback to Log4j2 (PR #269, by @hjohn)

  • DistributedQueryBus include and-count emit, complete, and completeExceptionally operations (PR #277, by @smcvb)

  • Enable multi-tenancy by default when on the classpath a…​ (#258, PR #303, by @hatzlj)

  • Fix connection-pool leak and starved common pool on CI (PR #306, by @hjohn)

  • Make all SnapshotStore implementations DescribableComponents (PR #312, by @smcvb)

  • Implement describeTo for SpanFactory implementations (PR #314, by @MateuszNaKodach)

  • Align CLAUDE.md wildcard-import rule with .editorconfig (PR #328, by @hatzlj)

  • Add entitlement checks for Micrometer Tracing (PR #334, by @MateuszNaKodach)

Bug fixes

  • Release notes fix - Move bug fix from 5.1.2 to 5.2.0 (PR #249, by @smcvb)

  • Fix incorrect token position assumption in MultiStreamableEventSourceTest (PR #297, by @hjohn)

  • Increase AxonServerContainer startup timeout to 2 minutes and log slow starts (PR #301, by @hjohn)

  • Fix tracing integration tests failing under default-on multi-tenancy (PR #325, by @laura-devriendt-lemon)

  • HandlerExecutionException details are carried over (#323, PR #326, by @smcvb)

  • Fix event metadata dropped on append in AggregateBasedAxonServerEventStorageEngine (#330, PR #332, by @hatzlj)

  • Multi-tenant application shutdown blows the lifecycle phase budget and can leak live connectors (#319, PR #333, by @jangalinski)

Documentation

Dependency upgrades

  • Bump actions/setup-java from 5.4.0 to 5.5.0 in the GitHub dependencies group across 1 directory (PR #231)

  • Bump the maven-dependencies group with 3 updates (PR #232)

  • Bump slackapi/slack-GitHub-action from 3.0.3 to 3.0.5 in the GitHub dependencies group (PR #246)

  • Bump the maven-dependencies group with 2 updates (PR #247)

  • chore(deps): bump the GitHub dependencies group with 3 updates (PR #272)

  • chore(deps): bump the maven-dependencies group with 2 updates (PR #273)

  • chore(deps-dev): bump body-parser from 2.2.1 to 2.3.0 in /docs/_playbook (PR #275)

  • chore(deps): bump brace-expansion and @asciidoctor/core in /docs/_playbook (PR #276)

  • chore(deps): bump the maven-dependencies group with 4 updates (PR #290)

  • Upgrade the entitlement manager to 1.1.0 (PR #304, by @smcvb)

  • chore(deps): bump the maven-dependencies group across 1 directory with 7 updates (PR #311)

Contributors

A heartfelt thank you to all contributors who worked on this section:

Release 5.2

Features

  • Migrate core persistent streams API from AF4 #135

  • Enhancement/137/spec message transformator #138

  • [#137] Message Transformation / Upcasting - Specification #143

  • [#137] Message Transformation / Upcasting - Module setup (phase 1) #151

  • [#137] Message Transformation / Upcasting - SPI foundation (phase 2) #152

  • [#137] Message Transformation - Transform Chain and Event Store Decoration (phase 3) #153

  • [#137] Message Transformation - Sourcing Criteria widening for sourcing #160

  • Implement SnapshotStore for PostgresqlEventStorageEngine #163

  • [#137] Message Transformation - Rename support (phase 4) #164

  • [#137] Message Transformation - Drop / Filter support (phase 5) #167

  • [#137] Merge Message Transformation support #193

  • [#123] Persistent Streams Autoconfiguration #196

Enhancements

  • Include the data protection module in the Axoniq Framework BOM for convenience #130

  • fix the slack-release-notification.yml #141

  • build: unified apidocs profile and publish workflow #156

  • Remove _archive folder #166

  • [#137] Message Transformation - Semantic matching: exact precedence + from(List) (phase 6) #178

  • Disable sonar for builds #187

  • Improve flaky integration tests #189

  • cleanup remainders of the _archive folder #202

  • [#4633] AF4 MultiSourceLegacyToken classname compatibility fix #228

Bug fixes

  • Port axon 5.1.x to main #114

  • Align listing approach with Event Storage Engine parent page #115

  • Adjust import for TerminalEventMessage #132

  • Fix failing tests #136

  • Port (5.1.x): [#108] docs(dead-letter-queue): document DLQ transactional behavior #150

  • [#4625 | Port] Use EventTypeResolver in Axon Server EventStorageEngines to default null revision to default version #188

  • Support source with snapshot in single server call #220

  • [AxonFramework#4698] Ensure message type version for Commands/Queries sent from AF4 to AF5 applications #225

  • [AxonFramework#4625] Allow to gracefully handle events without revision for persistent streams #227

  • [#4625] Use EventTypeResolver in Axon Server EventStorageEngines to default null revision to default version #186

Documentation

  • Include Axoniq Data Protection release notes and module description in the framework reference #97

  • Include Axoniq Workflow Engine release notes and module description in the framework reference #99

  • Move workflow module table listing to workflow-repo for easier maintenance #101

  • [#77] Add migration guide for 5.0 → 5.1 #106

  • Include Axoniq feature indicator in navigation #107

  • [#77] Clarify migration of the AxonServerContainer from 5.0 → 5.1 #112

  • Add anchors for the event storage engines to allow referencing #117

  • Fix the maven coordinates for Axoniq PostgreSQL in the reference #119

  • Fix Modules Documentation (remove opentracing) #128

  • Introduce Framework Comparison page #134

  • [#137] add Event Transformation reference docs (moved from Axon Framework) #179

  • [#137] adapt moved Event Transformation docs + address review nits #180

  • Add 5.1.1 and 5.1.2 Release Notes #191

  • docs: use DeadLetterQueueConfiguration extension API in DLQ reference #197

  • Fix configuration example for EventProcessorDefinition based persistent streams configuration #224

Dependency upgrades

  • Bump io.opentelemetry:opentelemetry-api from 1.60.1 to 1.62.0 in /_archive/extensions/tracing/tracing-opentelemetry #121

  • Bump Antora site-generator from 3.2.0-alpha.11 to 3.2.0-alpha.12 in /docs/_playbook #125

  • Bump Antora cli from 3.2.0-alpha.11 to 3.2.0-alpha.12 in /docs/_playbook #126

  • Bump the maven-dependencies group with 4 updates #127

  • Bump qs from 6.14.2 to 6.15.2 in /docs/_playbook #145

  • Bump the maven-dependencies group with 3 updates #146

  • Bump the maven-dependencies group with 6 updates #154

  • Bump the maven-dependencies group with 5 updates #161

  • Bump the maven-dependencies group with 7 updates #170

  • Bump the GitHub dependencies group with 4 updates #182

  • Bump Antora site-generator from 3.2.0-alpha.12 to 3.2.0-rc.2 in /docs/_playbook #183

  • Bump the maven-dependencies group with 4 updates #184

  • Bump js YAML and Antora cli in /docs/_playbook #185

  • Bump the GitHub dependencies group with 2 updates #194

  • Bump the maven-dependencies group with 4 updates #195

  • Bump the maven-dependencies group with 8 updates #215

  • [chore]: Add missing axoniq-message-transformation to combined coverage report #217

Contributors

We’d like to thank all the contributors who worked on this section!

Release 5.1

Features

  • [#3105] Set AxonServerSnapshotStore in the AxonServerConfigurationEnhancer

  • Snapshotting rework to allow snapshots to be part of event stream

  • [#3435] Align MultiStreamableMessageSource with StreamableEventSource interface

  • [#3435] Created the MultiStreamableEventSource implementation

  • [#3517] Revise Dead Letter Queue

  • [#3517] feat: Dead Letter Queue adjusted to AF5 API

  • [#4182] feat(extensions/spring): JdbcAutoConfiguration + JdbcDeadLetterQueueAutoConfiguration

  • [#5] Port PostgreSQL Extension while keeping history

  • [#6] Construct axoniq-server-connector out of axon-server-connector

  • [#7] Move distributed CommandBus logic to axoniq-distributed-messaging

  • [#8] Move distributed QueryBus logic to axoniq-distributed-messaging

  • [#9] Move Sequenced Dead-Letter Queue logic to axoniq-dead-letter

  • [#9] feat(messaging/axoniq-dead-letter): initialize module and move code from Axon Framework 5 archive

  • [#11] Move multi-streamable event source to axoniq-event-streaming

  • [#12] Introduce Spring Autoconfigure and Spring Starter modules

  • [#21] Use of Entitlement Module for DLQ

  • [#21] Register PostgreSQL and DLQ with Entitlement Manager

  • Base for Axoniq Framework

Enhancements

  • feat(test): AxonServerContainer DCB context support

  • [#3517] JpaSequencedDeadLetterQueue aligned with AF5 APIs

  • [#3517] CachingSequencedDeadLetterQueue per Segment

  • [#3517] Move JPA dead letter classes from stash/todo to messaging module

  • [#3517] JdbcSequencedDeadLetterQueue aligned with AF5 APIs

  • [#3517] JpaSequencedDeadLetterQueue auto configuration

  • [#3517] Add Context context() method to DeadLetter interface

  • [#3517] Remove unused DeadLetterQueueProviderConfigurerModule

  • DistributedQueryBusConfiguration cleanup and support for local shortcut

  • Align DistributedQueryBusConfiguration with DistributedCommandBusConfiguration

  • Move Sequenced Dead-Letter Queue feature to Axoniq Framework

  • Moved MultiSourceTrackingToken and MultiStreamableEventSource to Axoniq Framework

  • Move Axon Server integration to Axoniq Framework

  • Port DistributedCommand- and -QueryBus to Axoniq Framework

  • Remove the final Axon Server mentions

  • [#15] Move (Spring) integration-tests

  • [#17] Align maven module name prefix

  • [#19] Clean up maven modules and build

  • [#42] Move AxonServerContainer and TestFixture Customization facilities to axoniq-test module

  • Restore modules with history - distributed-messaging, server-connector

  • chore(integrationtests): init Maven module for integration tests

  • Move Axon Server specific tests into integration test module

  • Move AxonServerContainer in axoniq-testcontainer module

  • Remove the examples.yml GitHub Action

  • chore: fix code inspections

  • Update Axoniq framework with AbstractMessageStream changes

  • Replace the Slack notify GHA

  • Add missing ArchUnit tests to axoniq-testcontainer

  • chore: improve Logback settings

  • Add tag format settings to release plugin

  • [#9] refactor(messaging/axoniq-dead-letter): change dead-letter addon identifier to framework.dead_letter_queue

  • Disable the Slack release notification

  • Port Axon Server Spring integration

  • Fix all remaining usages of org.axonframework.messaging.*.distributed

Bug fixes

  • Fix axon server address resolution for AxonServerTestContainerConnectionDetailsFactory

  • Fix race-condition for DistributedQueryBusSubscriptionQueryTest#replayBufferOverflow

  • [#4437] AggregateBasedAxonServerEventStorageEngine returns invalid AggregateSequence

  • [#4474] PostgresqlEventStorageEngine throws AppendEventsTransactionRejectedException when appending >= 2 events from a command handler

  • [#4408] Remove DLQ references from persistence configuration

  • Remove DLQ entity registration in JpaAutoConfiguration

  • Adjust AxonServerAutoConfiguration import for Spring Boot autoconfig classes

  • [#18] Fix AxonServerConfigurationEnhancerTest.enhanceSetsExpectedDefaultsInAbsenceOfTheseComponents

  • Minor licensing adjustments

  • Correct projectKey and organization for Sonar

  • fix(dependency-injection/spring): guard dead-letter autoconfiguration on SequencedDeadLetterQueueFactory classpath presence

  • Correct code owners

  • Fix consistency marker when sourcing an empty stream in the AggregateBasedAxonServerEventStorageEngine

  • Normalize event tags into a table; fix rejection for multi-event batches

Documentation

  • [#3289] Clarify DLQ Transactionality in the documentation

  • [#4326] Migration path - Sequenced Dead-Letter Queue

  • [#4442] Describe PostgreSQLEventStorageEngine in the documentation

  • [#4484] Fix cross-version references in the framework reference and related guides

  • Migration path for the DLQ

  • Prepare composite Axon Framework / Axoniq Framework documentation

  • Adjust references to AxoniqFramework classes in the reference guide

  • Add Visual indicator for features moved to Axoniq Framework

  • Restructure Antora Setup

  • Include Data Protection documentation in framework reference guide

  • [#14] Create composite Documentation for Axoniq Framework and Axon Framework

  • [#14] Prepare composite Axon Framework / Axoniq Framework documentation

  • [#14] Fix the Antora component version resolution for release branches

  • [#14] Restructure Antora Setup

  • [#60] Add visual indication for Axoniq Framework features to the reference guide

  • [#60] Add Visual indicator Axoniq Framework features

  • [#76] Adjust references to AxoniqFramework code in the documentation

  • [#76] Adjust class references and maven artifact references in the reference guide

  • [#77] Add a mini migration guide for 5.0 → 5.1

  • Update Copyright Notice

Contributors

We’d like to thank all the contributors who worked on this release!