├── .editorconfig
├── .github
    ├── CODEOWNERS
    ├── dependabot.yml
    └── workflows
    │   ├── dependabot-automation.yml
    │   └── main.yml
├── .gitignore
├── .java-version
├── .mvn
    └── wrapper
    │   ├── maven-wrapper.jar
    │   └── maven-wrapper.properties
├── README.md
├── axon-spring-template
    ├── README.md
    ├── pom.xml
    └── src
    │   ├── main
    │       ├── java
    │       │   └── io
    │       │   │   └── axoniq
    │       │   │       └── dev
    │       │   │           └── sample
    │       │   │               ├── Application.kt
    │       │   │               ├── api
    │       │   │                   └── .gitkeep
    │       │   │               ├── command
    │       │   │                   └── .gitkeep
    │       │   │               └── query
    │       │   │                   └── .gitkeep
    │       └── resources
    │       │   └── .gitkeep
    │   └── test
    │       └── java
    │           └── .gitkeep
├── distributed-exceptions
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    ├── requests.http
    └── src
    │   ├── main
    │       ├── java
    │       │   └── io
    │       │   │   └── axoniq
    │       │   │       └── distributedexceptions
    │       │   │           ├── DistributedExceptionsApplication.java
    │       │   │           ├── api
    │       │   │               ├── CardIssuedEvent.java
    │       │   │               ├── CardRedeemedEvent.java
    │       │   │               ├── GiftCardBusinessError.java
    │       │   │               ├── GiftCardBusinessErrorCode.java
    │       │   │               ├── IssueCardCommand.java
    │       │   │               └── RedeemCardCommand.java
    │       │   │           ├── command
    │       │   │               ├── AxonCommandConfiguration.java
    │       │   │               ├── ExceptionWrappingHandlerInterceptor.java
    │       │   │               ├── GiftCard.java
    │       │   │               └── GiftCardException.java
    │       │   │           └── rest
    │       │   │               ├── GiftCardController.java
    │       │   │               ├── IssueCardDto.java
    │       │   │               └── RedeemCardDto.java
    │       └── resources
    │       │   ├── application-rest.properties
    │       │   └── application.properties
    │   └── test
    │       └── java
    │           └── io
    │               └── axoniq
    │                   └── distributedexceptions
    │                       └── .gitkeep
├── multitenancy
    ├── .gitignore
    ├── README.md
    ├── actions.png
    ├── h2.png
    ├── login.png
    ├── pom.xml
    ├── register.png
    ├── reset.png
    └── src
    │   └── main
    │       ├── docker
    │           ├── axoniq.license
    │           ├── cluster-template.yml
    │           └── docker-compose.yml
    │       ├── java
    │           └── io
    │           │   └── axoniq
    │           │       └── multitenancy
    │           │           ├── MultiTenantConfig.java
    │           │           ├── MultitenancyExampleApplication.java
    │           │           ├── api
    │           │               ├── AddFundsCommand.java
    │           │               ├── CardIssuedEvent.java
    │           │               ├── FindAllCardsQuery.java
    │           │               ├── FindCardQuery.java
    │           │               ├── FundsAddedEvent.java
    │           │               ├── GiftCardRecord.java
    │           │               └── IssueCardCommand.java
    │           │           ├── domain
    │           │               └── GiftCard.java
    │           │           ├── query
    │           │               ├── GiftCardEntity.java
    │           │               ├── GiftCardHandler.java
    │           │               └── GiftCardJpaRepository.java
    │           │           ├── ui
    │           │               ├── ActionView.java
    │           │               ├── MainView.java
    │           │               ├── RegisterView.java
    │           │               └── UIConfig.java
    │           │           └── web
    │           │               ├── CreateTenantService.java
    │           │               ├── MessageService.java
    │           │               └── ResetService.java
    │       └── resources
    │           ├── application.properties
    │           └── db
    │               └── migration
    │                   └── V0.sql
├── mvnw
├── mvnw.cmd
├── pom.xml
├── reset-handler
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    ├── requests.http
    └── src
    │   └── main
    │       ├── java
    │           └── io
    │           │   └── axoniq
    │           │       ├── EventRestController.java
    │           │       ├── MyFakeProjection.java
    │           │       ├── ResetHandlerSampleApplication.java
    │           │       ├── framework
    │           │           └── FrameworkEventProcessorRestController.java
    │           │       └── server
    │           │           ├── EventProcessorService.java
    │           │           └── ServerEventProcessorRestController.java
    │       └── resources
    │           └── application.properties
├── saga
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    └── src
    │   ├── main
    │       ├── java
    │       │   └── io
    │       │   │   └── axoniq
    │       │   │       └── dev
    │       │   │           └── samples
    │       │   │               ├── SagaNoToastApplication.java
    │       │   │               ├── dialect
    │       │   │                   └── NoToastPostgreSQLDialect.java
    │       │   │               ├── order
    │       │   │                   └── api
    │       │   │                   │   ├── CompleteOrderProcessCommand.java
    │       │   │                   │   └── OrderConfirmedEvent.java
    │       │   │               ├── payment
    │       │   │                   └── api
    │       │   │                   │   ├── OrderPaidEvent.java
    │       │   │                   │   ├── OrderPaymentCancelledEvent.java
    │       │   │                   │   └── PayOrderCommand.java
    │       │   │               ├── saga
    │       │   │                   ├── ProcessOrderSaga.java
    │       │   │                   └── ProcessOrderSagaConfig.java
    │       │   │               ├── shipment
    │       │   │                   └── api
    │       │   │                   │   ├── CancelShipmentCommand.java
    │       │   │                   │   ├── ShipOrderCommand.java
    │       │   │                   │   ├── ShipmentStatus.java
    │       │   │                   │   └── ShipmentStatusUpdatedEvent.java
    │       │   │               └── uuid
    │       │   │                   ├── AbstractId.java
    │       │   │                   ├── OrderId.java
    │       │   │                   ├── PaymentId.java
    │       │   │                   ├── ShipmentId.java
    │       │   │                   └── UUIDProvider.java
    │       └── resources
    │       │   ├── application.properties
    │       │   ├── migrateToBytea.sql
    │       │   └── orm.xml
    │   └── test
    │       └── java
    │           └── io
    │               └── axoniq
    │                   └── dev
    │                       └── samples
    │                           └── saga
    │                               └── ProcessOrderSagaTest.java
├── sequencing-policy
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    └── src
    │   ├── main
    │       ├── java
    │       │   └── io
    │       │   │   └── axoniq
    │       │   │       └── dev
    │       │   │           └── samples
    │       │   │               └── sequencingpolicy
    │       │   │                   ├── AxonConfig.java
    │       │   │                   ├── FlightIdSequencingPolicy.java
    │       │   │                   ├── SequencingPolicyApplication.java
    │       │   │                   ├── controller
    │       │   │                       └── TestController.java
    │       │   │                   ├── coreapi
    │       │   │                       ├── ArrivalTimeChangedEvent.java
    │       │   │                       ├── FlightCanceledEvent.java
    │       │   │                       ├── FlightDelayedEvent.java
    │       │   │                       ├── FlightEvent.java
    │       │   │                       ├── FlightId.java
    │       │   │                       └── FlightScheduledEvent.java
    │       │   │                   └── querymodel
    │       │   │                       └── FlightTimeProjector.java
    │       └── resources
    │       │   ├── application-property.properties
    │       │   └── application.properties
    │   └── test
    │       └── java
    │           └── io
    │               └── axoniq
    │                   └── dev
    │                       └── samples
    │                           └── sequencingpolicy
    │                               └── FlightIdSequencingPolicyTest.java
├── serialization-avro
    ├── .docker
    │   └── config
    │   │   └── axonserver.yaml
    ├── .gitignore
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    ├── requests.http
    └── src
    │   └── main
    │       ├── avro
    │           ├── giftcard.command.IssueCard.avsc
    │           ├── giftcard.command.RedeemCard.avsc
    │           ├── giftcard.event.CardIssued.avsc
    │           ├── giftcard.event.CardRedeemed.avsc
    │           ├── giftcard.query.CardList.avsc
    │           ├── giftcard.query.GetAllCards.avsc
    │           └── giftcard.query.GetCardById.avsc
    │       ├── java
    │           └── io
    │           │   └── axoniq
    │           │       └── dev
    │           │           └── samples
    │           │               └── serializationavro
    │           │                   ├── SerializationAvroApplication.java
    │           │                   ├── api
    │           │                       ├── GiftCardException.java
    │           │                       ├── InsufficientFunds.java
    │           │                       └── NegativeOrZeroAmount.java
    │           │                   ├── command
    │           │                       └── GiftCard.java
    │           │                   ├── query
    │           │                       └── GiftCardProjection.java
    │           │                   └── rest
    │           │                       ├── CardDto.java
    │           │                       ├── GiftCardController.java
    │           │                       ├── GiftCardInventoryController.java
    │           │                       ├── IssueCardDto.java
    │           │                       └── RedeemCardDto.java
    │       └── resources
    │           ├── application.yaml
    │           └── banner.txt
├── set-based-validation-actor-model
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── io
    │           │   └── axoniq
    │           │       └── dev
    │           │           └── samples
    │           │               ├── SetBasedValidationActorModelApplication.java
    │           │               ├── api
    │           │                   ├── commands
    │           │                   │   ├── RegisterUserWithUniqueEmailAddressCommand.java
    │           │                   │   ├── RemoveUserCommand.java
    │           │                   │   └── RemoveUserWithUniqueEmailAddressCommand.java
    │           │                   ├── dto
    │           │                   │   ├── RegisterUserDto.java
    │           │                   │   └── UpdateEmailFromUserDto.java
    │           │                   └── events
    │           │                   │   ├── EmailAddressApprovedEvent.java
    │           │                   │   ├── EmailAddressRemovedEvent.java
    │           │                   │   ├── UserRegisteredEvent.java
    │           │                   │   └── UserRemovedEvent.java
    │           │               ├── command
    │           │                   ├── aggregate
    │           │                   │   ├── EmailUniquenessCheck.java
    │           │                   │   └── User.java
    │           │                   └── controller
    │           │                   │   └── UserController.java
    │           │               └── query
    │           │                   └── eventhandler
    │           │                       └── UserEventHandler.java
    │       └── resources
    │           └── requests.http
├── set-based-validation
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    └── src
    │   ├── main
    │       ├── java
    │       │   └── io
    │       │   │   └── axoniq
    │       │   │       └── dev
    │       │   │           └── samples
    │       │   │               ├── SetBasedValidationApplication.java
    │       │   │               ├── api
    │       │   │                   ├── AccountCreatedEvent.java
    │       │   │                   ├── AccountRequestData.java
    │       │   │                   ├── AlterEmailAddressCommand.java
    │       │   │                   ├── ChangeEmailAddressCommand.java
    │       │   │                   ├── CreateAccountCommand.java
    │       │   │                   ├── EmailAddressChangedEvent.java
    │       │   │                   └── RequestEmailChangeCommand.java
    │       │   │               ├── command
    │       │   │                   ├── aggregate
    │       │   │                   │   └── Account.java
    │       │   │                   ├── handler
    │       │   │                   │   ├── AccountCommandHandler.java
    │       │   │                   │   └── AccountEventHandler.java
    │       │   │                   ├── interceptor
    │       │   │                   │   └── AccountCreationDispatchInterceptor.java
    │       │   │                   └── persistence
    │       │   │                   │   ├── EmailJpaEntity.java
    │       │   │                   │   └── EmailRepository.java
    │       │   │               ├── config
    │       │   │                   └── AxonConfig.java
    │       │   │               ├── controller
    │       │   │                   └── AccountController.java
    │       │   │               └── resolver
    │       │   │                   └── EmailAlreadyExistsResolverFactory.java
    │       └── resources
    │       │   └── application.properties
    │   └── test
    │       └── java
    │           └── io
    │               └── axoniq
    │                   └── dev
    │                       └── samples
    │                           ├── aggregate
    │                               └── AccountTest.java
    │                           └── handler
    │                               └── AccountEventHandlerTest.java
├── snapshots
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    ├── requests.http
    └── src
    │   └── main
    │       └── java
    │           └── io
    │               └── axoniq
    │                   └── dev
    │                       └── samples
    │                           ├── SnapshottingApplication.java
    │                           ├── api
    │                               ├── CreateMyEntityCommand.java
    │                               ├── MyEntityCreatedEvent.java
    │                               ├── MyEntityRenamedEvent.java
    │                               └── RenameMyEntityCommand.java
    │                           ├── command
    │                               └── MyEntityAggregate.java
    │                           └── rest
    │                               └── CommandController.java
├── stateful-event-handler
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── io
    │               └── axoniq
    │                   └── dev
    │                       └── samples
    │                           ├── config
    │                               └── OrderProcessorConfig.java
    │                           ├── order
    │                               └── api
    │                               │   ├── CompleteOrderProcessCommand.java
    │                               │   └── OrderConfirmedEvent.java
    │                           ├── orderprocessor
    │                               ├── OrderProcess.java
    │                               ├── OrderProcessRepository.java
    │                               └── OrderProcessor.java
    │                           ├── payment
    │                               └── api
    │                               │   ├── OrderPaidEvent.java
    │                               │   ├── OrderPaymentCancelledEvent.java
    │                               │   └── PayOrderCommand.java
    │                           ├── shipment
    │                               └── api
    │                               │   ├── CancelShipmentCommand.java
    │                               │   ├── ShipOrderCommand.java
    │                               │   ├── ShipmentStatus.java
    │                               │   └── ShipmentStatusUpdatedEvent.java
    │                           └── uuid
    │                               ├── AbstractId.java
    │                               ├── OrderId.java
    │                               ├── PaymentId.java
    │                               ├── ShipmentId.java
    │                               └── UUIDProvider.java
├── subscription-query-rest
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── io
    │           │   └── axoniq
    │           │       └── dev
    │           │           └── samples
    │           │               ├── CommandController.java
    │           │               ├── SubscriptionQueryRestApplication.java
    │           │               ├── api
    │           │                   ├── CreateMyEntityCommand.java
    │           │                   ├── GetMyEntityByCorrelationIdQuery.java
    │           │                   ├── MyEntityCreatedEvent.java
    │           │                   └── ValidateMyEntityCommand.java
    │           │               ├── command
    │           │                   └── MyEntityAggregate.java
    │           │               └── query
    │           │                   ├── MyEntity.java
    │           │                   └── MyEntityProjection.java
    │       └── resources
    │           └── application.properties
├── subscription-query-streaming
    ├── README.md
    ├── docker-compose.yml
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── io
    │           │   └── axoniq
    │           │       └── dev
    │           │           └── samples
    │           │               ├── AxonConfig.java
    │           │               ├── SubscriptionQueryStreamingApplication.java
    │           │               ├── api
    │           │                   ├── ModelQuery.java
    │           │                   └── StreamUpdatedEvent.java
    │           │               ├── commandmodel
    │           │                   └── EventPublisher.java
    │           │               ├── querymodel
    │           │                   └── ModelProjector.java
    │           │               └── ui
    │           │                   └── QueryController.java
    │       ├── resources
    │           └── application.properties
    │       └── ui
    │           ├── .browserslistrc
    │           ├── .editorconfig
    │           ├── .gitignore
    │           ├── README.md
    │           ├── angular.json
    │           ├── karma.conf.js
    │           ├── proxy.conf.json
    │           ├── src
    │               ├── app
    │               │   ├── app-routing.module.ts
    │               │   ├── app.component.css
    │               │   ├── app.component.html
    │               │   ├── app.component.spec.ts
    │               │   ├── app.component.ts
    │               │   ├── app.module.ts
    │               │   └── app.sse.service.ts
    │               ├── assets
    │               │   └── .gitkeep
    │               ├── environments
    │               │   ├── environment.prod.ts
    │               │   └── environment.ts
    │               ├── favicon.ico
    │               ├── index.html
    │               ├── main.ts
    │               ├── polyfills.ts
    │               ├── styles.css
    │               └── test.ts
    │           ├── tsconfig.app.json
    │           └── tsconfig.spec.json
└── upcaster
    ├── README.md
    ├── pom.xml
    └── src
        ├── main
            └── java
            │   └── io
            │       └── axoniq
            │           └── dev
            │               └── samples
            │                   ├── api
            │                       ├── AirportCode.java
            │                       ├── FlightDelayedEvent.java
            │                       ├── Leg.java
            │                       ├── PassengerSeatAdjustedEvent.java
            │                       └── PassengerSeatsAdjustedEvent.java
            │                   └── upcaster
            │                       └── json
            │                           ├── EventUpcasterChainFactory.java
            │                           ├── FlightDelayedEvent0_to_1Upcaster.java
            │                           └── PassengerSeatsToPassengerSeatAdjustedEventUpcaster.java
        └── test
            ├── java
                └── io
                │   └── axoniq
                │       └── dev
                │           └── samples
                │               └── upcaster
                │                   └── json
                │                       ├── FlightDelayedEvent0_To_1UpcasterTest.java
                │                       ├── PassengerSeatsToPassengerSeatAdjustedEventUpcasterTest.java
                │                       └── UpcasterTestingUtils.java
            └── resources
                ├── FlightDelayedEventRev_1.json
                ├── FlightDelayedEventRev_null.json
                ├── PassengerSeatAdjustedEventOne.json
                ├── PassengerSeatAdjustedEventThree.json
                ├── PassengerSeatAdjustedEventTwo.json
                └── PassengerSeatsAdjustedEvent.json


/.github/CODEOWNERS:
--------------------------------------------------------------------------------
1 | *   @CodeDrivenMitch
2 | *   @MateuszNaKodach
3 | *   @smcvb


--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
 1 | version: 2
 2 | 
 3 | updates:
 4 |   - package-ecosystem: github-actions
 5 |     directory: "/"
 6 |     schedule:
 7 |       interval: weekly
 8 |       day: "sunday"
 9 |     open-pull-requests-limit: 5
10 |     labels:
11 |       - "Type: Dependency Upgrade"
12 |       - "Priority 1: Must"
13 |     groups:
14 |       github-dependencies:
15 |         update-types:
16 |           - "patch"
17 |           - "minor"
18 |           - "major"
19 | 
20 |   - package-ecosystem: maven
21 |     directory: "/"
22 |     schedule:
23 |       interval: weekly
24 |       day: "sunday"
25 |     open-pull-requests-limit: 5
26 |     labels:
27 |       - "Type: Dependency Upgrade"
28 |       - "Priority 1: Must"
29 |     groups:
30 |       maven-dependencies:
31 |         update-types:
32 |           - "patch"
33 |           - "minor"
34 |           - "major"
35 | 
36 |   - package-ecosystem: npm
37 |     directory: "/"
38 |     schedule:
39 |       interval: weekly
40 |       day: "sunday"
41 |     open-pull-requests-limit: 5
42 |     labels:
43 |       - "Type: Dependency Upgrade"
44 |       - "Priority 1: Must"
45 |     groups:
46 |       npm-dependencies:
47 |         update-types:
48 |           - "patch"
49 |           - "minor"
50 |           - "major"


--------------------------------------------------------------------------------
/.github/workflows/dependabot-automation.yml:
--------------------------------------------------------------------------------
 1 | name: Dependabot Automation
 2 | on: pull_request
 3 | 
 4 | permissions:
 5 |   contents: write
 6 |   pull-requests: write
 7 | 
 8 | jobs:
 9 |   dependabot-approve:
10 |     name: Approve PR
11 | 
12 |     runs-on: ubuntu-latest
13 |     if: ${{ github.actor == 'dependabot[bot]' }}
14 |     steps:
15 |       - name: Retrieve Dependabot metadata
16 |         id: metadata
17 |         uses: dependabot/fetch-metadata@v2
18 |         with:
19 |           github-token: "${{ secrets.GITHUB_TOKEN }}"
20 | 
21 |       - name: Approve Pull Request
22 |         run: gh pr review --approve "$PR_URL"
23 |         env:
24 |           PR_URL: ${{github.event.pull_request.html_url}}
25 |           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
26 | 
27 |   dependabot-auto-merge:
28 |     name: Auto Merge
29 | 
30 |     runs-on: ubuntu-latest
31 |     if: ${{ github.actor == 'dependabot[bot]' }}
32 |     steps:
33 |       - name: Retrieve Dependabot metadata
34 |         id: metadata
35 |         uses: dependabot/fetch-metadata@v2
36 |         with:
37 |           github-token: "${{ secrets.GITHUB_TOKEN }}"
38 | 
39 |       - name: Auto-merge Pull Request
40 |         if: ${{steps.metadata.outputs.update-type != 'version-update:semver-major'}}
41 |         run: gh pr merge --auto --merge "$PR_URL"
42 |         env:
43 |           PR_URL: ${{github.event.pull_request.html_url}}
44 |           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}


--------------------------------------------------------------------------------
/.github/workflows/main.yml:
--------------------------------------------------------------------------------
 1 | name: AxonIQ Code Samples
 2 | 
 3 | on: [push, pull_request]
 4 | 
 5 | jobs:
 6 |   build:
 7 |     runs-on: ubuntu-latest
 8 |     strategy:
 9 |       matrix:
10 |         java-version: [ 21 ]
11 | 
12 |     name: Build and Test on JDK ${{ matrix.java-version }}
13 | 
14 |     steps:
15 |       - name: Checkout code
16 |         uses: actions/checkout@v4
17 | 
18 |       - name: Set up JDK ${{ matrix.java-version }}
19 |         uses: actions/setup-java@v4.7.1
20 |         with:
21 |           distribution: 'zulu'
22 |           java-version: ${{ matrix.java-version }}
23 |           cache: "maven"
24 |           server-id: sonatype
25 |           server-username: MAVEN_USERNAME
26 |           server-password: MAVEN_PASSWORD
27 | 
28 |       - name: Cache .m2
29 |         uses: actions/cache@v4
30 |         with:
31 |           path: ~/.m2/repository
32 |           key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
33 |           restore-keys: |
34 |             ${{ runner.os }}-maven
35 | 
36 |       - name: Build and Verify
37 |         run: ./mvnw -B -U -Dstyle.color=always clean verify
38 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | .gradle
 2 | build/
 3 | !gradle/wrapper/gradle-wrapper.jar
 4 | !**/src/main/**
 5 | !**/src/test/**
 6 | 
 7 | ### Maven ###
 8 | target/
 9 | !.mvn/wrapper/maven-wrapper.jar
10 | !**/src/main/**/target/
11 | !**/src/test/**/target/
12 | 
13 | ### STS ###
14 | .apt_generated
15 | .classpath
16 | .factorypath
17 | .project
18 | .settings
19 | .springBeans
20 | .sts4-cache
21 | 
22 | ### IntelliJ IDEA ###
23 | .idea
24 | *.iws
25 | *.iml
26 | *.ipr
27 | out/
28 | 
29 | ### NetBeans ###
30 | /nbproject/private/
31 | /nbbuild/
32 | /dist/
33 | /nbdist/
34 | /.nb-gradle/
35 | 
36 | ### VS Code ###
37 | .vscode/
38 | 
39 | ### Node.js ###
40 | package.json
41 | package-lock.json
42 | tsconfig.json
43 | types.d.ts
44 | vite.config.ts
45 | vite.generated.ts
46 | /multitenancy/frontend/
47 | /multitenancy/node_modules/
48 | multitenancy/src/main/frontend
49 | 


--------------------------------------------------------------------------------
/.java-version:
--------------------------------------------------------------------------------
1 | 21
2 | 


--------------------------------------------------------------------------------
/.mvn/wrapper/maven-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/.mvn/wrapper/maven-wrapper.jar


--------------------------------------------------------------------------------
/.mvn/wrapper/maven-wrapper.properties:
--------------------------------------------------------------------------------
1 | distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.3/apache-maven-3.9.3-bin.zip
2 | wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.2.0/maven-wrapper-3.2.0.jar
3 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Code Samples
 2 | 
 3 | This repository contains several Axon-based sample projects to explain specific topics.
 4 | Axon usage extends itself from the repositories under the [Axon Framework project](https://github.com/AxonFramework/),
 5 | as well as the tools provided by AxonIQ like [Axon Server](https://www.axoniq.io/products/axon-server).
 6 | 
 7 | Each Maven module within this project represents a different sample you can use, each with its own `README.md`
 8 | explaining the intent and usage.
 9 | Some of these modules can actually be run, while others are a plain set-up.
10 | The latter typically are samples that don't require to be ran for additional or much needed explanation.
11 | If a module can be run, you may expect a `docker-compose.yml` to set up the infrastructure in most cases, as well as a "
12 | Spring Boot"-based main class.
13 | 
14 | Down below is an exhaustive list of all the sample:
15 | 
16 | 1. [Axon-Spring Template](axon-spring-template/README.md) - Sample project providing the scaffolding for a simple Axon-
17 |    and Spring-based application.
18 | 2. [Distributed Exceptions](distributed-exceptions/README.md) - Sample showing how to deal with exceptions in a
19 |    distributed application.
20 | 3. [Multitenancy](multitenancy/README.md) - Sample showing 'a' approach to multitenancy.
21 | 4. [Reset Handler](reset-handler/README.md) - Sample showing how to reset a `StreamingEventProcessor`.
22 | 5. [Saga - No TOAST in PostgreSQL](saga/README.md) - Sample showing a basis Saga, that's stored in a PostgreSQL
23 |    without [TOAST](https://wiki.postgresql.org/wiki/TOAST).
24 | 6. [Serialization Avro](serialization-avro/README.md) - Sample showing usage of Apache Avro Commands/Events/Queries. 
25 | 7. [Sequencing Policy](sequencing-policy/README.md) - Sample showing how to set up a custom `SequencingPolicy` to adjust
26 |    the event sequence for a `StreamingEventProcessor`.
27 | 8. [Set-Based Validation](set-based-validation/README.md) - Sample showing several approaches to implement set-based
28 |    validation.
29 | 9. [Set-Based Validation - Actor Model](set-based-validation-actor-model/README.md) - Sample showing how to implement
30 |    set-based validation through a dedicated aggregate instance.
31 | 10. [Snapshots](snapshots/README.md) - Sample showing how to configure aggregate snapshotting.
32 | 11. [Stateful Event Handler](stateful-event-handler/README.md) - Sample showing a stateful event handler that can be
33 |     used as a replacement for sagas.
34 | 12. [Subscription Query - REST](subscription-query-rest/README.md) - Sample showing how to use Axon's subscription query
35 |     cleanly in a REST-based controller.
36 | 13. [Subscription Query - Streaming](subscription-query-streaming/README.md) - Sample showing how to use Axon's
37 |     subscription query cleanly in a streaming-based controller.
38 | 14. [Upcasters](upcaster/README.md) - Sample showing several implementations of upcasters.
39 | 
40 | 


--------------------------------------------------------------------------------
/axon-spring-template/README.md:
--------------------------------------------------------------------------------
 1 | # Axon Spring template
 2 | 
 3 | This module's intention is to be used as a template to quickly start with a new Maven based Axon application with Spring
 4 | Boot, either in Java or Kotlin
 5 | 
 6 | ### Maven build
 7 | 
 8 | `pom.xml` contains basic Axon, Spring Boot and Kotlin dependencies
 9 | 
10 | - `axon-spring-boot-starter` is a dependency that will provide Axon Framework integrated with Spring Boot
11 | - `spring-boot-starter` is a base dependency for Spring Boot
12 | - `kotlin-stdlib-jdk8` and `kotlin-reflect` are basic Kotlin dependencies, and compile support is enabled
13 |   via `kotlin-maven-plugin`
14 | - Java and Kotlin classes and files can be mixed in Java source directory
15 | - `axon-test` and `spring-boot-starter-test` are included to provide test support
16 | 
17 | ### How to use
18 | 
19 | You can simply copy this directory, rename the package as you wish. You can keep the suggested package structure where:
20 | 
21 | - API package is intended for messages like Commands, Events and Queries
22 | - Command package is intended for your command model like aggregates
23 | - Query package is intended for your projections.
24 |     
25 | 


--------------------------------------------------------------------------------
/axon-spring-template/src/main/java/io/axoniq/dev/sample/Application.kt:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.sample
 2 | 
 3 | import org.springframework.boot.autoconfigure.SpringBootApplication
 4 | import org.springframework.boot.runApplication
 5 | 
 6 | @SpringBootApplication
 7 | class Application
 8 | 
 9 | fun main(args: Array<String>) {
10 |     runApplication<Application>(*args)
11 | }
12 | 


--------------------------------------------------------------------------------
/axon-spring-template/src/main/java/io/axoniq/dev/sample/api/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/axon-spring-template/src/main/java/io/axoniq/dev/sample/api/.gitkeep


--------------------------------------------------------------------------------
/axon-spring-template/src/main/java/io/axoniq/dev/sample/command/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/axon-spring-template/src/main/java/io/axoniq/dev/sample/command/.gitkeep


--------------------------------------------------------------------------------
/axon-spring-template/src/main/java/io/axoniq/dev/sample/query/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/axon-spring-template/src/main/java/io/axoniq/dev/sample/query/.gitkeep


--------------------------------------------------------------------------------
/axon-spring-template/src/main/resources/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/axon-spring-template/src/main/resources/.gitkeep


--------------------------------------------------------------------------------
/axon-spring-template/src/test/java/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/axon-spring-template/src/test/java/.gitkeep


--------------------------------------------------------------------------------
/distributed-exceptions/docker-compose.yml:
--------------------------------------------------------------------------------
 1 | version: '3.3'
 2 | services:
 3 |   axonserver:
 4 |     image: axoniq/axonserver
 5 |     hostname: axonserver
 6 |     ports:
 7 |       - '8024:8024'
 8 |       - '8124:8124'
 9 |     networks:
10 |       - axon-distributed-exceptions
11 | 
12 | networks:
13 |   axon-distributed-exceptions:
14 | 


--------------------------------------------------------------------------------
/distributed-exceptions/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xmlns="http://maven.apache.org/POM/4.0.0"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <parent>
 6 |         <groupId>io.axoniq</groupId>
 7 |         <artifactId>code-samples</artifactId>
 8 |         <version>0.0.2-SNAPSHOT</version>
 9 |     </parent>
10 |     <modelVersion>4.0.0</modelVersion>
11 | 
12 |     <artifactId>distributed-exceptions</artifactId>
13 | 
14 |     <name>Distributed Exceptions</name>
15 |     <description>Code sample showing how to deal with exceptions in a distributed application</description>
16 | 
17 |     <dependencies>
18 |         <!-- Axon -->
19 |         <dependency>
20 |             <groupId>org.axonframework</groupId>
21 |             <artifactId>axon-messaging</artifactId>
22 |         </dependency>
23 |         <dependency>
24 |             <groupId>org.axonframework</groupId>
25 |             <artifactId>axon-modelling</artifactId>
26 |         </dependency>
27 |         <dependency>
28 |             <groupId>org.axonframework</groupId>
29 |             <artifactId>axon-eventsourcing</artifactId>
30 |         </dependency>
31 |         <dependency>
32 |             <groupId>org.axonframework</groupId>
33 |             <artifactId>axon-spring-boot-starter</artifactId>
34 |         </dependency>
35 |         <!-- Spring -->
36 |         <dependency>
37 |             <groupId>org.springframework.boot</groupId>
38 |             <artifactId>spring-boot-starter-web</artifactId>
39 |         </dependency>
40 |         <dependency>
41 |             <groupId>org.springframework.boot</groupId>
42 |             <artifactId>spring-boot-starter-test</artifactId>
43 |             <scope>test</scope>
44 |             <exclusions>
45 |                 <exclusion>
46 |                     <groupId>org.junit.vintage</groupId>
47 |                     <artifactId>junit-vintage-engine</artifactId>
48 |                 </exclusion>
49 |             </exclusions>
50 |         </dependency>
51 |         <!-- Other -->
52 |         <dependency>
53 |             <groupId>com.google.code.findbugs</groupId>
54 |             <artifactId>jsr305</artifactId>
55 |         </dependency>
56 |         <!-- Testing -->
57 |         <dependency>
58 |             <groupId>org.testcontainers</groupId>
59 |             <artifactId>junit-jupiter</artifactId>
60 |         </dependency>
61 |         <dependency>
62 |             <groupId>org.junit.jupiter</groupId>
63 |             <artifactId>junit-jupiter-params</artifactId>
64 |             <scope>test</scope>
65 |         </dependency>
66 |     </dependencies>
67 | </project>
68 | 


--------------------------------------------------------------------------------
/distributed-exceptions/requests.http:
--------------------------------------------------------------------------------
 1 | ### Create a new GiftCard with initial amount of 50. Response will contain the GiftCard (aggregate)\
 2 | ### which will be used for later requests
 3 | 
 4 | POST http://localhost:8080/giftcard
 5 | Content-Type: application/json
 6 | 
 7 | {
 8 |   "amount": 50
 9 | }
10 | 
11 | ### Try to create a GiftCard with invalid (negative) amount. Will not work and will cause a domain exception.
12 | 
13 | POST http://localhost:8080/giftcard
14 | Content-Type: application/json
15 | 
16 | {
17 |   "amount": -5
18 | }
19 | 
20 | ### Redeem amount of a given GiftCard. Domain exceptions can be caused by either redeeming more than the GiftCard
21 | ### currently has, or by sending negative amount.
22 | ### Infrastructure type error can be caused by referencing non existing GiftCard (by ID)
23 | ### Change UUID to one returned by working POST (create GiftCard) call
24 | 
25 | PUT http://localhost:8080/giftcard/d8961637-2825-4b1b-ab14-f2a63d9ab1b5
26 | Content-Type: application/json
27 | 
28 | {
29 |   "amount": 1
30 | }
31 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/DistributedExceptionsApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions;
 2 | 
 3 | import io.axoniq.distributedexceptions.command.ExceptionWrappingHandlerInterceptor;
 4 | import org.springframework.boot.SpringApplication;
 5 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 6 | import org.springframework.context.annotation.Bean;
 7 | import org.springframework.context.annotation.Profile;
 8 | 
 9 | @SpringBootApplication
10 | public class DistributedExceptionsApplication {
11 | 
12 |     public static void main(String[] args) {
13 |         SpringApplication.run(DistributedExceptionsApplication.class, args);
14 |     }
15 | 
16 |     @Bean
17 |     @Profile("command")
18 |     public ExceptionWrappingHandlerInterceptor exceptionWrappingHandlerInterceptor() {
19 |         return new ExceptionWrappingHandlerInterceptor();
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/api/CardIssuedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.distributedexceptions.api;
2 | 
3 | import javax.annotation.Nonnull;
4 | 
5 | public record CardIssuedEvent(@Nonnull String id, int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/api/CardRedeemedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.distributedexceptions.api;
2 | 
3 | import javax.annotation.Nonnull;
4 | 
5 | public record CardRedeemedEvent(@Nonnull String id, int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/api/GiftCardBusinessError.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.api;
 2 | 
 3 | import javax.annotation.Nonnull;
 4 | 
 5 | public record GiftCardBusinessError(
 6 |         String name,
 7 |         @Nonnull GiftCardBusinessErrorCode code,
 8 |         String message
 9 | ) {
10 | 
11 | }
12 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/api/GiftCardBusinessErrorCode.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.api;
 2 | 
 3 | /**
 4 |  * Public domain specific error codes
 5 |  *
 6 |  * @author Stefan Andjelkovic
 7 |  */
 8 | public enum GiftCardBusinessErrorCode {
 9 |     NEGATIVE_AMOUNT,
10 |     INSUFFICIENT_FUNDS,
11 |     UNKNOWN
12 | }
13 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/api/IssueCardCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import javax.annotation.Nonnull;
 6 | 
 7 | public record IssueCardCommand(@TargetAggregateIdentifier @Nonnull String id, int amount) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/api/RedeemCardCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import javax.annotation.Nonnull;
 6 | 
 7 | public record RedeemCardCommand(@TargetAggregateIdentifier @Nonnull String id, int amount) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/command/AxonCommandConfiguration.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.command;
 2 | 
 3 | import org.axonframework.commandhandling.CommandBus;
 4 | import org.springframework.beans.factory.annotation.Autowired;
 5 | import org.springframework.context.annotation.Configuration;
 6 | import org.springframework.context.annotation.Profile;
 7 | 
 8 | @Profile("command")
 9 | @Configuration
10 | public class AxonCommandConfiguration {
11 | 
12 |     @Autowired
13 |     void commandBus(CommandBus commandBus, ExceptionWrappingHandlerInterceptor exceptionWrappingHandlerInterceptor) {
14 |         //noinspection resource
15 |         commandBus.registerHandlerInterceptor(exceptionWrappingHandlerInterceptor);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/command/ExceptionWrappingHandlerInterceptor.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.command;
 2 | 
 3 | import io.axoniq.distributedexceptions.api.GiftCardBusinessError;
 4 | import io.axoniq.distributedexceptions.api.GiftCardBusinessErrorCode;
 5 | import org.axonframework.commandhandling.CommandExecutionException;
 6 | import org.axonframework.commandhandling.CommandMessage;
 7 | import org.axonframework.messaging.InterceptorChain;
 8 | import org.axonframework.messaging.MessageHandlerInterceptor;
 9 | import org.axonframework.messaging.unitofwork.UnitOfWork;
10 | import org.slf4j.Logger;
11 | import org.slf4j.LoggerFactory;
12 | 
13 | import java.lang.invoke.MethodHandles;
14 | import javax.annotation.Nonnull;
15 | 
16 | public class ExceptionWrappingHandlerInterceptor implements MessageHandlerInterceptor<CommandMessage<?>> {
17 | 
18 |     private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
19 | 
20 |     @Override
21 |     public Object handle(@Nonnull UnitOfWork<? extends CommandMessage<?>> unitOfWork,
22 |                          @Nonnull InterceptorChain interceptorChain) {
23 |         try {
24 |             return interceptorChain.proceed();
25 |         } catch (Throwable e) {
26 |             throw new CommandExecutionException(
27 |                     "An exception has occurred during command execution", e, exceptionDetails(e)
28 |             );
29 |         }
30 |     }
31 | 
32 |     // Domain specific details can be returned in a couple of forms.
33 |     // Shared, domain specific Error Codes as enumeration are a reasonable and common method.
34 |     // For simplicity Enums/Error Codes could be returned directly without any wrapping in a domain Error object.
35 |     private GiftCardBusinessError exceptionDetails(Throwable throwable) {
36 | 
37 |         // alternatively this can be a centralised place to do a check on exception's more specific instance
38 |         // and populate the details accordingly (code, message, etc), instead of relying on the Domain Exception
39 |         // to contain all the information and mapping logic
40 |         if (throwable instanceof GiftCardException gce) {
41 |             GiftCardBusinessError businessError = new GiftCardBusinessError(
42 |                     gce.getClass().getName(), gce.getErrorCode(), gce.getErrorMessage()
43 |             );
44 |             logger.info("Converted GiftCardException to " + businessError);
45 |             return businessError;
46 |         } else {
47 |             GiftCardBusinessError businessError = new GiftCardBusinessError(
48 |                     throwable.getClass().getName(), GiftCardBusinessErrorCode.UNKNOWN, throwable.getMessage()
49 |             );
50 |             logger.info("Converted CommandExecutionException to " + businessError);
51 |             return businessError;
52 |         }
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/command/GiftCard.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.command;
 2 | 
 3 | import io.axoniq.distributedexceptions.api.IssueCardCommand;
 4 | import io.axoniq.distributedexceptions.api.CardIssuedEvent;
 5 | import io.axoniq.distributedexceptions.api.RedeemCardCommand;
 6 | import io.axoniq.distributedexceptions.api.CardRedeemedEvent;
 7 | import org.axonframework.commandhandling.CommandHandler;
 8 | import org.axonframework.eventsourcing.EventSourcingHandler;
 9 | import org.axonframework.modelling.command.AggregateIdentifier;
10 | import org.axonframework.spring.stereotype.Aggregate;
11 | import org.slf4j.Logger;
12 | import org.slf4j.LoggerFactory;
13 | import org.springframework.context.annotation.Profile;
14 | 
15 | import java.lang.invoke.MethodHandles;
16 | 
17 | import static org.axonframework.modelling.command.AggregateLifecycle.apply;
18 | 
19 | @Aggregate
20 | @Profile("command")
21 | class GiftCard {
22 | 
23 |     private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
24 | 
25 |     @AggregateIdentifier
26 |     private String giftCardId;
27 |     private int remainingValue;
28 | 
29 |     @CommandHandler
30 |     public GiftCard(IssueCardCommand command) {
31 |         logger.debug("handling {}", command);
32 |         if (command.amount() <= 0) {
33 |             throw new NegativeOrZeroAmount(command.amount(), "amount <= 0");
34 |         }
35 |         apply(new CardIssuedEvent(command.id(), command.amount()));
36 |     }
37 | 
38 |     @CommandHandler
39 |     public void handle(RedeemCardCommand command) {
40 |         logger.debug("handling {}", command);
41 |         if (command.amount() <= 0) {
42 |             throw new NegativeOrZeroAmount(command.amount(), "amount <= 0");
43 |         }
44 |         if (command.amount() > remainingValue) {
45 |             throw new InsufficientFunds("amount > remaining value");
46 |         }
47 |         apply(new CardRedeemedEvent(giftCardId, command.amount()));
48 |     }
49 | 
50 |     @EventSourcingHandler
51 |     public void on(CardIssuedEvent event) {
52 |         logger.debug("applying {}", event);
53 |         giftCardId = event.id();
54 |         remainingValue = event.amount();
55 |         logger.debug("new remaining value: {}", remainingValue);
56 |     }
57 | 
58 |     @EventSourcingHandler
59 |     public void on(CardRedeemedEvent event) {
60 |         logger.debug("applying {}", event);
61 |         remainingValue -= event.amount();
62 |         logger.debug("new remaining value: {}", remainingValue);
63 |     }
64 | 
65 |     public GiftCard() {
66 |         // Required by Axon
67 |         logger.debug("Empty constructor invoked");
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/command/GiftCardException.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.distributedexceptions.command;
 2 | 
 3 | import io.axoniq.distributedexceptions.api.GiftCardBusinessErrorCode;
 4 | 
 5 | /**
 6 |  * Domain specific exception
 7 |  *
 8 |  * @author Stefan Andjelkovic
 9 |  */
10 | class GiftCardException extends RuntimeException {
11 | 
12 |     private final String errorMessage;
13 |     private final GiftCardBusinessErrorCode errorCode;
14 | 
15 |     public GiftCardException(String errorMessage, GiftCardBusinessErrorCode errorCode) {
16 |         super(errorMessage);
17 |         this.errorMessage = errorMessage;
18 |         this.errorCode = errorCode;
19 |     }
20 | 
21 |     public String getErrorMessage() {
22 |         return errorMessage;
23 |     }
24 | 
25 |     public GiftCardBusinessErrorCode getErrorCode() {
26 |         return errorCode;
27 |     }
28 | }
29 | 
30 | class InsufficientFunds extends GiftCardException {
31 | 
32 |     public InsufficientFunds() {
33 |         super("amount > remaining value", GiftCardBusinessErrorCode.INSUFFICIENT_FUNDS);
34 |     }
35 | 
36 |     public InsufficientFunds(String errorMessage) {
37 |         super(errorMessage, GiftCardBusinessErrorCode.INSUFFICIENT_FUNDS);
38 |     }
39 | }
40 | 
41 | class NegativeOrZeroAmount extends GiftCardException {
42 | 
43 |     private int amount;
44 | 
45 |     public NegativeOrZeroAmount(int amount) {
46 |         super("amount $amount <=0", GiftCardBusinessErrorCode.NEGATIVE_AMOUNT);
47 |     }
48 | 
49 |     public NegativeOrZeroAmount(int amount, String errorMessage) {
50 |         super(errorMessage, GiftCardBusinessErrorCode.NEGATIVE_AMOUNT);
51 |     }
52 | 
53 |     public int getAmount() {
54 |         return amount;
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/rest/IssueCardDto.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.distributedexceptions.rest;
2 | 
3 | import com.fasterxml.jackson.annotation.JsonProperty;
4 | 
5 | public record IssueCardDto(@JsonProperty("amount") int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/java/io/axoniq/distributedexceptions/rest/RedeemCardDto.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.distributedexceptions.rest;
2 | 
3 | import com.fasterxml.jackson.annotation.JsonProperty;
4 | 
5 | public record RedeemCardDto(@JsonProperty("amount") int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/resources/application-rest.properties:
--------------------------------------------------------------------------------
1 | spring.main.web-application-type=servlet
2 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | spring.main.web-application-type=none
2 | axon.serializer.general=jackson
3 | 


--------------------------------------------------------------------------------
/distributed-exceptions/src/test/java/io/axoniq/distributedexceptions/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/distributed-exceptions/src/test/java/io/axoniq/distributedexceptions/.gitkeep


--------------------------------------------------------------------------------
/multitenancy/.gitignore:
--------------------------------------------------------------------------------
1 | src/main/frontend
2 | 


--------------------------------------------------------------------------------
/multitenancy/actions.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/multitenancy/actions.png


--------------------------------------------------------------------------------
/multitenancy/h2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/multitenancy/h2.png


--------------------------------------------------------------------------------
/multitenancy/login.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/multitenancy/login.png


--------------------------------------------------------------------------------
/multitenancy/register.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/multitenancy/register.png


--------------------------------------------------------------------------------
/multitenancy/reset.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/multitenancy/reset.png


--------------------------------------------------------------------------------
/multitenancy/src/main/docker/axoniq.license:
--------------------------------------------------------------------------------
 1 | #AxonIQ License File generated on 2022-09-20
 2 | #Tue Sep 20 08:26:45 UTC 2022
 3 | license_key_id=dd722d00-dd7c-4c70-bf1a-2f5c78a3af6c
 4 | signature=POSseYXhv/Op+DaXT7UYjQudjzhkM3adU/gPGWuSEUPXTspHoF788iL0poZoycIVBsm8CGxUqeWdZyAaWQnvEuveqQCl9YlgmK6ocYp6uPL3ltxfAO93xW8X9paUqMMj1Y6FFky8ITSPRPWNA1zpTFyoPLs3Dmy+/kx/DjVJBiTo8QaDt08IWhr7f8Zezp9n6HgZKU/UnojSwBBtp/NxxMGu11VjjqrBI6NBBj+J3LtJMNkA5P8za4cQ2Huu+HufROz+6N2Ia1obdkpG2eqaoRsWf6MLKzYBX6eU9nV/b5SFCOX9/ehw3O0lHT5WZokY3ZKZUaXTAWNYgTopRkpeunNv7p+pVHnSAV969zWZ6Y1YbgDkL1TAmnqWu1+1w3C48xoyFvlSSNcUkhWljOlwF2X0gmYX6/r02UDPD5Q0nQcqC01QcOFOeYny0VgWe6XfYovKMmlqDCW5m2y/W7dEJffpl4I93p0OFzh4LRxqrqriNTVKs95YNh5XPvm4e8u2/0ieeo9so8gCz+xTeDB6rZw81YCyLDYkS4GP1pVt/SOPtvZHPncKWOdv19790zc6azByyXAxnqi/GXGI6dB9kaKDmBVPeCMtSdF6Z0Cq9K+aGAHoFhwZZJmG4Bo1MAutAAA6J+Qw60yilehKt+SgibwQFxIn1LEkRZu4Ga4e/mg\=
 5 | reference=Trial license for use by the participants to AxonIQCon 2022
 6 | contexts=100
 7 | expiry_date=2022-10-15
 8 | contact=bert.laverman@axoniq.io
 9 | edition=Enterprise
10 | issue_date=2022-09-20
11 | grace_date=2022-10-15
12 | product=AxonServer
13 | licensee=AxonIQCon 2022
14 | clusterNodes=3


--------------------------------------------------------------------------------
/multitenancy/src/main/docker/cluster-template.yml:
--------------------------------------------------------------------------------
 1 | axoniq:
 2 |   axonserver:
 3 |     cluster-template:
 4 |       users: []
 5 |       replicationGroups:
 6 |         - roles:
 7 |             - role: PRIMARY
 8 |               node: axonserver-enterprise-1
 9 |             - role: PRIMARY
10 |               node: axonserver-enterprise-2
11 |             - role: PRIMARY
12 |               node: axonserver-enterprise-3
13 |           name: _admin
14 |           contexts:
15 |             - name: _admin
16 |               metaData:
17 |                 event.index-format: JUMP_SKIP_INDEX
18 |                 snapshot.index-format: JUMP_SKIP_INDEX
19 |         - roles:
20 |             - role: PRIMARY
21 |               node: axonserver-enterprise-2
22 |             - role: PRIMARY
23 |               node: axonserver-enterprise-1
24 |             - role: PRIMARY
25 |               node: axonserver-enterprise-3
26 |           name: default
27 |           contexts:
28 |             - name: tenant-one
29 |               metaData:
30 |                 event.index-format: JUMP_SKIP_INDEX
31 |                 snapshot.index-format: JUMP_SKIP_INDEX
32 |       applications: []
33 |       first: axonserver-enterprise-1:8224
34 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/MultiTenantConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy;
 2 | 
 3 | import org.axonframework.axonserver.connector.AxonServerConfiguration;
 4 | import org.axonframework.axonserver.connector.AxonServerConnectionManager;
 5 | import org.axonframework.axonserver.connector.event.axon.AxonServerEventStore;
 6 | import org.axonframework.eventsourcing.snapshotting.SnapshotFilter;
 7 | import org.axonframework.extensions.multitenancy.components.TenantConnectPredicate;
 8 | 
 9 | import org.axonframework.extensions.multitenancy.configuration.MultiTenantStreamableMessageSourceProvider;
10 | import org.springframework.context.annotation.Bean;
11 | import org.springframework.context.annotation.Configuration;
12 | 
13 | import java.util.concurrent.Executors;
14 | import java.util.concurrent.ScheduledExecutorService;
15 | 
16 | @Configuration
17 | public class MultiTenantConfig {
18 | 
19 |     @Bean
20 |     public TenantConnectPredicate tenantFilter() {
21 |         return context -> context.tenantId().startsWith("tenant-");
22 |     }
23 | 
24 |     @Bean
25 |     public ScheduledExecutorService persistentStreamScheduler() {
26 |         return Executors.newScheduledThreadPool(10, Thread.ofVirtual()
27 |                                                           .name("persistent-streams-", 0)
28 |                                                           .factory());
29 |     }
30 | 
31 |     // UNCOMMENT THIS BEAN TO ENABLE MULTITENANCY WITH MULTIPLE DATA SOURCES
32 | //    @Bean
33 | //    public Function<TenantDescriptor, DataSourceProperties> tenantDataSourceResolver() {
34 | //        return tenant -> {
35 | //            DataSourceProperties properties = new DataSourceProperties();
36 | //            properties.setUrl("jdbc:h2:mem:" + tenant.tenantId());
37 | //            properties.setDriverClassName("org.h2.Driver");
38 | //            properties.setUsername("sa");
39 | //            return properties;
40 | //        };
41 | //    }
42 | }
43 | 
44 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/MultitenancyExampleApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | import org.springframework.data.jpa.repository.config.EnableJpaRepositories;
 6 | 
 7 | @SpringBootApplication
 8 | @EnableJpaRepositories
 9 | public class MultitenancyExampleApplication {
10 | 
11 |     public static void main(String[] args) {
12 |         SpringApplication.run(MultitenancyExampleApplication.class, args);
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/AddFundsCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import javax.annotation.Nonnull;
 6 | 
 7 | public record AddFundsCommand(@TargetAggregateIdentifier @Nonnull String id, Integer amount) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/CardIssuedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.api;
2 | 
3 | public record CardIssuedEvent(String id, Integer amount) {
4 | 
5 | }


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/FindAllCardsQuery.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.api;
2 | 
3 | public record FindAllCardsQuery() {
4 | 
5 | }


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/FindCardQuery.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.api;
2 | 
3 | public record FindCardQuery(String id) {
4 | 
5 | }


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/FundsAddedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.api;
2 | 
3 | import javax.annotation.Nonnull;
4 | 
5 | public record FundsAddedEvent(@Nonnull String id, int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/GiftCardRecord.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.api;
2 | 
3 | public record GiftCardRecord(String id, Integer initialValue, Integer remainingValue, String payload) {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/api/IssueCardCommand.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.api;
2 | 
3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
4 | 
5 | public record IssueCardCommand(@TargetAggregateIdentifier String id, Integer amount) {
6 | 
7 | }


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/domain/GiftCard.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.domain;
 2 | 
 3 | import io.axoniq.multitenancy.api.AddFundsCommand;
 4 | import io.axoniq.multitenancy.api.FundsAddedEvent;
 5 | import io.axoniq.multitenancy.api.IssueCardCommand;
 6 | import io.axoniq.multitenancy.api.CardIssuedEvent;
 7 | import org.axonframework.commandhandling.CommandHandler;
 8 | import org.axonframework.config.ProcessingGroup;
 9 | import org.axonframework.eventsourcing.EventSourcingHandler;
10 | import org.axonframework.modelling.command.AggregateIdentifier;
11 | import org.axonframework.spring.stereotype.Aggregate;
12 | import org.slf4j.Logger;
13 | import org.slf4j.LoggerFactory;
14 | 
15 | import java.lang.invoke.MethodHandles;
16 | 
17 | import static org.axonframework.modelling.command.AggregateLifecycle.apply;
18 | 
19 | @ProcessingGroup("giftcard")
20 | @Aggregate
21 | class GiftCard {
22 | 
23 |     private final static Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
24 | 
25 |     @AggregateIdentifier
26 |     private String id;
27 |     private int remainingValue;
28 | 
29 |     public GiftCard() {
30 |         logger.debug("Empty constructor invoked");
31 |     }
32 | 
33 |     @CommandHandler
34 |     GiftCard(IssueCardCommand command) throws InterruptedException {
35 |         logger.debug("handling {}", command);
36 |         Integer amount = command.amount();
37 |         if (amount <= 0) {
38 |             throw new IllegalArgumentException("amount <= 0");
39 |         }
40 | 
41 |         //simulate some work time
42 |         Thread.sleep(amount);
43 |         apply(new CardIssuedEvent(command.id(), amount));
44 |     }
45 | 
46 |     @CommandHandler
47 |     void add(AddFundsCommand command) {
48 |         apply(new FundsAddedEvent(command.id(), command.amount()));
49 |     }
50 | 
51 |     @EventSourcingHandler
52 |     void on(FundsAddedEvent event) {
53 |         remainingValue += event.amount();
54 |         logger.info("remaining amount is {} for account {}", remainingValue, id);
55 |     }
56 | 
57 |     @EventSourcingHandler
58 |     void on(CardIssuedEvent event) {
59 |         logger.debug("applying {}", event);
60 |         id = event.id();
61 |         remainingValue = event.amount();
62 |         logger.debug("new remaining value: {}", remainingValue);
63 |     }
64 | }
65 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/query/GiftCardEntity.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.query;
 2 | 
 3 | import jakarta.persistence.Entity;
 4 | import jakarta.persistence.Id;
 5 | 
 6 | @Entity
 7 | class GiftCardEntity {
 8 | 
 9 |     @Id
10 |     private String id;
11 |     private Integer initialValue;
12 |     private Integer remainingValue;
13 | 
14 |     public GiftCardEntity(String id, Integer initialValue, Integer remainingValue) {
15 |         this.id = id;
16 |         this.initialValue = initialValue;
17 |         this.remainingValue = remainingValue;
18 |     }
19 | 
20 |     public GiftCardEntity() {
21 |     }
22 | 
23 |     public String getId() {
24 |         return id;
25 |     }
26 | 
27 |     public Integer getInitialValue() {
28 |         return initialValue;
29 |     }
30 | 
31 |     public Integer getRemainingValue() {
32 |         return remainingValue;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/query/GiftCardHandler.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.query;
 2 | 
 3 | import io.axoniq.multitenancy.api.FindAllCardsQuery;
 4 | import io.axoniq.multitenancy.api.FindCardQuery;
 5 | import io.axoniq.multitenancy.api.GiftCardRecord;
 6 | import io.axoniq.multitenancy.api.CardIssuedEvent;
 7 | import org.axonframework.config.ProcessingGroup;
 8 | import org.axonframework.eventhandling.EventHandler;
 9 | import org.axonframework.messaging.MetaData;
10 | import org.axonframework.queryhandling.QueryHandler;
11 | import org.axonframework.queryhandling.QueryUpdateEmitter;
12 | import org.slf4j.Logger;
13 | import org.slf4j.LoggerFactory;
14 | import org.springframework.stereotype.Component;
15 | 
16 | import java.lang.invoke.MethodHandles;
17 | import java.util.Collections;
18 | import java.util.List;
19 | import java.util.Objects;
20 | import java.util.Optional;
21 | 
22 | @ProcessingGroup("giftcard")
23 | @Component
24 | class GiftCardHandler {
25 | 
26 |     private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
27 | 
28 |     private final GiftCardJpaRepository giftCardJpaRepository;
29 | 
30 |     public GiftCardHandler(GiftCardJpaRepository giftCardJpaRepository) {
31 |         this.giftCardJpaRepository = giftCardJpaRepository;
32 |     }
33 | 
34 |     @EventHandler
35 |     public void on(CardIssuedEvent event, QueryUpdateEmitter queryUpdateEmitter) {
36 |         /*
37 |          * Update our read model by inserting the new card.
38 |          */
39 |         giftCardJpaRepository.save(new GiftCardEntity(event.id(), event.amount(), event.amount()));
40 | 
41 |         /* Send it to subscription queries of type FindGiftCardQry, but only if the card id matches. */
42 |         queryUpdateEmitter.emit(FindCardQuery.class,
43 |                                 query -> Objects.equals(event.id(), query.id()),
44 |                                 new GiftCardRecord(event.id(), event.amount(), event.amount(), "payload")
45 |         );
46 |     }
47 | 
48 |     @QueryHandler
49 |     public List<GiftCardRecord> handle(FindAllCardsQuery query, MetaData metaData) {
50 |         logger.debug("@" + metaData + " - " + "FindGiftCardQry: " + query);
51 |         return Collections.emptyList();
52 |     }
53 | 
54 |     @QueryHandler
55 |     public Optional<GiftCardRecord> handle(FindCardQuery query, MetaData metaData) {
56 |         logger.debug("@" + metaData + " - " + "FindGiftCardQry: " + query);
57 |         return Optional.empty();
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/query/GiftCardJpaRepository.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.multitenancy.query;
2 | 
3 | import org.springframework.data.repository.CrudRepository;
4 | import org.springframework.stereotype.Repository;
5 | 
6 | @Repository
7 | public interface GiftCardJpaRepository extends CrudRepository<GiftCardEntity, String> {
8 | 
9 | }


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/ui/MainView.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.ui;
 2 | 
 3 | import com.vaadin.flow.component.Text;
 4 | import com.vaadin.flow.component.UI;
 5 | import com.vaadin.flow.component.button.Button;
 6 | import com.vaadin.flow.component.button.ButtonVariant;
 7 | import com.vaadin.flow.component.html.H1;
 8 | import com.vaadin.flow.component.orderedlayout.VerticalLayout;
 9 | import com.vaadin.flow.router.Route;
10 | import org.axonframework.extensions.multitenancy.components.TenantDescriptor;
11 | import org.axonframework.extensions.multitenancy.components.TenantProvider;
12 | 
13 | @Route
14 | public class MainView extends VerticalLayout {
15 | 
16 |     public MainView(TenantProvider tenantProvider) {
17 |         VerticalLayout layout = new VerticalLayout();
18 | 
19 |         H1 title = new H1("Login");
20 |         layout.add(title);
21 | 
22 |         layout.add(new Text("Available tenants:"));
23 | 
24 |         tenantProvider
25 |                 .getTenants()
26 |                 .stream()
27 |                 .map(TenantDescriptor::tenantId)
28 |                 .map(name -> new Button(name, event -> UI.getCurrent().navigate("action/" + name)))
29 |                 .forEach(layout::add);
30 | 
31 |         layout.setAlignItems(Alignment.CENTER);
32 | 
33 | 
34 |         Button register = new Button("Or register new...", event -> UI.getCurrent().navigate("register"));
35 |         register.addThemeVariants(ButtonVariant.LUMO_CONTRAST);
36 |         layout.add(register);
37 | 
38 |         add(layout);
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/ui/RegisterView.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.ui;
 2 | 
 3 | import com.vaadin.flow.component.UI;
 4 | import com.vaadin.flow.component.button.Button;
 5 | import com.vaadin.flow.component.button.ButtonVariant;
 6 | import com.vaadin.flow.component.html.H1;
 7 | import com.vaadin.flow.component.notification.Notification;
 8 | import com.vaadin.flow.component.notification.NotificationVariant;
 9 | import com.vaadin.flow.component.orderedlayout.VerticalLayout;
10 | import com.vaadin.flow.component.textfield.TextField;
11 | import com.vaadin.flow.router.Route;
12 | import io.axoniq.multitenancy.web.CreateTenantService;
13 | 
14 | @Route("/register")
15 | public class RegisterView extends VerticalLayout {
16 | 
17 |     public RegisterView(CreateTenantService createTenantService) {
18 |         H1 title = new H1("Register tenant");
19 | 
20 |         VerticalLayout layout = new VerticalLayout();
21 |         layout.setAlignItems(Alignment.CENTER);
22 |         TextField tenantName = new TextField("Tenant name");
23 | 
24 |         layout.add(title);
25 | 
26 |         layout.add(tenantName);
27 | 
28 |         Button submitButton = new Button("Register");
29 |         submitButton.addThemeVariants(ButtonVariant.LUMO_PRIMARY);
30 | 
31 |         layout.add(submitButton);
32 | 
33 |         submitButton.getStyle().set("padding", "25px");
34 | 
35 |         add(layout);
36 | 
37 | 
38 |         submitButton.addClickListener(e -> {
39 |             String tenantNameValue = tenantName.getValue();
40 | 
41 |             createTenantService
42 |                     .createTenant("tenant-" + tenantNameValue, "default", true)
43 |                     .exceptionally(err -> {
44 |                         showError(err.getMessage());
45 |                         return null;
46 |                     }).join();
47 | 
48 |             showSuccess(tenantNameValue);
49 | 
50 |             try {
51 |                 Thread.sleep(2500);
52 |             } catch (InterruptedException ex) {
53 |                 ex.printStackTrace();
54 |             }
55 | 
56 |             new Button("redirect", event -> UI.getCurrent().navigate("")).click();
57 |         });
58 |     }
59 | 
60 |     private void showSuccess(String tenantName) {
61 |         Notification notification = Notification.show("Tenant created with username: tenant-" + tenantName);
62 |         notification.addThemeVariants(NotificationVariant.LUMO_SUCCESS);
63 |     }
64 | 
65 |     private void showError(String error) {
66 |         Notification notification = Notification.show("Error has occurred: " + error);
67 |         notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/java/io/axoniq/multitenancy/ui/UIConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.multitenancy.ui;
 2 | 
 3 | import com.vaadin.flow.component.page.AppShellConfigurator;
 4 | import com.vaadin.flow.theme.Theme;
 5 | import com.vaadin.flow.theme.lumo.Lumo;
 6 | 
 7 | @Theme(variant = Lumo.DARK)
 8 | class UIConfig implements AppShellConfigurator {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/multitenancy/src/main/resources/application.properties:
--------------------------------------------------------------------------------
 1 | #
 2 | # Copyright (c) 2020-2020. AxonIQ
 3 | #
 4 | # Licensed under the Apache License, Version 2.0 (the &quot;License&quot;)
 5 | # you may not use this file except in compliance with the License.
 6 | # You may obtain a copy of the License at
 7 | #    http://www.apache.org/licenses/LICENSE-2.0
 8 | #
 9 | #  Unless required by applicable law or agreed to in writing, software
10 | #  distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
11 | #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 | #  See the License for the specific language governing permissions and
13 | #  limitations under the License.
14 | #
15 | 
16 | spring.application.name=multitenant-example
17 | 
18 | axon.serializer.general=jackson
19 | axon.serializer.events=jackson
20 | axon.serializer.messages=jackson
21 | 
22 | # Datasource
23 | spring.datasource.url=jdbc:h2:mem:tenant-one
24 | spring.datasource.driverClassName=org.h2.Driver
25 | spring.datasource.username=sa
26 | spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
27 | spring.h2.console.enabled=true
28 | spring.h2.console.path=/h2-console
29 | 
30 | 
31 | axon.eventhandling.processors.giftcard.mode=SUBSCRIBING
32 | axon.eventhandling.processors.giftcard.source=giftcard-bean
33 | axon.axonserver.persistent-streams[giftcard-bean].name=giftcard
34 | axon.axonserver.persistent-streams[giftcard-bean].batch-size=100
35 | axon.axonserver.persistent-streams[giftcard-bean].initial-segment-count=2
36 | axon.axonserver.persistent-streams[giftcard-bean].initial-position=HEAD


--------------------------------------------------------------------------------
/reset-handler/README.md:
--------------------------------------------------------------------------------
 1 | # Reset Handler
 2 | 
 3 | This demo is meant to show how to reset a tracking token.
 4 | 
 5 | There are 2 ways of doing that, using Axon Server API or just Axon Framework.
 6 | 
 7 | ### Using Axon Server API
 8 | 
 9 | When in a distributed environment, one can have several applications connected to Axon Server while sharing the same
10 | token store.
11 | To be able to reset a token in this scenario, we have to ask Axon Server to pause every known instance of a given
12 | Processor Name to be able to reset it and start it back again.
13 | 
14 | > We recommend checking
15 | > the [ServerEventProcessorRestController.java](https://github.com/AxonIQ/code-samples/blob/master/reset-handler/src/main/java/io/axoniq/server/ServerEventProcessorRestController.java)
16 | > for more information.
17 | 
18 | ### Using Axon Framework
19 | 
20 | Axon Framework provides another easy way to do it using the `StreamingEventProcessor` methods,
21 | namely `shutDown`, `resetTokens` and `start`. When doing it through Axon Framework, the application instance doing the
22 | operation should be the one having the claim of the token.
23 | 
24 | > We recommend checking
25 | > the [FrameworkEventProcessorRestController.java](https://github.com/AxonIQ/code-samples/blob/master/reset-handler/src/main/java/io/axoniq/framework/FrameworkEventProcessorRestController.java)
26 | > for more information.
27 | 
28 | ### Running the application
29 | 
30 | This is a Spring boot application, as such it can be ran as any other standard Spring Boot application. It has a
31 | simple `/event` endpoint where you can create new empty events. For resetting the token, it provides 2 reset endpoints:
32 | 
33 | - `/server/reset/{processorName}`
34 | - `/framework/reset/{processorName}`
35 | 
36 | It also provides `/server/start/{processorName}` and `/server/pause/{processorName}` for testing purposes.
37 | 
38 | Since Axon Server is a requirement for this sample, a `docker-compose` file is provided.
39 | 
40 | Also, if you are on Intellij, a `requests.http` file is provided to make it easy to call the endpoints.
41 | 
42 | Most of the logic for the Axon Server reset is on
43 | the [EventProcessorService.java](https://github.com/AxonIQ/code-samples/blob/master/reset-handler/src/main/java/io/axoniq/server/EventProcessorService.java)
44 | class and the added javadoc should be enough to explain what it does.
45 | 
46 | For the Axon Framework version, we recommend checking the
47 | official [StreamingEventProcessor.java](https://github.com/AxonFramework/AxonFramework/blob/master/messaging/src/main/java/org/axonframework/eventhandling/StreamingEventProcessor.java)
48 | documentation.
49 | 


--------------------------------------------------------------------------------
/reset-handler/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.3'
2 | services:
3 |   axonserver:
4 |     image: axoniq/axonserver
5 |     hostname: axonserver
6 |     ports:
7 |       - '8024:8024'
8 |       - '8124:8124'
9 | 


--------------------------------------------------------------------------------
/reset-handler/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <modelVersion>4.0.0</modelVersion>
 6 |     <parent>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <artifactId>code-samples</artifactId>
 9 |         <version>0.0.2-SNAPSHOT</version>
10 |     </parent>
11 | 
12 |     <artifactId>reset-handler</artifactId>
13 | 
14 |     <name>Reset Handler</name>
15 |     <description>
16 |         Sample application showing how to construct an endpoint to trigger resets for Streaming Processors
17 |     </description>
18 | 
19 |     <dependencies>
20 |         <!-- Axon -->
21 |         <dependency>
22 |             <groupId>org.axonframework</groupId>
23 |             <artifactId>axon-spring-boot-starter</artifactId>
24 |         </dependency>
25 |         <!-- Spring -->
26 |         <dependency>
27 |             <groupId>org.springframework.boot</groupId>
28 |             <artifactId>spring-boot-starter-webflux</artifactId>
29 |         </dependency>
30 |     </dependencies>
31 | </project>


--------------------------------------------------------------------------------
/reset-handler/requests.http:
--------------------------------------------------------------------------------
 1 | ### Send a simple Event to the Application
 2 | 
 3 | GET http://localhost:8080/event
 4 | Content-Type: application/json
 5 | 
 6 | ### Pause the processor name called "io.axoniq" using Axon Server API.
 7 | 
 8 | GET http://localhost:8080/server/pause/io.axoniq
 9 | Content-Type: application/json
10 | 
11 | ### Start the processor name called "io.axoniq" using Axon Server API.
12 | 
13 | GET http://localhost:8080/server/start/io.axoniq
14 | Content-Type: application/json
15 | 
16 | ### Reset the processor name called "io.axoniq" using Axon Server API. Reset means pause, reset token and start.
17 | 
18 | GET http://localhost:8080/server/reset/io.axoniq
19 | Content-Type: application/json
20 | 
21 | ### Reset the processor name called "io.axoniq" using Axon Framework. Reset means pause, reset token and start.
22 | 
23 | GET http://localhost:8080/framework/reset/io.axoniq
24 | Content-Type: application/json


--------------------------------------------------------------------------------
/reset-handler/src/main/java/io/axoniq/EventRestController.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq;
 2 | 
 3 | import org.axonframework.eventhandling.gateway.EventGateway;
 4 | import org.springframework.web.bind.annotation.GetMapping;
 5 | import org.springframework.web.bind.annotation.RestController;
 6 | 
 7 | @RestController
 8 | public class EventRestController {
 9 | 
10 |     private final EventGateway eventGateway;
11 | 
12 |     public EventRestController(EventGateway eventGateway) {
13 |         this.eventGateway = eventGateway;
14 |     }
15 | 
16 |     @GetMapping("event")
17 |     public void event() {
18 |         eventGateway.publish(new Object());
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/reset-handler/src/main/java/io/axoniq/MyFakeProjection.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq;
 2 | 
 3 | import org.axonframework.eventhandling.EventHandler;
 4 | import org.springframework.stereotype.Component;
 5 | 
 6 | @Component
 7 | public class MyFakeProjection {
 8 | 
 9 |     @EventHandler
10 |     public void on(Object object) {
11 |         System.out.println("Got an object");
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/reset-handler/src/main/java/io/axoniq/ResetHandlerSampleApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq;
 2 | 
 3 | import org.axonframework.eventhandling.tokenstore.TokenStore;
 4 | import org.axonframework.eventhandling.tokenstore.inmemory.InMemoryTokenStore;
 5 | import org.springframework.boot.SpringApplication;
 6 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 7 | import org.springframework.context.annotation.Bean;
 8 | 
 9 | @SpringBootApplication
10 | public class ResetHandlerSampleApplication {
11 | 
12 |     public static void main(String[] args) {
13 |         SpringApplication.run(ResetHandlerSampleApplication.class);
14 |     }
15 | 
16 |     /**
17 |      * By default, the InMemoryTokenStore is not autowired since it's not 'production ready'. So, we need to explicitly
18 |      * declare it ourselves.
19 |      *
20 |      * @return One InMemoryTokenStore.ó
21 |      */
22 |     @Bean
23 |     TokenStore tokenStore() {
24 |         return new InMemoryTokenStore();
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/reset-handler/src/main/java/io/axoniq/framework/FrameworkEventProcessorRestController.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.framework;
 2 | 
 3 | import org.axonframework.config.Configuration;
 4 | import org.axonframework.eventhandling.StreamingEventProcessor;
 5 | import org.springframework.http.ResponseEntity;
 6 | import org.springframework.util.Assert;
 7 | import org.springframework.web.bind.annotation.GetMapping;
 8 | import org.springframework.web.bind.annotation.PathVariable;
 9 | import org.springframework.web.bind.annotation.RequestMapping;
10 | import org.springframework.web.bind.annotation.RestController;
11 | 
12 | @RestController
13 | @RequestMapping("framework")
14 | public class FrameworkEventProcessorRestController {
15 | 
16 |     private final Configuration configuration;
17 | 
18 |     public FrameworkEventProcessorRestController(Configuration configuration) {
19 |         this.configuration = configuration;
20 |     }
21 | 
22 |     @GetMapping("reset/{processorName}")
23 |     public ResponseEntity<Void> reset(@PathVariable String processorName) {
24 |         Assert.hasLength(processorName, "Processing Group is mandatory and can't be empty!");
25 | 
26 |         configuration.eventProcessingConfiguration()
27 |                      .eventProcessorByProcessingGroup(processorName,
28 |                                                       StreamingEventProcessor.class)
29 |                      .ifPresent(streamingEventProcessor -> {
30 |                          if (streamingEventProcessor.supportsReset()) {
31 |                              streamingEventProcessor.shutDown();
32 |                              streamingEventProcessor.resetTokens();
33 |                              streamingEventProcessor.start();
34 |                          }
35 |                      });
36 | 
37 |         return ResponseEntity.ok().build();
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/reset-handler/src/main/java/io/axoniq/server/ServerEventProcessorRestController.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.server;
 2 | 
 3 | import org.axonframework.config.Configuration;
 4 | import org.axonframework.eventhandling.StreamingEventProcessor;
 5 | import org.springframework.util.Assert;
 6 | import org.springframework.web.bind.annotation.GetMapping;
 7 | import org.springframework.web.bind.annotation.PathVariable;
 8 | import org.springframework.web.bind.annotation.RequestMapping;
 9 | import org.springframework.web.bind.annotation.RestController;
10 | import reactor.core.publisher.Mono;
11 | 
12 | @RestController
13 | @RequestMapping("server")
14 | public class ServerEventProcessorRestController {
15 | 
16 |     private final EventProcessorService eventProcessorService;
17 |     private final Configuration configuration;
18 | 
19 | 
20 |     public ServerEventProcessorRestController(EventProcessorService eventProcessorService,
21 |                                               Configuration configuration) {
22 |         this.eventProcessorService = eventProcessorService;
23 |         this.configuration = configuration;
24 |     }
25 | 
26 |     @GetMapping("start/{processorName}")
27 |     public Mono<Void> start(@PathVariable String processorName) {
28 |         return eventProcessorService.start(processorName);
29 |     }
30 | 
31 |     @GetMapping("pause/{processorName}")
32 |     public Mono<Void> pause(@PathVariable String processorName) {
33 |         return eventProcessorService.pause(processorName);
34 |     }
35 | 
36 |     @GetMapping("reset/{processorName}")
37 |     public Mono<Void> reset(@PathVariable String processorName) {
38 |         Assert.hasLength(processorName, "Processor Name is mandatory and can't be empty!");
39 |         StreamingEventProcessor eventProcessor = configuration.eventProcessingConfiguration()
40 |                                                               .eventProcessorByProcessingGroup(
41 |                                                                       processorName,
42 |                                                                       StreamingEventProcessor.class)
43 |                                                               .orElseThrow(IllegalArgumentException::new);
44 | 
45 |         return eventProcessorService.pause(processorName)
46 |                                     .then(eventProcessorService.awaitTermination(processorName))
47 |                                     .then(Mono.<Void>fromRunnable(eventProcessor::resetTokens))
48 |                                     .then(eventProcessorService.start(processorName));
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/reset-handler/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | axon.axonserver.context="default"
2 | axon.axonserver.component-name="component"
3 | 
4 | 


--------------------------------------------------------------------------------
/saga/docker-compose.yml:
--------------------------------------------------------------------------------
 1 | version: '3.3'
 2 | 
 3 | services:
 4 |   axon-server:
 5 |     image: axoniq/axonserver:latest-jdk-17-dev
 6 |     ports:
 7 |       - "8024:8024"
 8 |       - "8124:8124"
 9 |     environment:
10 |       axoniq_axonserver_hostname: axon-server
11 |       axoniq_axonserver_autocluster_first: axon-server
12 |       axoniq_axonserver_autocluster_contexts: _admin,default
13 | 
14 |     volumes:
15 |       - data:/axonserver/data
16 |       - events:/axonserver/events
17 |   db:
18 |     image: postgres:14.1-alpine
19 |     restart: always
20 |     environment:
21 |       - POSTGRES_USER=postgres
22 |       - POSTGRES_PASSWORD=postgres
23 |     ports:
24 |       - '5432:5432'
25 |     volumes:
26 |       - db:/var/lib/postgresql/data
27 | volumes:
28 |   db:
29 |     driver: local
30 |   data:
31 |     driver: local
32 |   events:
33 |     driver: local


--------------------------------------------------------------------------------
/saga/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <parent>
 6 |         <artifactId>code-samples</artifactId>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <version>0.0.2-SNAPSHOT</version>
 9 |     </parent>
10 |     <modelVersion>4.0.0</modelVersion>
11 | 
12 |     <artifactId>saga</artifactId>
13 | 
14 |     <name>Saga - No TOAST in PostgreSQL</name>
15 |     <description>
16 |         Sample application showing what a basic Saga implementation may look like,
17 |         combined with switching PostgreSQLs TOAST behavior
18 |     </description>
19 | 
20 |     <dependencies>
21 |         <!-- Axon -->
22 |         <dependency>
23 |             <groupId>org.axonframework</groupId>
24 |             <artifactId>axon-spring-boot-starter</artifactId>
25 |         </dependency>
26 |         <dependency>
27 |             <groupId>org.axonframework</groupId>
28 |             <artifactId>axon-test</artifactId>
29 |             <scope>test</scope>
30 |         </dependency>
31 |         <!-- Spring -->
32 |         <dependency>
33 |             <groupId>org.springframework.boot</groupId>
34 |             <artifactId>spring-boot-starter-data-jpa</artifactId>
35 |         </dependency>
36 |         <dependency>
37 |             <groupId>org.springframework.boot</groupId>
38 |             <artifactId>spring-boot-starter-web</artifactId>
39 |         </dependency>
40 |         <!-- Database -->
41 |         <dependency>
42 |             <groupId>org.hibernate</groupId>
43 |             <artifactId>hibernate-core</artifactId>
44 |         </dependency>
45 |         <dependency>
46 |             <groupId>org.postgresql</groupId>
47 |             <artifactId>postgresql</artifactId>
48 |             <scope>runtime</scope>
49 |         </dependency>
50 |         <!-- Testing -->
51 |         <dependency>
52 |             <groupId>org.hamcrest</groupId>
53 |             <artifactId>hamcrest-core</artifactId>
54 |             <scope>test</scope>
55 |         </dependency>
56 |         <dependency>
57 |             <groupId>org.junit.jupiter</groupId>
58 |             <artifactId>junit-jupiter</artifactId>
59 |         </dependency>
60 |         <dependency>
61 |             <groupId>org.mockito</groupId>
62 |             <artifactId>mockito-core</artifactId>
63 |             <scope>test</scope>
64 |         </dependency>
65 |     </dependencies>
66 | </project>


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/SagaNoToastApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.axonframework.config.Configuration;
 4 | import org.axonframework.deadline.DeadlineManager;
 5 | import org.axonframework.deadline.SimpleDeadlineManager;
 6 | import org.springframework.boot.SpringApplication;
 7 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 8 | import org.springframework.context.annotation.Bean;
 9 | 
10 | @SpringBootApplication
11 | public class SagaNoToastApplication {
12 | 
13 |     public static void main(String[] args) {
14 |         SpringApplication.run(SagaNoToastApplication.class);
15 |     }
16 | 
17 |     /**
18 |      * We're using a {@link SimpleDeadlineManager} to fulfill the requirements of the
19 |      * {@link io.axoniq.dev.samples.saga.ProcessOrderSaga}. Note though that you should not regard this
20 |      * {@link DeadlineManager} implementation as production-ready, as it does not persist scheduled deadlines!
21 |      */
22 |     @Bean
23 |     public DeadlineManager deadlineManager(Configuration configuration) {
24 |         return SimpleDeadlineManager.builder()
25 |                                     .scopeAwareProvider(configuration.scopeAwareProvider())
26 |                                     .build();
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/dialect/NoToastPostgreSQLDialect.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.dialect;
 2 | 
 3 | import org.hibernate.boot.model.TypeContributions;
 4 | import org.hibernate.dialect.PostgreSQLDialect;
 5 | import org.hibernate.service.ServiceRegistry;
 6 | import org.hibernate.type.SqlTypes;
 7 | import org.hibernate.type.descriptor.jdbc.BinaryJdbcType;
 8 | import org.hibernate.type.descriptor.jdbc.spi.JdbcTypeRegistry;
 9 | 
10 | import java.sql.Types;
11 | 
12 | /**
13 |  * Hibernate 6 based {@link PostgreSQLDialect}, used to enforce the {@link SqlTypes#BLOB} format to {@code BYTEA}.
14 |  * Without this dialect, PostgreSQL defaults to the so-called <a href="https://wiki.postgresql.org/wiki/TOAST">TOAST</a>
15 |  * behavior, causing LOB formats to move to a dedicated private table and replacing the LOB column for the OID (Object
16 |  * Identifier) column.
17 |  */
18 | @SuppressWarnings("unused") // Used through the application.properties file
19 | public class NoToastPostgreSQLDialect extends PostgreSQLDialect {
20 | 
21 |     public NoToastPostgreSQLDialect() {
22 |         super();
23 |     }
24 | 
25 |     @Override
26 |     protected String columnType(int sqlTypeCode) {
27 |         return sqlTypeCode == SqlTypes.BLOB ? "BYTEA" : super.columnType(sqlTypeCode);
28 |     }
29 | 
30 |     @Override
31 |     protected String castType(int sqlTypeCode) {
32 |         return sqlTypeCode == SqlTypes.BLOB ? "BYTEA" : super.castType(sqlTypeCode);
33 |     }
34 | 
35 |     @Override
36 |     public void contributeTypes(TypeContributions typeContributions, ServiceRegistry serviceRegistry) {
37 |         super.contributeTypes(typeContributions, serviceRegistry);
38 |         JdbcTypeRegistry jdbcTypeRegistry = typeContributions.getTypeConfiguration().getJdbcTypeRegistry();
39 |         jdbcTypeRegistry.addDescriptor(Types.BLOB, BinaryJdbcType.INSTANCE);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/order/api/CompleteOrderProcessCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.order.api;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.OrderId;
 4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 5 | 
 6 | public record CompleteOrderProcessCommand(@TargetAggregateIdentifier OrderId orderId,
 7 |                                           boolean isPaid,
 8 |                                           boolean orderIsDelivered) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/order/api/OrderConfirmedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.order.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.OrderId;
4 | 
5 | public record OrderConfirmedEvent(OrderId orderId) {
6 | 
7 | }
8 | 
9 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/payment/api/OrderPaidEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.payment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.PaymentId;
4 | 
5 | public record OrderPaidEvent(PaymentId paymentId) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/payment/api/OrderPaymentCancelledEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.payment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.PaymentId;
4 | 
5 | public record OrderPaymentCancelledEvent(PaymentId paymentId) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/payment/api/PayOrderCommand.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.payment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.PaymentId;
4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
5 | 
6 | public record PayOrderCommand(@TargetAggregateIdentifier PaymentId paymentId) {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/saga/ProcessOrderSagaConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.saga;
 2 | 
 3 | import org.axonframework.config.EventProcessingConfigurer;
 4 | import org.axonframework.messaging.StreamableMessageSource;
 5 | import org.springframework.beans.factory.annotation.Autowired;
 6 | import org.springframework.context.annotation.Configuration;
 7 | 
 8 | @Configuration
 9 | public class ProcessOrderSagaConfig {
10 | 
11 |     @Autowired
12 |     public void configure(EventProcessingConfigurer configurer) {
13 |         configurer.registerPooledStreamingEventProcessor(
14 |                 "ProcessOrderSagaProcessor",
15 |                 org.axonframework.config.Configuration::eventStore,
16 |                 (configuration, builder) -> builder.initialToken(StreamableMessageSource::createTailToken)
17 |         );
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/shipment/api/CancelShipmentCommand.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.shipment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.ShipmentId;
4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
5 | 
6 | public record CancelShipmentCommand(@TargetAggregateIdentifier ShipmentId shipmentId) {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/shipment/api/ShipOrderCommand.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.shipment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.ShipmentId;
4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
5 | 
6 | public record ShipOrderCommand(@TargetAggregateIdentifier ShipmentId shipmentId) {
7 | 
8 | }


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/shipment/api/ShipmentStatus.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.shipment.api;
2 | 
3 | public enum ShipmentStatus {
4 |     NEW,
5 |     SHIPPED,
6 |     DELIVERY_EXCEPTION,
7 |     DELIVERED
8 | }
9 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/shipment/api/ShipmentStatusUpdatedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.shipment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.ShipmentId;
4 | 
5 | public record ShipmentStatusUpdatedEvent(ShipmentId shipmentId, ShipmentStatus shipmentStatus) {
6 | 
7 | }


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/uuid/AbstractId.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.uuid;
 2 | 
 3 | import java.util.UUID;
 4 | 
 5 | abstract class AbstractId {
 6 | 
 7 |     UUID id;
 8 | 
 9 |     public AbstractId() {
10 |         this.id = UUID.randomUUID();
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/uuid/OrderId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.uuid;
2 | 
3 | public class OrderId extends AbstractId {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/uuid/PaymentId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.uuid;
2 | 
3 | public class PaymentId extends AbstractId {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/uuid/ShipmentId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.uuid;
2 | 
3 | public class ShipmentId extends AbstractId {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/saga/src/main/java/io/axoniq/dev/samples/uuid/UUIDProvider.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.uuid;
 2 | 
 3 | import org.springframework.stereotype.Component;
 4 | 
 5 | @Component
 6 | public class UUIDProvider {
 7 | 
 8 |     public OrderId generateOrderId() {
 9 |         return new OrderId();
10 |     }
11 | 
12 |     public PaymentId generatePaymentId() {
13 |         return new PaymentId();
14 |     }
15 | 
16 |     public ShipmentId generateShipmentId() {
17 |         return new ShipmentId();
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/saga/src/main/resources/application.properties:
--------------------------------------------------------------------------------
 1 | spring.application.name=saga-no-toast
 2 | 
 3 | axon.axonserver.enabled=true
 4 | axon.axonserver.context=default
 5 | axon.axonserver.component-name=saga-no-toast
 6 | axon.axonserver.servers=localhost:8124
 7 | 
 8 | spring.datasource.url=jdbc:postgresql://localhost:5432/postgres
 9 | spring.datasource.username=postgres
10 | spring.datasource.password=postgres
11 | spring.jpa.hibernate.ddl-auto=create-drop
12 | spring.jpa.database-platform=io.axoniq.dev.samples.dialect.NoToastPostgreSQLDialect
13 | 


--------------------------------------------------------------------------------
/saga/src/main/resources/migrateToBytea.sql:
--------------------------------------------------------------------------------
1 | ALTER TABLE saga_entry ADD COLUMN serialized_saga_bytea BYTEA;
2 | UPDATE saga_entry  SET serialized_saga_bytea = lo_get(serialized_saga);
3 | ALTER TABLE saga_entry  DROP COLUMN serialized_saga;
4 | ALTER TABLE saga_entry  RENAME COLUMN serialized_saga_bytea to serialized_saga;


--------------------------------------------------------------------------------
/saga/src/main/resources/orm.xml:
--------------------------------------------------------------------------------
1 | <entity-mappings xmlns="http://java.sun.com/xml/ns/persistence/orm" version="2.0">
2 |     <entity class="org.axonframework.modelling.saga.repository.jpa.SagaEntry">
3 |         <attribute-override name="serializedSaga">
4 |             <column name="serializedSaga" column-definition="BYTEA"></column>
5 |         </attribute-override>
6 |     </entity>
7 | </entity-mappings>


--------------------------------------------------------------------------------
/sequencing-policy/README.md:
--------------------------------------------------------------------------------
 1 | # Custom Sequencing Policy
 2 | 
 3 | This demo shows how to set up a custom `SequencingPolicy`.
 4 | 
 5 | To that end, a `FlightIdSequencingPolicy` implementation is present. This `SequencingPolicy` implementation first
 6 | validates whether it handles a `FlightEvent` implementation. If it does, it returns the `FlightId` as the sequence
 7 | identifier. Through this approach, the `FlightIdSequencingPolicy` ensures that all events with the same `FlightId` will
 8 | be handled in order within a distributed environment.
 9 | 
10 | The implementation of the `FlightIdSequencingPolicy` is concise because of the common `FlightEvent` used by all flight
11 | event implementations. Without this base event, the `FlightIdSequencingPolicy` would include an if/else or switch
12 | statement containing all flight events to achieve the same.
13 | 
14 | As a bonus, this sample shows how we can achieve the same result with the `PropertySequencingPolicy`.
15 | 
16 | For more information on sequencing policies (like other implementations)
17 | check [this](https://docs.axoniq.io/reference-guide/axon-framework/events/event-processors/streaming#sequential-processing)
18 | page.
19 | 
20 | ## Running the application
21 | 
22 | This sample project is a Spring Boot application, and as such, we can run it as any other Spring Boot application.
23 | 
24 | It has a simple `/test/bulk/{amount}` endpoint where you can generate a bulk of events.
25 | These events are directly published on the `EventGateway`, resulting in the `FlightTimeProjector` handling them.
26 | 
27 | The `FlightTimeProjector` in turn logs the thread identifier and flight identifier for every event it handles.
28 | Through this, the console shows that a single thread will handle all events for a given `FlightId` in order.
29 | 
30 | Since Axon Server is a requirement for this sample, a `docker-compose` file is provided.
31 | Also, if you are on Intellij, a `requests.http` file is provided to make it easy to call the endpoints.
32 | 


--------------------------------------------------------------------------------
/sequencing-policy/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.3'
2 | services:
3 |   axonserver:
4 |     image: axoniq/axonserver
5 |     hostname: axonserver
6 |     ports:
7 |       - '8024:8024'
8 |       - '8124:8124'
9 | 


--------------------------------------------------------------------------------
/sequencing-policy/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 4 |     <modelVersion>4.0.0</modelVersion>
 5 |     <parent>
 6 |         <artifactId>code-samples</artifactId>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <version>0.0.2-SNAPSHOT</version>
 9 |     </parent>
10 | 
11 |     <artifactId>sequencing-policy</artifactId>
12 | 
13 |     <name>Sequencing Policy</name>
14 |     <description>Code sample showing a custom SequencingPolicy implementation</description>
15 | 
16 |     <dependencies>
17 |         <!-- Axon -->
18 |         <dependency>
19 |             <groupId>org.axonframework</groupId>
20 |             <artifactId>axon-spring-boot-starter</artifactId>
21 |         </dependency>
22 |         <!-- Spring -->
23 |         <dependency>
24 |             <groupId>org.springframework.boot</groupId>
25 |             <artifactId>spring-boot-starter</artifactId>
26 |         </dependency>
27 |         <dependency>
28 |             <groupId>org.springframework.boot</groupId>
29 |             <artifactId>spring-boot-starter-webflux</artifactId>
30 |         </dependency>
31 |         <!-- Testing -->
32 |         <dependency>
33 |             <groupId>org.junit.jupiter</groupId>
34 |             <artifactId>junit-jupiter</artifactId>
35 |             <scope>test</scope>
36 |         </dependency>
37 |     </dependencies>
38 | </project>
39 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/AxonConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy;
 2 | 
 3 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightEvent;
 4 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightId;
 5 | import org.axonframework.eventhandling.EventMessage;
 6 | import org.axonframework.eventhandling.async.PropertySequencingPolicy;
 7 | import org.axonframework.eventhandling.async.SequencingPolicy;
 8 | import org.axonframework.eventhandling.tokenstore.TokenStore;
 9 | import org.axonframework.eventhandling.tokenstore.inmemory.InMemoryTokenStore;
10 | import org.springframework.beans.factory.annotation.Qualifier;
11 | import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
12 | import org.springframework.context.annotation.Bean;
13 | import org.springframework.context.annotation.Configuration;
14 | 
15 | @Configuration
16 | public class AxonConfig {
17 | 
18 |     /**
19 |      * By default, the InMemoryTokenStore is not autowired since it's not 'production ready'. So, we need to explicitly
20 |      * declare it ourselves.
21 |      *
22 |      * @return an InMemoryTokenStore
23 |      */
24 |     @Bean
25 |     TokenStore tokenStore() {
26 |         return new InMemoryTokenStore();
27 |     }
28 | 
29 |     /**
30 |      * Constructs the custom {@link FlightIdSequencingPolicy}.
31 |      *
32 |      * @return the custom {@link FlightIdSequencingPolicy}
33 |      */
34 |     @Bean
35 |     @Qualifier("flightIdSequencingPolicy")
36 |     @ConditionalOnProperty(value = "policy", havingValue = "custom")
37 |     public SequencingPolicy<EventMessage<?>> flightIdSequencingPolicy() {
38 |         return new FlightIdSequencingPolicy();
39 |     }
40 | 
41 |     /**
42 |      * Constructs a {@link PropertySequencingPolicy} instance.
43 |      * <p>
44 |      * Added to show that the {@code PropertySequencingPolicy} in essence works identical as the custom
45 |      * {@link FlightIdSequencingPolicy}.
46 |      *
47 |      * @return a {@link PropertySequencingPolicy} using the {@link FlightId} to sequence on
48 |      */
49 |     @SuppressWarnings("rawtypes")
50 |     @Bean
51 |     @Qualifier("propertySequencingPolicy")
52 |     @ConditionalOnProperty(value = "policy", havingValue = "property")
53 |     public SequencingPolicy<EventMessage> propertySequencingPolicy() {
54 |         return PropertySequencingPolicy.builder(FlightEvent.class, FlightId.class)
55 |                                        .propertyName("flightId")
56 |                                        .build();
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/FlightIdSequencingPolicy.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy;
 2 | 
 3 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightEvent;
 4 | import org.axonframework.eventhandling.EventMessage;
 5 | import org.axonframework.eventhandling.async.SequencingPolicy;
 6 | 
 7 | /**
 8 |  * Custom implementation of the {@link SequencingPolicy} that returns the
 9 |  * {@link io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightId} from {@link FlightEvent} implementations.
10 |  * <p>
11 |  * This ensures a given segment of the event stream will handle all the {@code FlightEvents} with the same
12 |  * {@code FlightId} in the correct order. If the event being handled isn't an implementation of {@code FlightEvent},
13 |  * {@code null} is returned.
14 |  * <p>
15 |  * Key in simplifying this implementation, is the {@code FlightEvent} interface that is implemented by all flight
16 |  * related events. Without this, every implementation should be validated separately.
17 |  *
18 |  * @author Steven van Beelen
19 |  */
20 | public class FlightIdSequencingPolicy implements SequencingPolicy<EventMessage<?>> {
21 | 
22 |     @Override
23 |     public Object getSequenceIdentifierFor(EventMessage<?> event) {
24 |         return FlightEvent.class.isAssignableFrom(event.getPayloadType())
25 |                 ? ((FlightEvent) event.getPayload()).flightId()
26 |                 : null; // when returning null, Axon will default to EventMessage#getIdentifier
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/SequencingPolicyApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | 
 6 | @SpringBootApplication
 7 | public class SequencingPolicyApplication {
 8 | 
 9 |     public static void main(String[] args) {
10 |         SpringApplication.run(SequencingPolicyApplication.class, args);
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/coreapi/ArrivalTimeChangedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy.coreapi;
 2 | 
 3 | import java.time.Instant;
 4 | 
 5 | public record ArrivalTimeChangedEvent(
 6 |         FlightId flightId,
 7 |         Instant newArrivalTime
 8 | ) implements FlightEvent {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/coreapi/FlightCanceledEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.sequencingpolicy.coreapi;
2 | 
3 | public record FlightCanceledEvent(FlightId flightId) implements FlightEvent {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/coreapi/FlightDelayedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy.coreapi;
 2 | 
 3 | import java.time.Duration;
 4 | 
 5 | public record FlightDelayedEvent(
 6 |         FlightId flightId,
 7 |         Duration delay
 8 | ) implements FlightEvent {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/coreapi/FlightEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy.coreapi;
 2 | 
 3 | /**
 4 |  * Common base event to implement by every flight event.
 5 |  * <p>
 6 |  * This common base interface ensures Axon can use logic based on the {@link FlightId} without knowing all flight event
 7 |  * implementations.
 8 |  *
 9 |  * @author Steven van Beelen
10 |  */
11 | public interface FlightEvent {
12 | 
13 |     FlightId flightId();
14 | }
15 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/coreapi/FlightId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.sequencingpolicy.coreapi;
2 | 
3 | public record FlightId(String id) {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/coreapi/FlightScheduledEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy.coreapi;
 2 | 
 3 | import java.time.LocalDateTime;
 4 | 
 5 | public record FlightScheduledEvent(
 6 |         FlightId flightId,
 7 |         String origin,
 8 |         String destination,
 9 |         LocalDateTime arrivalTime
10 | ) implements FlightEvent {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/java/io/axoniq/dev/samples/sequencingpolicy/querymodel/FlightTimeProjector.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy.querymodel;
 2 | 
 3 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.ArrivalTimeChangedEvent;
 4 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightCanceledEvent;
 5 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightDelayedEvent;
 6 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightScheduledEvent;
 7 | import org.axonframework.config.ProcessingGroup;
 8 | import org.axonframework.eventhandling.EventHandler;
 9 | import org.slf4j.Logger;
10 | import org.slf4j.LoggerFactory;
11 | import org.springframework.stereotype.Component;
12 | 
13 | import java.lang.invoke.MethodHandles;
14 | 
15 | /**
16 |  * Simple projector logging the {@link io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightId} and
17 |  * {@link Thread#getId()} for every event it handles.
18 |  * <p>
19 |  * Doing so shows in the logs that the same thread is in charge of all events for a given {@code FlightId}. This further
20 |  * shows that the {@link org.axonframework.eventhandling.async.SequencingPolicy} based on the {@code FlightId} is in
21 |  * effect.
22 |  */
23 | @Component
24 | @ProcessingGroup("flight-time")
25 | public class FlightTimeProjector {
26 | 
27 |     private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
28 | 
29 |     @EventHandler
30 |     public void on(FlightScheduledEvent event) {
31 |         logger.info("Thread[{}] handling FlightScheduledEvent with Flight Id [{}]",
32 |                     Thread.currentThread().getId(), event.flightId());
33 |     }
34 | 
35 |     @EventHandler
36 |     public void on(FlightDelayedEvent event) {
37 |         logger.info("Thread[{}] handling FlightDelayedEvent with Flight Id [{}]",
38 |                     Thread.currentThread().getId(), event.flightId());
39 |     }
40 | 
41 |     @EventHandler
42 |     public void on(FlightCanceledEvent event) {
43 |         logger.info("Thread[{}] handling FlightCanceledEvent with Flight Id [{}]",
44 |                     Thread.currentThread().getId(), event.flightId());
45 |     }
46 | 
47 |     @EventHandler
48 |     public void on(ArrivalTimeChangedEvent event) {
49 |         logger.info("Thread[{}] handling ArrivalTimeChangedEvent with Flight Id [{}]",
50 |                     Thread.currentThread().getId(), event.flightId());
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/sequencing-policy/src/main/resources/application-property.properties:
--------------------------------------------------------------------------------
1 | policy=property
2 | axon.eventhandling.processors.flight-time.sequencing-policy=propertySequencingPolicy


--------------------------------------------------------------------------------
/sequencing-policy/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | policy=custom
2 | axon.eventhandling.processors.flight-time.thread-count=4
3 | axon.eventhandling.processors.flight-time.initial-segment-count=4
4 | axon.eventhandling.processors.flight-time.sequencing-policy=flightIdSequencingPolicy


--------------------------------------------------------------------------------
/sequencing-policy/src/test/java/io/axoniq/dev/samples/sequencingpolicy/FlightIdSequencingPolicyTest.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.sequencingpolicy;
 2 | 
 3 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightCanceledEvent;
 4 | import io.axoniq.dev.samples.sequencingpolicy.coreapi.FlightId;
 5 | import org.axonframework.eventhandling.EventMessage;
 6 | import org.axonframework.eventhandling.GenericEventMessage;
 7 | import org.junit.jupiter.api.*;
 8 | 
 9 | import java.util.UUID;
10 | 
11 | import static org.junit.jupiter.api.Assertions.*;
12 | 
13 | class FlightIdSequencingPolicyTest {
14 | 
15 |     private final FlightIdSequencingPolicy testSubject = new FlightIdSequencingPolicy();
16 | 
17 |     @Test
18 |     void testReturnsNullForNoneFlightEvent() {
19 |         EventMessage<Object> testEvent = GenericEventMessage.asEventMessage("some-event");
20 | 
21 |         assertNull(testSubject.getSequenceIdentifierFor(testEvent));
22 |     }
23 | 
24 |     @Test
25 |     void testReturnsFlightIdForFlightEventImplementations() {
26 |         FlightId expectedResult = new FlightId(UUID.randomUUID().toString());
27 | 
28 |         FlightCanceledEvent testEvent = new FlightCanceledEvent(expectedResult);
29 |         EventMessage<Object> testEventMessage = GenericEventMessage.asEventMessage(testEvent);
30 | 
31 |         assertEquals(expectedResult, testSubject.getSequenceIdentifierFor(testEventMessage));
32 |     }
33 | }


--------------------------------------------------------------------------------
/serialization-avro/.docker/config/axonserver.yaml:
--------------------------------------------------------------------------------
 1 | axoniq:
 2 |   axonserver:
 3 |     name: axonserver-serialization-avro
 4 |     hostname: localhost
 5 |     standalone: true
 6 |     accesscontrol:
 7 |       enabled: false
 8 |       tokendir: ./data
 9 |     devmode:
10 |       enabled: true
11 |     event:
12 |       segment-size: 1000000 # 1mb for small segments
13 |     snapshot:
14 |       segment-size: 1000000 # 1mb for small segments
15 | 


--------------------------------------------------------------------------------
/serialization-avro/.gitignore:
--------------------------------------------------------------------------------
1 | .docker
2 | !.docker/config


--------------------------------------------------------------------------------
/serialization-avro/README.md:
--------------------------------------------------------------------------------
 1 | # Serialization with Apache Avro
 2 | 
 3 | This sample demonstrates usage of Apache Avro as the serializer for messaging and storage of events inside Axon Server.
 4 | For commands, events, queries, and query responses the Avro schema definitions are provided and are located 
 5 | in `src/main/avro` directory. 
 6 | 
 7 | 
 8 | Here is an example schema for the `CardIssuedEvent` event:
 9 | 
10 | 
11 | ```avroschema
12 | {
13 |     "type": "record",
14 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
15 |     "name": "CardIssuedEvent",
16 |     "doc": "A new gift card is issued.",
17 |     "revision": "1",
18 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
19 |     "fields": [
20 |         {
21 |             "name": "id",
22 |             "type": "string"
23 |         },
24 |         {
25 |             "name": "amount",
26 |             "type": "int"
27 |         }
28 |     ]
29 | }
30 | ```
31 | 
32 | Using the `avro-maven-plugin`, the Java classes are generated into `target/generated-sources/avro` directory 
33 | during the `generate-sources` build phase. 
34 | 
35 | The remaining part of the application is a standard implementation of a gift card application, that uses the 
36 | `AvroSerializer` by applying configuration of the serializer using application properties.
37 | 
38 | ```yaml
39 | 
40 | axon:
41 |   serializer:
42 |     events: avro
43 |     messages: avro
44 |     general: jackson
45 | 
46 | ```
47 | 
48 | ## Running example
49 | 
50 | To run the example, build it using Apache Maven by running `./mvnw clean install` and then execute the following
51 | command from your command line: `./mvnw -Prun -f serialization-avro`.
52 | If you want to run it from your IDEA IntelliJ, just start the:
53 | 
54 | `SerializationAvroApplication`
55 | 
56 | Inspect the `serialization-avro/requests.http` and run the script to exchange some messages. If you want to inspect
57 | the events stored in the AxonServer, please open the AxonServer Dashboard http://localhost:8024/.
58 | 
59 | 
60 | 


--------------------------------------------------------------------------------
/serialization-avro/docker-compose.yml:
--------------------------------------------------------------------------------
 1 | services:
 2 |   axonserver:
 3 |     image: axoniq/axonserver
 4 |     container_name: axonserver-serialization-avro
 5 |     ports:
 6 |       - '8024:8024'
 7 |       - '8124:8124'
 8 |     volumes:
 9 |       - .docker/config:/axonserver/config:ro
10 |       - .docker/data:/axonserver/data
11 |       - .docker/events:/axonserver/events
12 |       - .docker/log:/axonserver/log
13 |       - .docker/plugins:/axonserver/plugins
14 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.command.IssueCard.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "IssueCardCommand",
 5 |     "doc": "Issues a new gift card.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |         {
10 |             "name": "id",
11 |             "type": "string",
12 |             "javaAnnotation": "org.axonframework.modelling.command.TargetAggregateIdentifier"
13 |         },
14 |         {
15 |             "name": "amount",
16 |             "type": "int"
17 |         }
18 |     ]
19 | }
20 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.command.RedeemCard.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "RedeemCardCommand",
 5 |     "doc": "Redeems existing gift card.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |         {
10 |             "name": "id",
11 |             "type": "string",
12 |             "javaAnnotation": "org.axonframework.modelling.command.TargetAggregateIdentifier"
13 |         },
14 |         {
15 |             "name": "amount",
16 |             "type": "int"
17 |         }
18 |     ]
19 | }
20 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.event.CardIssued.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "CardIssuedEvent",
 5 |     "doc": "A new gift card is issued.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |         {
10 |             "name": "id",
11 |             "type": "string"
12 |         },
13 |         {
14 |             "name": "amount",
15 |             "type": "int"
16 |         }
17 |     ]
18 | }
19 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.event.CardRedeemed.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "CardRedeemedEvent",
 5 |     "doc": "Existing gift card is redeemed.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |         {
10 |             "name": "id",
11 |             "type": "string"
12 |         },
13 |         {
14 |             "name": "amount",
15 |             "type": "int"
16 |         }
17 |     ]
18 | }
19 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.query.CardList.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "CardList",
 5 |     "doc": "Represents a list of gift cards.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |         {
10 |             "name": "elements",
11 |             "type": {
12 |                 "type": "array",
13 |                 "items": {
14 |                     "name": "Card",
15 |                     "doc": "Represents a gift card.",
16 |                     "type": "record",
17 |                     "fields": [
18 |                         {
19 |                             "name": "id",
20 |                             "type": "string"
21 |                         },
22 |                         {
23 |                             "name": "amount",
24 |                             "type": "int"
25 |                         }
26 |                     ]
27 |                 }
28 |             }
29 |         }
30 |     ]
31 | }
32 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.query.GetAllCards.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "GetAllCardsQuery",
 5 |     "doc": "Query for all gift cards.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |     ]
10 | }
11 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/avro/giftcard.query.GetCardById.avsc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "type": "record",
 3 |     "namespace": "io.axoniq.dev.samples.serializationavro.api",
 4 |     "name": "GetCardByIdQuery",
 5 |     "doc": "Query for git card by given id.",
 6 |     "revision": "1",
 7 |     "javaAnnotation": "org.axonframework.serialization.Revision(\"1\")",
 8 |     "fields": [
 9 |         {
10 |             "name": "id",
11 |             "type": "string"
12 |         }
13 |     ]
14 | }
15 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/SerializationAvroApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.serializationavro;
 2 | 
 3 | import io.axoniq.dev.samples.serializationavro.api.Card;
 4 | import io.axoniq.dev.samples.serializationavro.api.CardIssuedEvent;
 5 | import io.axoniq.dev.samples.serializationavro.api.CardList;
 6 | import io.axoniq.dev.samples.serializationavro.api.CardRedeemedEvent;
 7 | import io.axoniq.dev.samples.serializationavro.api.GetAllCardsQuery;
 8 | import io.axoniq.dev.samples.serializationavro.api.GetCardByIdQuery;
 9 | import io.axoniq.dev.samples.serializationavro.api.IssueCardCommand;
10 | import io.axoniq.dev.samples.serializationavro.api.RedeemCardCommand;
11 | import org.apache.avro.message.SchemaStore;
12 | import org.axonframework.spring.serialization.avro.AvroSchemaScan;
13 | import org.springframework.boot.SpringApplication;
14 | import org.springframework.boot.autoconfigure.SpringBootApplication;
15 | import org.springframework.context.annotation.Bean;
16 | import org.springframework.context.annotation.Profile;
17 | 
18 | @SpringBootApplication
19 | @AvroSchemaScan
20 | public class SerializationAvroApplication {
21 | 
22 |     public static void main(String[] args) {
23 |         System.setProperty("disable-axoniq-console-message", "true");
24 |         SpringApplication.run(SerializationAvroApplication.class, args);
25 |     }
26 | 
27 |     @Profile("manualSchemaStore")
28 |     @Bean("defaultAxonSchemaStore")
29 |     public SchemaStore defaultAxonSchemaStore() {
30 |         var cache = new SchemaStore.Cache();
31 |         cache.addSchema(Card.SCHEMA$);
32 |         cache.addSchema(CardIssuedEvent.SCHEMA$);
33 |         cache.addSchema(CardList.SCHEMA$);
34 |         cache.addSchema(CardRedeemedEvent.SCHEMA$);
35 |         cache.addSchema(GetAllCardsQuery.SCHEMA$);
36 |         cache.addSchema(GetCardByIdQuery.SCHEMA$);
37 |         cache.addSchema(IssueCardCommand.SCHEMA$);
38 |         cache.addSchema(RedeemCardCommand.SCHEMA$);
39 |         return cache;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/api/GiftCardException.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.serializationavro.api;
 2 | 
 3 | 
 4 | /**
 5 |  * Domain specific exception
 6 |  *
 7 |  * @author Stefan Andjelkovic
 8 |  */
 9 | public class GiftCardException extends RuntimeException {
10 | 
11 |     public enum GiftCardBusinessErrorCode {
12 |         NEGATIVE_AMOUNT,
13 |         INSUFFICIENT_FUNDS,
14 |         UNKNOWN
15 |     }
16 | 
17 |     private final String errorMessage;
18 |     private final GiftCardBusinessErrorCode errorCode;
19 | 
20 |     public GiftCardException(String errorMessage, GiftCardBusinessErrorCode errorCode) {
21 |         super(errorMessage);
22 |         this.errorMessage = errorMessage;
23 |         this.errorCode = errorCode;
24 |     }
25 | 
26 |     public String getErrorMessage() {
27 |         return errorMessage;
28 |     }
29 | 
30 |     public GiftCardBusinessErrorCode getErrorCode() {
31 |         return errorCode;
32 |     }
33 | }
34 | 
35 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/api/InsufficientFunds.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.serializationavro.api;
 2 | 
 3 | public class InsufficientFunds extends GiftCardException {
 4 | 
 5 |     public InsufficientFunds() {
 6 |         super("amount > remaining value", GiftCardBusinessErrorCode.INSUFFICIENT_FUNDS);
 7 |     }
 8 | 
 9 |     public InsufficientFunds(String errorMessage) {
10 |         super(errorMessage, GiftCardBusinessErrorCode.INSUFFICIENT_FUNDS);
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/api/NegativeOrZeroAmount.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.serializationavro.api;
 2 | 
 3 | public class NegativeOrZeroAmount extends GiftCardException {
 4 | 
 5 |     private int amount;
 6 | 
 7 |     public NegativeOrZeroAmount(int amount) {
 8 |         super("amount $amount <=0", GiftCardBusinessErrorCode.NEGATIVE_AMOUNT);
 9 |     }
10 | 
11 |     public NegativeOrZeroAmount(int amount, String errorMessage) {
12 |         super(errorMessage, GiftCardBusinessErrorCode.NEGATIVE_AMOUNT);
13 |     }
14 | 
15 |     public int getAmount() {
16 |         return amount;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/command/GiftCard.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.serializationavro.command;
 2 | 
 3 | import io.axoniq.dev.samples.serializationavro.api.*;
 4 | import org.axonframework.commandhandling.CommandHandler;
 5 | import org.axonframework.eventsourcing.EventSourcingHandler;
 6 | import org.axonframework.modelling.command.AggregateIdentifier;
 7 | import org.axonframework.spring.stereotype.Aggregate;
 8 | import org.slf4j.Logger;
 9 | import org.slf4j.LoggerFactory;
10 | 
11 | import java.lang.invoke.MethodHandles;
12 | 
13 | import static org.axonframework.modelling.command.AggregateLifecycle.apply;
14 | 
15 | @Aggregate
16 | class GiftCard {
17 | 
18 |     private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
19 | 
20 |     @AggregateIdentifier
21 |     private String giftCardId;
22 |     private int remainingValue;
23 | 
24 |     public GiftCard() {
25 |         // Required by Axon
26 |         logger.debug("Empty constructor invoked");
27 |     }
28 | 
29 |     @CommandHandler
30 |     public GiftCard(IssueCardCommand command) {
31 |         logger.debug("handling {}", command);
32 |         if (command.getAmount() <= 0) {
33 |             throw new NegativeOrZeroAmount(command.getAmount(), "amount <= 0");
34 |         }
35 |         apply(new CardIssuedEvent(command.getId(), command.getAmount()));
36 |     }
37 | 
38 |     @CommandHandler
39 |     public void handle(RedeemCardCommand command) {
40 |         logger.debug("handling {}", command);
41 |         if (command.getAmount() <= 0) {
42 |             throw new NegativeOrZeroAmount(command.getAmount(), "amount <= 0");
43 |         }
44 |         if (command.getAmount() > remainingValue) {
45 |             throw new InsufficientFunds("amount > remaining value");
46 |         }
47 |         apply(new CardRedeemedEvent(giftCardId, command.getAmount()));
48 |     }
49 | 
50 |     @EventSourcingHandler
51 |     public void on(CardIssuedEvent event) {
52 |         logger.debug("applying {}", event);
53 |         giftCardId = event.getId();
54 |         remainingValue = event.getAmount();
55 |         logger.debug("new remaining value: {}", remainingValue);
56 |     }
57 | 
58 |     @EventSourcingHandler
59 |     public void on(CardRedeemedEvent event) {
60 |         logger.debug("applying {}", event);
61 |         remainingValue -= event.getAmount();
62 |         logger.debug("new remaining value: {}", remainingValue);
63 |     }
64 | }
65 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/query/GiftCardProjection.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.serializationavro.query;
 2 | 
 3 | import io.axoniq.dev.samples.serializationavro.api.Card;
 4 | import io.axoniq.dev.samples.serializationavro.api.CardIssuedEvent;
 5 | import io.axoniq.dev.samples.serializationavro.api.CardList;
 6 | import io.axoniq.dev.samples.serializationavro.api.CardRedeemedEvent;
 7 | import io.axoniq.dev.samples.serializationavro.api.GetAllCardsQuery;
 8 | import io.axoniq.dev.samples.serializationavro.api.GetCardByIdQuery;
 9 | import org.axonframework.eventhandling.EventHandler;
10 | import org.axonframework.queryhandling.QueryHandler;
11 | import org.springframework.stereotype.Component;
12 | 
13 | import java.util.Optional;
14 | import java.util.concurrent.ConcurrentHashMap;
15 | 
16 | @Component
17 | public class GiftCardProjection {
18 | 
19 |     private final ConcurrentHashMap<String, Card> store = new ConcurrentHashMap<>();
20 | 
21 |     @EventHandler
22 |     public void on(CardIssuedEvent event) {
23 |         store.put(event.getId(), new Card(event.getId(), event.getAmount()));
24 |     }
25 | 
26 |     @EventHandler
27 |     public void on(CardRedeemedEvent event) {
28 |         store.computeIfPresent(event.getId(), (key, card) -> new Card(key, card.getAmount() - event.getAmount()));
29 |     }
30 | 
31 |     @QueryHandler
32 |     public CardList getCards(GetAllCardsQuery query) {
33 |         return new CardList(store.values().stream().toList());
34 |     }
35 | 
36 |     @QueryHandler
37 |     public Card getCardById(GetCardByIdQuery query) {
38 |         return Optional.ofNullable(store.get(query.getId())).orElseThrow(() -> new IllegalArgumentException("No card with id " + query.getId()));
39 |     }
40 | 
41 | }
42 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/rest/CardDto.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.serializationavro.rest;
2 | 
3 | import com.fasterxml.jackson.annotation.JsonProperty;
4 | 
5 | public record CardDto(@JsonProperty("id") String id, @JsonProperty("amount") int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/rest/IssueCardDto.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.serializationavro.rest;
2 | 
3 | import com.fasterxml.jackson.annotation.JsonProperty;
4 | 
5 | public record IssueCardDto(@JsonProperty("amount") int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/java/io/axoniq/dev/samples/serializationavro/rest/RedeemCardDto.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.serializationavro.rest;
2 | 
3 | import com.fasterxml.jackson.annotation.JsonProperty;
4 | 
5 | public record RedeemCardDto(@JsonProperty("amount") int amount) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/serialization-avro/src/main/resources/application.yaml:
--------------------------------------------------------------------------------
 1 | spring:
 2 |   docker:
 3 |     compose:
 4 |       enabled: true
 5 |       file: serialization-avro/docker-compose.yml
 6 | 
 7 | server:
 8 |   port: 8282
 9 | 
10 | axon:
11 |   serializer:
12 |     events: avro
13 |     messages: avro
14 |     general: jackson


--------------------------------------------------------------------------------
/serialization-avro/src/main/resources/banner.txt:
--------------------------------------------------------------------------------
1 | ------------------------------------------------------------------------------------------------------------------------
2 | Gift card sample application using Apache Avro Serialization for messages and events
3 | 
4 |  powered by SpringBoot ${spring-boot.version}
5 |  running on http://localhost:${server.port}
6 | ------------------------------------------------------------------------------------------------------------------------
7 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <parent>
 6 |         <artifactId>code-samples</artifactId>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <version>0.0.2-SNAPSHOT</version>
 9 |     </parent>
10 |     <modelVersion>4.0.0</modelVersion>
11 | 
12 |     <artifactId>set-based-validation-actor-model</artifactId>
13 | 
14 |     <name>Set-Based Validation - Actor Model</name>
15 |     <description>Module explaining an approach to deal with Set-Based Validation by using the Actor Model</description>
16 | 
17 |     <dependencies>
18 |         <!-- Axon -->
19 |         <dependency>
20 |             <groupId>org.axonframework</groupId>
21 |             <artifactId>axon-spring-boot-starter</artifactId>
22 |         </dependency>
23 |         <!-- Spring -->
24 |         <dependency>
25 |             <groupId>org.springframework.boot</groupId>
26 |             <artifactId>spring-boot-starter-web</artifactId>
27 |         </dependency>
28 |     </dependencies>
29 | </project>


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/SetBasedValidationActorModelApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | 
 6 | @SpringBootApplication
 7 | public class SetBasedValidationActorModelApplication {
 8 | 
 9 |     public static void main(String[] args) {
10 |         SpringApplication.run(SetBasedValidationActorModelApplication.class, args);
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/commands/RegisterUserWithUniqueEmailAddressCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.commands;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record RegisterUserWithUniqueEmailAddressCommand(
 8 |         @TargetAggregateIdentifier String email,
 9 |         UUID userId
10 | ) {
11 | 
12 | }


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/commands/RemoveUserCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.commands;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record RemoveUserCommand(
 8 |         @TargetAggregateIdentifier UUID userId
 9 | ) {
10 | 
11 | }


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/commands/RemoveUserWithUniqueEmailAddressCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.commands;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record RemoveUserWithUniqueEmailAddressCommand(
 8 |         @TargetAggregateIdentifier String email,
 9 |         UUID userId
10 | ) {
11 | 
12 | }


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/dto/RegisterUserDto.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.dto;
 2 | 
 3 | public class RegisterUserDto {
 4 | 
 5 |     private String emailAddress;
 6 | 
 7 |     public RegisterUserDto(String emailAddress) {
 8 |         this.emailAddress = emailAddress;
 9 |     }
10 | 
11 |     public RegisterUserDto() {
12 |     }
13 | 
14 |     public String getEmailAddress() {
15 |         return emailAddress;
16 |     }
17 | 
18 |     public void setEmailAddress(String emailAddress) {
19 |         this.emailAddress = emailAddress;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/dto/UpdateEmailFromUserDto.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.dto;
 2 | 
 3 | import java.util.UUID;
 4 | 
 5 | public class UpdateEmailFromUserDto {
 6 | 
 7 |     private String emailAddress;
 8 |     private String formerEmailAddress;
 9 |     private UUID userId;
10 | 
11 |     public UpdateEmailFromUserDto(String emailAddress, String formerEmailAddress) {
12 |         this.emailAddress = emailAddress;
13 |         this.formerEmailAddress = formerEmailAddress;
14 |     }
15 | 
16 |     public UpdateEmailFromUserDto() {
17 |     }
18 | 
19 |     public String getEmailAddress() {
20 |         return emailAddress;
21 |     }
22 | 
23 |     public void setEmailAddress(String emailAddress) {
24 |         this.emailAddress = emailAddress;
25 |     }
26 | 
27 |     public String getFormerEmailAddress() {
28 |         return formerEmailAddress;
29 |     }
30 | 
31 |     public void setFormerEmailAddress(String formerEmailAddress) {
32 |         this.formerEmailAddress = formerEmailAddress;
33 |     }
34 | 
35 |     public UUID getUserId() {
36 |         return userId;
37 |     }
38 | 
39 |     public void setUserId(UUID userId) {
40 |         this.userId = userId;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/events/EmailAddressApprovedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.events;
 2 | 
 3 | import java.util.UUID;
 4 | 
 5 | public record EmailAddressApprovedEvent(
 6 |         String emailAddress,
 7 |         UUID userId
 8 | ) {
 9 | }
10 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/events/EmailAddressRemovedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.events;
 2 | 
 3 | import java.util.UUID;
 4 | 
 5 | public record EmailAddressRemovedEvent(
 6 |         String emailAddress,
 7 |         UUID userId
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/events/UserRegisteredEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.events;
 2 | 
 3 | import java.util.UUID;
 4 | 
 5 | public record UserRegisteredEvent(
 6 |         UUID userId,
 7 |         String email
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/api/events/UserRemovedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api.events;
 2 | 
 3 | import java.util.UUID;
 4 | 
 5 | public record UserRemovedEvent(
 6 |         UUID userId
 7 | ) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/command/aggregate/EmailUniquenessCheck.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.aggregate;
 2 | 
 3 | import io.axoniq.dev.samples.api.commands.RegisterUserWithUniqueEmailAddressCommand;
 4 | import io.axoniq.dev.samples.api.commands.RemoveUserWithUniqueEmailAddressCommand;
 5 | import io.axoniq.dev.samples.api.events.EmailAddressApprovedEvent;
 6 | import io.axoniq.dev.samples.api.events.EmailAddressRemovedEvent;
 7 | import org.axonframework.commandhandling.CommandHandler;
 8 | import org.axonframework.eventsourcing.EventSourcingHandler;
 9 | import org.axonframework.modelling.command.AggregateCreationPolicy;
10 | import org.axonframework.modelling.command.AggregateIdentifier;
11 | import org.axonframework.modelling.command.AggregateLifecycle;
12 | import org.axonframework.modelling.command.CreationPolicy;
13 | import org.axonframework.spring.stereotype.Aggregate;
14 | import org.springframework.util.Assert;
15 | 
16 | import java.util.UUID;
17 | 
18 | @Aggregate
19 | class EmailUniquenessCheck {
20 | 
21 |     @AggregateIdentifier
22 |     private String emailAddress;
23 |     private UUID userId;
24 |     private boolean claimed = false;
25 | 
26 |     @CommandHandler
27 |     @CreationPolicy(AggregateCreationPolicy.CREATE_IF_MISSING)
28 |     public void handle(RegisterUserWithUniqueEmailAddressCommand command) throws Exception {
29 |         // A user should only be registered when the email address has not been claimed
30 |         Assert.isTrue(!claimed, () -> "A user with this email address already exists");
31 |         AggregateLifecycle.createNew(User.class, () -> new User(command.userId(), command.email()));
32 |         AggregateLifecycle.apply(new EmailAddressApprovedEvent(command.email(), command.userId()));
33 |     }
34 | 
35 |     @CommandHandler
36 |     public void handle(RemoveUserWithUniqueEmailAddressCommand command) {
37 |         Assert.isTrue(claimed, () -> "This email address has not been claimed");
38 |         AggregateLifecycle.apply(new EmailAddressRemovedEvent(command.email(), userId));
39 |     }
40 | 
41 |     @EventSourcingHandler
42 |     public void on(EmailAddressApprovedEvent event) {
43 |         this.emailAddress = event.emailAddress();
44 |         this.claimed = true;
45 |         this.userId = event.userId();
46 |     }
47 | 
48 |     @EventSourcingHandler
49 |     public void on(EmailAddressRemovedEvent event) {
50 |         this.claimed = false;
51 |     }
52 | 
53 |     public EmailUniquenessCheck() {
54 |         // needed by Axon
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/command/aggregate/User.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.aggregate;
 2 | 
 3 | import io.axoniq.dev.samples.api.commands.RemoveUserCommand;
 4 | import io.axoniq.dev.samples.api.events.UserRegisteredEvent;
 5 | import io.axoniq.dev.samples.api.events.UserRemovedEvent;
 6 | import org.axonframework.commandhandling.CommandHandler;
 7 | import org.axonframework.eventsourcing.EventSourcingHandler;
 8 | import org.axonframework.modelling.command.AggregateIdentifier;
 9 | import org.axonframework.modelling.command.AggregateLifecycle;
10 | import org.axonframework.spring.stereotype.Aggregate;
11 | 
12 | import java.util.UUID;
13 | 
14 | @Aggregate
15 | class User {
16 | 
17 |     @AggregateIdentifier
18 |     public UUID userId;
19 | 
20 |     public User(UUID userId, String emailAddress) {
21 |         AggregateLifecycle.apply(new UserRegisteredEvent(userId, emailAddress));
22 |     }
23 | 
24 |     @CommandHandler
25 |     public void handle(RemoveUserCommand command) {
26 |         AggregateLifecycle.apply(new UserRemovedEvent(command.userId()));
27 |     }
28 | 
29 |     @EventSourcingHandler
30 |     public void handle(UserRegisteredEvent event) {
31 |         this.userId = event.userId();
32 |     }
33 | 
34 |     @EventSourcingHandler
35 |     public void handle(UserRemovedEvent event) {
36 |         AggregateLifecycle.markDeleted();
37 |     }
38 | 
39 |     public User() {
40 |         //needed by Axon
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/command/controller/UserController.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.controller;
 2 | 
 3 | import io.axoniq.dev.samples.api.commands.RegisterUserWithUniqueEmailAddressCommand;
 4 | import io.axoniq.dev.samples.api.commands.RemoveUserWithUniqueEmailAddressCommand;
 5 | import io.axoniq.dev.samples.api.dto.RegisterUserDto;
 6 | import io.axoniq.dev.samples.api.dto.UpdateEmailFromUserDto;
 7 | import org.axonframework.commandhandling.gateway.CommandGateway;
 8 | import org.slf4j.Logger;
 9 | import org.slf4j.LoggerFactory;
10 | import org.springframework.web.bind.annotation.PostMapping;
11 | import org.springframework.web.bind.annotation.PutMapping;
12 | import org.springframework.web.bind.annotation.RequestBody;
13 | import org.springframework.web.bind.annotation.RestController;
14 | 
15 | import java.lang.invoke.MethodHandles;
16 | import java.util.UUID;
17 | import java.util.concurrent.CompletableFuture;
18 | 
19 | @RestController
20 | public class UserController {
21 | 
22 |     private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
23 | 
24 |     private final CommandGateway commandGateway;
25 | 
26 |     public UserController(CommandGateway commandGateway) {
27 |         this.commandGateway = commandGateway;
28 |     }
29 | 
30 |     @PostMapping(path = "/users")
31 |     public CompletableFuture<Void> register(@RequestBody RegisterUserDto registerUserDto) {
32 |         UUID generatedUserId = UUID.randomUUID();
33 |         logger.info("UUID [{}]", generatedUserId);
34 |         return commandGateway.send(new RegisterUserWithUniqueEmailAddressCommand(
35 |                 registerUserDto.getEmailAddress(), generatedUserId
36 |         ));
37 |     }
38 | 
39 |     @PutMapping(path = "/users")
40 |     public CompletableFuture<Void> changeEmailAddress(@RequestBody UpdateEmailFromUserDto updateEmailFromUserDto) {
41 |         UUID generatedUserId = UUID.randomUUID();
42 |         commandGateway.sendAndWait(new RegisterUserWithUniqueEmailAddressCommand(
43 |                 updateEmailFromUserDto.getEmailAddress(), generatedUserId
44 |         ));
45 |         return commandGateway.send(new RemoveUserWithUniqueEmailAddressCommand(
46 |                 updateEmailFromUserDto.getFormerEmailAddress(), updateEmailFromUserDto.getUserId()
47 |         ));
48 |     }
49 | }
50 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/java/io/axoniq/dev/samples/query/eventhandler/UserEventHandler.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.query.eventhandler;
 2 | 
 3 | import io.axoniq.dev.samples.api.commands.RemoveUserCommand;
 4 | import io.axoniq.dev.samples.api.events.EmailAddressRemovedEvent;
 5 | import org.axonframework.commandhandling.gateway.CommandGateway;
 6 | import org.axonframework.eventhandling.EventHandler;
 7 | import org.springframework.stereotype.Component;
 8 | 
 9 | @Component
10 | public class UserEventHandler {
11 | 
12 |     private final CommandGateway commandGateway;
13 | 
14 |     public UserEventHandler(CommandGateway commandGateway) {
15 |         this.commandGateway = commandGateway;
16 |     }
17 | 
18 |     @EventHandler
19 |     public void handle(EmailAddressRemovedEvent event) {
20 |         commandGateway.send(new RemoveUserCommand(event.userId()));
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/set-based-validation-actor-model/src/main/resources/requests.http:
--------------------------------------------------------------------------------
 1 | ### Create a User and check if the email address exists
 2 | 
 3 | POST http://localhost:8080/users
 4 | Content-Type: application/json
 5 | 
 6 | {
 7 |   "emailAddress": "bob@gmail.com"
 8 | }
 9 | 
10 | ### Change the email address and release the claim on the email address. Take the userId from the create user.
11 | 
12 | PUT http://localhost:8080/users
13 | Content-Type: application/json
14 | 
15 | {
16 |   "emailAddress": "robert@gmail.com",
17 |   "formerEmailAddress": "bob@gmail.com",
18 |   "userId": "cd1f8637-d41c-4a37-bc75-cc052d2d262e"
19 | }


--------------------------------------------------------------------------------
/set-based-validation/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.3'
2 | services:
3 |   axonserver:
4 |     image: axoniq/axonserver
5 |     hostname: axonserver
6 |     ports:
7 |       - '8024:8024'
8 |       - '8124:8124'
9 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/SetBasedValidationApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | 
 6 | @SpringBootApplication
 7 | public class SetBasedValidationApplication {
 8 | 
 9 |     public static void main(String[] args) {
10 |         SpringApplication.run(SetBasedValidationApplication.class, args);
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/AccountCreatedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import com.fasterxml.jackson.annotation.JsonProperty;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record AccountCreatedEvent(
 8 |         @JsonProperty("accountId") UUID accountId,
 9 |         @JsonProperty("emailAddress") String emailAddress
10 | ) {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/AccountRequestData.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import java.util.Objects;
 4 | 
 5 | public class AccountRequestData {
 6 | 
 7 |     private String emailAddress;
 8 | 
 9 |     public AccountRequestData(String emailAddress) {
10 |         this.emailAddress = emailAddress;
11 |     }
12 | 
13 |     public AccountRequestData() {
14 |     }
15 | 
16 |     public String getEmailAddress() {
17 |         return emailAddress;
18 |     }
19 | 
20 |     public void setEmailAddress(String emailAddress) {
21 |         this.emailAddress = emailAddress;
22 |     }
23 | 
24 |     @Override
25 |     public boolean equals(Object o) {
26 |         if (this == o) {
27 |             return true;
28 |         }
29 |         if (o == null || getClass() != o.getClass()) {
30 |             return false;
31 |         }
32 |         AccountRequestData that = (AccountRequestData) o;
33 |         return Objects.equals(emailAddress, that.emailAddress);
34 |     }
35 | 
36 |     @Override
37 |     public int hashCode() {
38 |         return Objects.hash(emailAddress);
39 |     }
40 | 
41 |     @Override
42 |     public String toString() {
43 |         return "AccountRequestData{" +
44 |                 "emailAddress='" + emailAddress + '\'' +
45 |                 '}';
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/AlterEmailAddressCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record AlterEmailAddressCommand(
 8 |         @TargetAggregateIdentifier UUID accountId,
 9 |         String updatedEmailAddress
10 | ) {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/ChangeEmailAddressCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record ChangeEmailAddressCommand(
 8 |         @TargetAggregateIdentifier UUID accountId,
 9 |         String updatedEmailAddress
10 | ) {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/CreateAccountCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | public record CreateAccountCommand(
 8 |         @TargetAggregateIdentifier UUID accountId,
 9 |         String emailAddress
10 | ) {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/EmailAddressChangedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.api;
2 | 
3 | import java.util.UUID;
4 | 
5 | public record EmailAddressChangedEvent(UUID accountId, String emailAddress) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/api/RequestEmailChangeCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.commandhandling.RoutingKey;
 4 | 
 5 | import java.util.UUID;
 6 | 
 7 | /**
 8 |  * Since this command is routed to a command handling component, the RoutingKey annotation is used. The
 9 |  * TargetAggregateIdentifier could also be used because that has the RoutingKey meta annotated
10 |  */
11 | public record RequestEmailChangeCommand(
12 |         @RoutingKey UUID accountId,
13 |         String updatedEmailAddress
14 | ) {
15 | 
16 | }


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/command/handler/AccountCommandHandler.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.handler;
 2 | 
 3 | import io.axoniq.dev.samples.api.ChangeEmailAddressCommand;
 4 | import io.axoniq.dev.samples.api.RequestEmailChangeCommand;
 5 | import io.axoniq.dev.samples.command.persistence.EmailRepository;
 6 | import org.axonframework.commandhandling.CommandHandler;
 7 | import org.axonframework.commandhandling.gateway.CommandGateway;
 8 | import org.springframework.stereotype.Component;
 9 | 
10 | /**
11 |  * Command handling component that validates if the email address already exists. Links to the `Validation in an
12 |  * External Command Handler` section in this <a href="https://axoniq.io/blog-overview/set-based-validation">set based
13 |  * validation blog</a>.
14 |  *
15 |  * @author Yvonne Ceelie
16 |  */
17 | @Component
18 | public class AccountCommandHandler {
19 | 
20 |     @CommandHandler
21 |     public void handle(RequestEmailChangeCommand command, CommandGateway commandGateway,
22 |                        EmailRepository emailRepository) {
23 |         if (emailRepository.existsById(command.updatedEmailAddress())) {
24 |             throw new IllegalStateException(String.format("Account with email address %s already exists",
25 |                                                           command.updatedEmailAddress()));
26 |         }
27 |         commandGateway.send(new ChangeEmailAddressCommand(command.accountId(), command.updatedEmailAddress()));
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/command/handler/AccountEventHandler.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.handler;
 2 | 
 3 | import io.axoniq.dev.samples.api.AccountCreatedEvent;
 4 | import io.axoniq.dev.samples.api.EmailAddressChangedEvent;
 5 | import io.axoniq.dev.samples.command.persistence.EmailJpaEntity;
 6 | import io.axoniq.dev.samples.command.persistence.EmailRepository;
 7 | import org.axonframework.config.ProcessingGroup;
 8 | import org.axonframework.eventhandling.EventHandler;
 9 | import org.springframework.stereotype.Component;
10 | 
11 | import java.util.Optional;
12 | 
13 | /**
14 |  * Subscribing processor that updates lookup table with email addresses used in the Account. Links to the `Update the
15 |  * look-up table` section in this <a href="https://axoniq.io/blog-overview/set-based-validation">set based validation
16 |  * blog</a>.
17 |  *
18 |  * @author Yvonne Ceelie
19 |  */
20 | @Component
21 | @ProcessingGroup("emailEntity")
22 | public class AccountEventHandler {
23 | 
24 |     @EventHandler
25 |     public void on(AccountCreatedEvent event, EmailRepository emailRepository) {
26 |         emailRepository.save(new EmailJpaEntity(event.emailAddress(), event.accountId()));
27 |     }
28 | 
29 |     @EventHandler
30 |     public void on(EmailAddressChangedEvent event, EmailRepository emailRepository) {
31 |         Optional<EmailJpaEntity> emailEntityOptional = emailRepository
32 |                 .findEmailJpaEntityByAccountId(event.accountId());
33 |         emailEntityOptional.ifPresent(emailRepository::delete);
34 |         emailRepository.save(new EmailJpaEntity(event.emailAddress(), event.accountId()));
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/command/interceptor/AccountCreationDispatchInterceptor.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.interceptor;
 2 | 
 3 | import io.axoniq.dev.samples.api.CreateAccountCommand;
 4 | import io.axoniq.dev.samples.command.persistence.EmailRepository;
 5 | import org.axonframework.commandhandling.CommandMessage;
 6 | import org.axonframework.messaging.MessageDispatchInterceptor;
 7 | import org.springframework.stereotype.Component;
 8 | 
 9 | import java.util.List;
10 | import java.util.function.BiFunction;
11 | 
12 | /**
13 |  * Intercepts the create account command message and throws IllegalStateException when already account aggregate with
14 |  * email address already exists. Links to "Validation through a Dispatch Interceptor" section in this <a
15 |  * href="https://axoniq.io/blog-overview/set-based-validation">set based validation blog</a>.
16 |  *
17 |  * @author Yvonne Ceelie
18 |  */
19 | @Component
20 | public class AccountCreationDispatchInterceptor implements MessageDispatchInterceptor<CommandMessage<?>> {
21 | 
22 |     private final EmailRepository emailRepository;
23 | 
24 |     public AccountCreationDispatchInterceptor(EmailRepository emailRepository) {
25 |         this.emailRepository = emailRepository;
26 |     }
27 | 
28 |     @Override
29 |     public BiFunction<Integer, CommandMessage<?>, CommandMessage<?>> handle(List<? extends CommandMessage<?>> list) {
30 |         return (i, m) -> {
31 |             if (CreateAccountCommand.class.equals(m.getPayloadType())) {
32 |                 final CreateAccountCommand createAccountCommand = (CreateAccountCommand) m.getPayload();
33 |                 if (emailRepository.existsById(createAccountCommand.emailAddress())) {
34 |                     throw new IllegalStateException(String.format("Account with email address %s already exists",
35 |                                                                   createAccountCommand.emailAddress()));
36 |                 }
37 |             }
38 |             return m;
39 |         };
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/command/persistence/EmailJpaEntity.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.persistence;
 2 | 
 3 | import jakarta.persistence.Entity;
 4 | import jakarta.persistence.Id;
 5 | 
 6 | import java.util.Objects;
 7 | import java.util.UUID;
 8 | 
 9 | @Entity
10 | public class EmailJpaEntity {
11 | 
12 |     @Id
13 |     public String emailAddress;
14 | 
15 |     public UUID accountId;
16 | 
17 |     public EmailJpaEntity() {
18 |     }
19 | 
20 |     public EmailJpaEntity(String emailAddress, UUID accountId) {
21 |         this.accountId = accountId;
22 |         this.emailAddress = emailAddress;
23 |     }
24 | 
25 |     public String getEmailAddress() {
26 |         return emailAddress;
27 |     }
28 | 
29 |     public void setEmailAddress(String emailAddress) {
30 |         this.emailAddress = emailAddress;
31 |     }
32 | 
33 |     public UUID getAccountId() {
34 |         return accountId;
35 |     }
36 | 
37 |     public void setAccountId(UUID accountId) {
38 |         this.accountId = accountId;
39 |     }
40 | 
41 |     @Override
42 |     public boolean equals(Object o) {
43 |         if (this == o) {
44 |             return true;
45 |         }
46 |         if (o == null || getClass() != o.getClass()) {
47 |             return false;
48 |         }
49 |         EmailJpaEntity that = (EmailJpaEntity) o;
50 |         return Objects.equals(emailAddress, that.emailAddress) &&
51 |                 Objects.equals(accountId, that.accountId);
52 |     }
53 | 
54 |     @Override
55 |     public int hashCode() {
56 |         return Objects.hash(emailAddress, accountId);
57 |     }
58 | }
59 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/command/persistence/EmailRepository.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command.persistence;
 2 | 
 3 | import org.springframework.data.jpa.repository.JpaRepository;
 4 | 
 5 | import java.util.Optional;
 6 | import java.util.UUID;
 7 | 
 8 | public interface EmailRepository extends JpaRepository<EmailJpaEntity, String> {
 9 | 
10 |     Optional<EmailJpaEntity> findEmailJpaEntityByAccountId(UUID accountId);
11 | }


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/config/AxonConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.config;
 2 | 
 3 | import io.axoniq.dev.samples.command.interceptor.AccountCreationDispatchInterceptor;
 4 | import org.axonframework.commandhandling.CommandBus;
 5 | import org.axonframework.commandhandling.gateway.CommandGateway;
 6 | import org.axonframework.commandhandling.gateway.DefaultCommandGateway;
 7 | import org.springframework.context.annotation.Bean;
 8 | import org.springframework.context.annotation.Configuration;
 9 | 
10 | @Configuration
11 | public class AxonConfig {
12 | 
13 |     @Bean
14 |     public CommandGateway commandGateway(CommandBus commandBus,
15 |                                          AccountCreationDispatchInterceptor accountCreationDispatchInterceptor) {
16 |         return DefaultCommandGateway.builder()
17 |                                     .commandBus(commandBus)
18 |                                     .dispatchInterceptors(accountCreationDispatchInterceptor)
19 |                                     .build();
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/controller/AccountController.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.controller;
 2 | 
 3 | import io.axoniq.dev.samples.api.AccountRequestData;
 4 | import io.axoniq.dev.samples.api.ChangeEmailAddressCommand;
 5 | import io.axoniq.dev.samples.api.CreateAccountCommand;
 6 | import io.axoniq.dev.samples.api.RequestEmailChangeCommand;
 7 | import org.axonframework.commandhandling.gateway.CommandGateway;
 8 | import org.springframework.web.bind.annotation.PathVariable;
 9 | import org.springframework.web.bind.annotation.PostMapping;
10 | import org.springframework.web.bind.annotation.PutMapping;
11 | import org.springframework.web.bind.annotation.RequestBody;
12 | import org.springframework.web.bind.annotation.RestController;
13 | 
14 | import java.util.UUID;
15 | import java.util.concurrent.CompletableFuture;
16 | 
17 | @RestController
18 | public class AccountController {
19 | 
20 |     private final CommandGateway commandGateway;
21 | 
22 |     public AccountController(CommandGateway commandGateway) {
23 |         this.commandGateway = commandGateway;
24 |     }
25 | 
26 |     @PostMapping(path = "/accounts")
27 |     public CompletableFuture<Void> register(@RequestBody AccountRequestData accountRequestData) {
28 |         UUID accountId = UUID.randomUUID();
29 |         return commandGateway.send(new CreateAccountCommand(accountId, accountRequestData.getEmailAddress()));
30 |     }
31 | 
32 |     @PutMapping(path = "/accounts/{accountId}/requestUpdateEmailAddress")
33 |     public CompletableFuture<Void> requestUpdateEmailAddress(@RequestBody AccountRequestData accountRequestData,
34 |                                                              @PathVariable("accountId") UUID accountId) {
35 |         return commandGateway.send(new RequestEmailChangeCommand(accountId, accountRequestData.getEmailAddress()));
36 |     }
37 | 
38 |     @PutMapping(path = "/accounts/{accountId}/updateEmailAddress")
39 |     public CompletableFuture<Void> updateEmailAddress(@RequestBody AccountRequestData accountRequestData,
40 |                                                       @PathVariable("accountId") UUID accountId) {
41 |         return commandGateway.send(new ChangeEmailAddressCommand(accountId, accountRequestData.getEmailAddress()));
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/java/io/axoniq/dev/samples/resolver/EmailAlreadyExistsResolverFactory.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.resolver;
 2 | 
 3 | import io.axoniq.dev.samples.api.ChangeEmailAddressCommand;
 4 | import io.axoniq.dev.samples.command.persistence.EmailRepository;
 5 | import org.axonframework.messaging.Message;
 6 | import org.axonframework.messaging.annotation.ParameterResolver;
 7 | import org.axonframework.messaging.annotation.ParameterResolverFactory;
 8 | import org.springframework.beans.factory.annotation.Autowired;
 9 | import org.springframework.stereotype.Component;
10 | 
11 | import java.lang.reflect.Executable;
12 | import java.lang.reflect.Parameter;
13 | 
14 | /**
15 |  * This parameter resolver resolves to true if an account aggregate with email address already exists. Links to
16 |  * "Validation using a Parameter Resolver" section in this <a
17 |  * href="https://axoniq.io/blog-overview/set-based-validation">set based validation blog</a>.
18 |  *
19 |  * @author Yvonne Ceelie
20 |  */
21 | @Component
22 | public class EmailAlreadyExistsResolverFactory implements ParameterResolver<Boolean>, ParameterResolverFactory {
23 | 
24 |     private final EmailRepository emailRepository;
25 | 
26 |     @Autowired
27 |     public EmailAlreadyExistsResolverFactory(EmailRepository emailRepository) {
28 |         this.emailRepository = emailRepository;
29 |     }
30 | 
31 |     @Override
32 |     public ParameterResolver<Boolean> createInstance(Executable executable,
33 |                                                      Parameter[] parameters,
34 |                                                      int parameterIndex) {
35 |         return Boolean.class.equals(parameters[parameterIndex].getType()) ? this : null;
36 |     }
37 | 
38 |     @Override
39 |     public Boolean resolveParameterValue(Message<?> message) {
40 |         if (matches(message)) {
41 |             String emailAddress = ((ChangeEmailAddressCommand) message.getPayload()).updatedEmailAddress();
42 |             return emailRepository.findById(emailAddress).isPresent();
43 |         }
44 |         throw new IllegalArgumentException("Message payload not of type ChangeEmailAddressCommand");
45 |     }
46 | 
47 |     @Override
48 |     public boolean matches(Message<?> message) {
49 |         return ChangeEmailAddressCommand.class.isAssignableFrom(message.getPayloadType());
50 |     }
51 | 
52 |     @Override
53 |     public Class<?> supportedPayloadType() {
54 |         return ChangeEmailAddressCommand.class;
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/set-based-validation/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | axon.eventhandling.processors.emailEntity.mode=subscribing


--------------------------------------------------------------------------------
/set-based-validation/src/test/java/io/axoniq/dev/samples/handler/AccountEventHandlerTest.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.handler;
 2 | 
 3 | import io.axoniq.dev.samples.api.AccountCreatedEvent;
 4 | import io.axoniq.dev.samples.api.EmailAddressChangedEvent;
 5 | import io.axoniq.dev.samples.command.handler.AccountEventHandler;
 6 | import io.axoniq.dev.samples.command.persistence.EmailJpaEntity;
 7 | import io.axoniq.dev.samples.command.persistence.EmailRepository;
 8 | import org.junit.jupiter.api.*;
 9 | 
10 | import java.util.Optional;
11 | 
12 | import static org.mockito.Mockito.*;
13 | 
14 | class AccountEventHandlerTest {
15 | 
16 |     private static final java.util.UUID UUID = java.util.UUID.randomUUID();
17 |     private static final String EMAIL_ADDRESS = "bob@gmail.com";
18 | 
19 |     private final EmailRepository emailRepository = mock(EmailRepository.class);
20 | 
21 |     private AccountEventHandler testSubject;
22 | 
23 |     @BeforeEach
24 |     void setup() {
25 |         testSubject = new AccountEventHandler();
26 |     }
27 | 
28 |     @Test
29 |     void accountCreatedTest() {
30 |         testSubject.on(new AccountCreatedEvent(UUID, EMAIL_ADDRESS), emailRepository);
31 |         EmailJpaEntity emailJpaEntity = new EmailJpaEntity(EMAIL_ADDRESS, UUID);
32 |         verify(emailRepository).save(emailJpaEntity);
33 |     }
34 | 
35 |     @Test
36 |     void emailAddressChangedTest() {
37 |         when(emailRepository.findEmailJpaEntityByAccountId(UUID)).thenReturn(Optional.of(new EmailJpaEntity(
38 |                 EMAIL_ADDRESS,
39 |                 UUID)));
40 |         testSubject.on(new EmailAddressChangedEvent(UUID, EMAIL_ADDRESS), emailRepository);
41 |         EmailJpaEntity emailJpaEntity = new EmailJpaEntity(EMAIL_ADDRESS, UUID);
42 |         verify(emailRepository).delete(emailJpaEntity);
43 |         verify(emailRepository).save(emailJpaEntity);
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/snapshots/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.3'
2 | services:
3 |   axonserver:
4 |     image: axoniq/axonserver
5 |     hostname: axonserver
6 |     ports:
7 |       - '8024:8024'
8 |       - '8124:8124'
9 | 


--------------------------------------------------------------------------------
/snapshots/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xmlns="http://maven.apache.org/POM/4.0.0"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <modelVersion>4.0.0</modelVersion>
 6 |     <parent>
 7 |         <artifactId>code-samples</artifactId>
 8 |         <groupId>io.axoniq</groupId>
 9 |         <version>0.0.2-SNAPSHOT</version>
10 |     </parent>
11 | 
12 |     <artifactId>snapshots</artifactId>
13 | 
14 |     <name>Snapshotting</name>
15 |     <description>Module explaining how to enable Snapshotting for Aggregates</description>
16 | 
17 |     <dependencies>
18 |         <!-- Axon -->
19 |         <dependency>
20 |             <groupId>org.axonframework</groupId>
21 |             <artifactId>axon-spring-boot-starter</artifactId>
22 |         </dependency>
23 |         <!-- Spring -->
24 |         <dependency>
25 |             <groupId>org.springframework.boot</groupId>
26 |             <artifactId>spring-boot-starter-web</artifactId>
27 |         </dependency>
28 |         <dependency>
29 |             <groupId>org.springframework.boot</groupId>
30 |             <artifactId>spring-boot-starter-webflux</artifactId>
31 |             <scope>test</scope>
32 |         </dependency>
33 |         <!-- Testing -->
34 |         <dependency>
35 |             <groupId>org.junit.jupiter</groupId>
36 |             <artifactId>junit-jupiter</artifactId>
37 |             <scope>test</scope>
38 |         </dependency>
39 |         <dependency>
40 |             <groupId>org.testcontainers</groupId>
41 |             <artifactId>junit-jupiter</artifactId>
42 |             <scope>test</scope>
43 |         </dependency>
44 |     </dependencies>
45 | </project>


--------------------------------------------------------------------------------
/snapshots/requests.http:
--------------------------------------------------------------------------------
 1 | ### Create a new Entity with initial id of "entity-id" and name of "Entity Name".
 2 | POST http://localhost:8080/entity/entity-id?name="Entity Name"
 3 | Content-Type: application/json
 4 | 
 5 | {
 6 | }
 7 | 
 8 | ### Update the name of the Entity to "New Name".
 9 | PATCH http://localhost:8080/entity/entity-id?name="New Name"
10 | Content-Type: application/json
11 | 
12 | {
13 | }
14 | 
15 | ### Every time you send 5 Events to the Aggregate, you should see a Snapshot created log line.
16 | ### o.a.a.c.event.axon.AxonServerEventStore  : Snapshot created


--------------------------------------------------------------------------------
/snapshots/src/main/java/io/axoniq/dev/samples/SnapshottingApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.axonframework.eventsourcing.EventCountSnapshotTriggerDefinition;
 4 | import org.axonframework.eventsourcing.SnapshotTriggerDefinition;
 5 | import org.axonframework.eventsourcing.Snapshotter;
 6 | import org.axonframework.serialization.Serializer;
 7 | import org.axonframework.serialization.json.JacksonSerializer;
 8 | import org.springframework.boot.SpringApplication;
 9 | import org.springframework.boot.autoconfigure.SpringBootApplication;
10 | import org.springframework.context.annotation.Bean;
11 | import org.springframework.context.annotation.Primary;
12 | 
13 | @SpringBootApplication
14 | public class SnapshottingApplication {
15 | 
16 |     public static void main(String[] args) {
17 |         SpringApplication.run(SnapshottingApplication.class, args);
18 |     }
19 | 
20 |     /**
21 |      * This {@link SnapshotTriggerDefinition} is responsible to trigger the Snapshot. In this implementation, it creates
22 |      * a Snapshot every 5 events, including the Snapshot itself. eg: when we hit the 5th event, a snapshot will be
23 |      * created (5 events). When we hit the 9th event, another snapshot will be created (1 snapshot event + 4 events) and
24 |      * so on.
25 |      *
26 |      * @param snapshotter The default {@link Snapshotter} provided by Axon.
27 |      * @return the configured {@link SnapshotTriggerDefinition}.
28 |      */
29 |     @Bean
30 |     public SnapshotTriggerDefinition mySnapshotTriggerDefinition(Snapshotter snapshotter) {
31 |         return new EventCountSnapshotTriggerDefinition(snapshotter, 5);
32 |     }
33 | 
34 |     /**
35 |      * Construct the main {@link Serializer} used by this sample application to be a {@link JacksonSerializer}.
36 |      * <p>
37 |      * By making this the {@link Primary} instance, Axon Framework will use this {@code Serializer} for commands,
38 |      * events, queries, but more importantly, also snapshots. Since (by default) Axon Framework serializes the state of
39 |      * the aggregate as the snapshot, this means the {@code io.axoniq.dev.samples.command.MyEntityAggregate} needs to be
40 |      * serializable by Jackson.
41 |      * <p>
42 |      * To support Jackson de-/serialization for this projects aggregate, we added the
43 |      * {@link com.fasterxml.jackson.annotation.JsonGetter} and {@link com.fasterxml.jackson.annotation.JsonSetter}
44 |      * annotation to getter and setter methods. Note that the getters/setters are made package-private on purpose, as
45 |      * they should only be used by the serializer.
46 |      *
47 |      * @return The main {@link Serializer} used by this sample application to be a {@link JacksonSerializer}.
48 |      */
49 |     @Bean
50 |     @Primary
51 |     public Serializer serializer() {
52 |         return JacksonSerializer.defaultSerializer();
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/snapshots/src/main/java/io/axoniq/dev/samples/api/CreateMyEntityCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | public record CreateMyEntityCommand(
 6 |         @TargetAggregateIdentifier String entityId,
 7 |         String name
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/snapshots/src/main/java/io/axoniq/dev/samples/api/MyEntityCreatedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.api;
2 | 
3 | public record MyEntityCreatedEvent(
4 |         String entityId,
5 |         String name
6 | ) {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/snapshots/src/main/java/io/axoniq/dev/samples/api/MyEntityRenamedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.api;
2 | 
3 | public record MyEntityRenamedEvent(
4 |         String entityId,
5 |         String name
6 | ) {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/snapshots/src/main/java/io/axoniq/dev/samples/api/RenameMyEntityCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | public record RenameMyEntityCommand(
 6 |         @TargetAggregateIdentifier String entityId,
 7 |         String name
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/snapshots/src/main/java/io/axoniq/dev/samples/rest/CommandController.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.rest;
 2 | 
 3 | import io.axoniq.dev.samples.api.CreateMyEntityCommand;
 4 | import io.axoniq.dev.samples.api.RenameMyEntityCommand;
 5 | import org.axonframework.commandhandling.gateway.CommandGateway;
 6 | import org.springframework.web.bind.annotation.PatchMapping;
 7 | import org.springframework.web.bind.annotation.PathVariable;
 8 | import org.springframework.web.bind.annotation.PostMapping;
 9 | import org.springframework.web.bind.annotation.RequestMapping;
10 | import org.springframework.web.bind.annotation.RequestParam;
11 | import org.springframework.web.bind.annotation.RestController;
12 | 
13 | import java.util.concurrent.CompletableFuture;
14 | 
15 | @RestController
16 | @RequestMapping("/entity")
17 | class CommandController {
18 | 
19 |     private final CommandGateway commandGateway;
20 | 
21 |     public CommandController(CommandGateway commandGateway) {
22 |         this.commandGateway = commandGateway;
23 |     }
24 | 
25 |     @PostMapping("/{id}")
26 |     public CompletableFuture<Void> createMyEntity(@PathVariable("id") String entityId,
27 |                                                   @RequestParam("name") String name) {
28 |         return commandGateway.send(new CreateMyEntityCommand(entityId, name));
29 |     }
30 | 
31 |     @PatchMapping("/{id}")
32 |     public CompletableFuture<Void> renameMyEntity(@PathVariable("id") String entityId,
33 |                                                   @RequestParam("name") String name) {
34 |         return commandGateway.send(new RenameMyEntityCommand(entityId, name));
35 |     }
36 | }
37 | 
38 | 
39 | 


--------------------------------------------------------------------------------
/stateful-event-handler/README.md:
--------------------------------------------------------------------------------
 1 | # Stateful event processor implementation example
 2 | 
 3 | This is an example on how to implement a stateful event processor, which could be used as an alternative to
 4 | a [Saga](../saga). This use case is implemented in
 5 | the [OrderProcessor](src/main/java/io/axoniq/dev/samples/orderprocessor/OrderProcessor.java).
 6 | 
 7 | A webshop has different bounded contexts, for instance, a checkout (where the customer can add items to the card), an
 8 | order, a shipment, a payment context. The checkout context will produce events based on actions that the customer does
 9 | in the checkout. Some of these events are the so-called domain events. These events could trigger actions within other
10 | contexts. An example could be
11 | the [OrderConfirmedEvent](src/main/java/io/axoniq/dev/samples/order/api/OrderConfirmedEvent.java). When an order is
12 | confirmed, the order processing starts: the customer should pay, and the ordered articles need shipping. This process
13 | needs to be managed. When the order is not paid you need to take some compensating actions like cancelling the shipment.
14 | 
15 | This stateful event processor is responsible for the process between multiple bounded contexts. It starts on
16 | the [OrderConfirmedEvent](src/main/java/io/axoniq/dev/samples/order/api/OrderConfirmedEvent.java) which marks the start
17 | of the order process and contains the `orderId`.
18 | 
19 | The event-handling methods are annotated with `@EventHandler`. During this process,
20 | the [OrderProcess](src/main/java/io/axoniq/dev/samples/orderprocessor/OrderProcess.java) is stored in the database to
21 | maintain the state of an order process. In this example JPA is used, but you could use any alternative of your choosing
22 | here.
23 | 
24 | ## Stateful event processor configuration example
25 | 
26 | An event processor will (by default) start its token at the tail of the stream. It is possible to change this behavior
27 | and let the processor start at the head instead, preventing earlier events from being processed, which could otherwise
28 | cause undesirable side effects. The configuration example can be
29 | found [here](src/main/java/io/axoniq/dev/samples/config/OrderProcessorConfig.java)
30 | 


--------------------------------------------------------------------------------
/stateful-event-handler/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <modelVersion>4.0.0</modelVersion>
 6 |     <parent>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <artifactId>code-samples</artifactId>
 9 |         <version>0.0.2-SNAPSHOT</version>
10 |     </parent>
11 | 
12 |     <artifactId>stateful-event-handler</artifactId>
13 | 
14 |     <name>Stateful Event Handler</name>
15 |     <description>Module explaining an alternative to using Sagas - the Stateful Event Handler</description>
16 | 
17 |     <dependencies>
18 |         <!-- Axon -->
19 |         <dependency>
20 |             <groupId>org.axonframework</groupId>
21 |             <artifactId>axon-messaging</artifactId>
22 |         </dependency>
23 |         <dependency>
24 |             <groupId>org.axonframework</groupId>
25 |             <artifactId>axon-spring-boot-starter</artifactId>
26 |         </dependency>
27 |         <!-- Spring -->
28 |         <dependency>
29 |             <groupId>org.springframework.data</groupId>
30 |             <artifactId>spring-data-jpa</artifactId>
31 |             <scope>compile</scope>
32 |         </dependency>
33 |         <dependency>
34 |             <groupId>org.springframework.boot</groupId>
35 |             <artifactId>spring-boot-starter-web</artifactId>
36 |         </dependency>
37 |         <!-- Database -->
38 |         <dependency>
39 |             <groupId>org.hibernate</groupId>
40 |             <artifactId>hibernate-core</artifactId>
41 |         </dependency>
42 |     </dependencies>
43 | </project>


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/config/OrderProcessorConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.config;
 2 | 
 3 | import org.axonframework.config.ConfigurerModule;
 4 | import org.axonframework.eventhandling.TrackingEventProcessorConfiguration;
 5 | import org.axonframework.messaging.StreamableMessageSource;
 6 | import org.springframework.context.annotation.Bean;
 7 | import org.springframework.context.annotation.Configuration;
 8 | 
 9 | @Configuration
10 | public class OrderProcessorConfig {
11 | 
12 |     @Bean
13 |     public ConfigurerModule configureOrderProcessor() {
14 |         TrackingEventProcessorConfiguration tepConfig =
15 |                 TrackingEventProcessorConfiguration.forSingleThreadedProcessing()
16 |                                                    .andInitialTrackingToken(StreamableMessageSource::createHeadToken);
17 |         return configurer -> configurer.eventProcessing()
18 |                                        .registerTrackingEventProcessorConfiguration("OrderProcessor", c -> tepConfig);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/order/api/CompleteOrderProcessCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.order.api;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.OrderId;
 4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 5 | 
 6 | public record CompleteOrderProcessCommand(
 7 |         @TargetAggregateIdentifier OrderId orderId,
 8 |         boolean isPaid,
 9 |         boolean orderIsDelivered
10 | ) {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/order/api/OrderConfirmedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.order.api;
 2 | 
 3 | 
 4 | import io.axoniq.dev.samples.uuid.OrderId;
 5 | 
 6 | public record OrderConfirmedEvent(
 7 |         OrderId orderId
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/orderprocessor/OrderProcess.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.orderprocessor;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.OrderId;
 4 | import io.axoniq.dev.samples.uuid.PaymentId;
 5 | import io.axoniq.dev.samples.uuid.ShipmentId;
 6 | import jakarta.persistence.Embedded;
 7 | import jakarta.persistence.EmbeddedId;
 8 | import jakarta.persistence.Entity;
 9 | 
10 | @Entity
11 | public class OrderProcess {
12 | 
13 |     @EmbeddedId
14 |     private OrderId orderId;
15 |     @Embedded
16 |     private PaymentId paymentId;
17 |     @Embedded
18 |     private ShipmentId shipmentId;
19 |     private boolean orderIsPaid = false;
20 |     private boolean orderIsDelivered = false;
21 | 
22 |     public OrderProcess(OrderId orderId, PaymentId paymentId, ShipmentId shipmentId) {
23 |         this.orderId = orderId;
24 |         this.paymentId = paymentId;
25 |         this.shipmentId = shipmentId;
26 |     }
27 | 
28 |     public OrderProcess() {
29 |     }
30 | 
31 |     public void markAsPaid() {
32 |         orderIsPaid = true;
33 |     }
34 | 
35 |     public void markAsDelivered() {
36 |         orderIsDelivered = true;
37 |     }
38 | 
39 |     public boolean orderIsPaid() {
40 |         return orderIsPaid;
41 |     }
42 | 
43 |     public boolean orderIsDelivered() {
44 |         return orderIsDelivered;
45 |     }
46 | 
47 |     public OrderId getOrderId() {
48 |         return orderId;
49 |     }
50 | 
51 |     public ShipmentId getShipmentId() {
52 |         return shipmentId;
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/orderprocessor/OrderProcessRepository.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.orderprocessor;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.OrderId;
 4 | import io.axoniq.dev.samples.uuid.PaymentId;
 5 | import io.axoniq.dev.samples.uuid.ShipmentId;
 6 | import org.springframework.data.jpa.repository.JpaRepository;
 7 | import org.springframework.stereotype.Repository;
 8 | 
 9 | import java.util.Optional;
10 | 
11 | @Repository
12 | interface OrderProcessRepository extends JpaRepository<OrderProcess, OrderId> {
13 | 
14 |     Optional<OrderProcess> findByPaymentId(PaymentId paymentId);
15 | 
16 |     Optional<OrderProcess> findByShipmentId(ShipmentId shipmentId);
17 | }
18 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/payment/api/OrderPaidEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.payment.api;
2 | 
3 | import io.axoniq.dev.samples.uuid.PaymentId;
4 | 
5 | public record OrderPaidEvent(
6 |         PaymentId paymentId
7 | ) {
8 | 
9 | }


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/payment/api/OrderPaymentCancelledEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.payment.api;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.PaymentId;
 4 | 
 5 | public record OrderPaymentCancelledEvent(
 6 |         PaymentId paymentId
 7 | ) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/payment/api/PayOrderCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.payment.api;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.PaymentId;
 4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 5 | 
 6 | public record PayOrderCommand(
 7 |         @TargetAggregateIdentifier PaymentId paymentId
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/shipment/api/CancelShipmentCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.shipment.api;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.ShipmentId;
 4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 5 | 
 6 | public record CancelShipmentCommand(
 7 |         @TargetAggregateIdentifier ShipmentId shipmentId
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/shipment/api/ShipOrderCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.shipment.api;
 2 | 
 3 | import io.axoniq.dev.samples.uuid.ShipmentId;
 4 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 5 | 
 6 | public record ShipOrderCommand(
 7 |         @TargetAggregateIdentifier ShipmentId shipmentId
 8 | ) {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/shipment/api/ShipmentStatus.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.shipment.api;
2 | 
3 | public enum ShipmentStatus {
4 |     NEW,
5 |     SHIPPED,
6 |     DELIVERY_EXCEPTION,
7 |     DELIVERED
8 | }
9 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/shipment/api/ShipmentStatusUpdatedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.shipment.api;
 2 | 
 3 | 
 4 | import io.axoniq.dev.samples.uuid.ShipmentId;
 5 | 
 6 | public record ShipmentStatusUpdatedEvent(
 7 |         ShipmentId shipmentId,
 8 |         ShipmentStatus shipmentStatus
 9 | ) {
10 | 
11 | }


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/uuid/AbstractId.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.uuid;
 2 | 
 3 | import jakarta.persistence.Embeddable;
 4 | 
 5 | import java.io.Serializable;
 6 | import java.util.UUID;
 7 | 
 8 | @Embeddable
 9 | abstract class AbstractId implements Serializable {
10 | 
11 |     UUID id;
12 | 
13 |     public AbstractId() {
14 |         this.id = UUID.randomUUID();
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/uuid/OrderId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.uuid;
2 | 
3 | public class OrderId extends AbstractId {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/uuid/PaymentId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.uuid;
2 | 
3 | public class PaymentId extends AbstractId {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/uuid/ShipmentId.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.uuid;
2 | 
3 | public class ShipmentId extends AbstractId {
4 | 
5 | }
6 | 


--------------------------------------------------------------------------------
/stateful-event-handler/src/main/java/io/axoniq/dev/samples/uuid/UUIDProvider.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.uuid;
 2 | 
 3 | import org.springframework.stereotype.Component;
 4 | 
 5 | @Component
 6 | public class UUIDProvider {
 7 | 
 8 |     public OrderId generateOrderId() {
 9 |         return new OrderId();
10 |     }
11 | 
12 |     public PaymentId generatePaymentId() {
13 |         return new PaymentId();
14 |     }
15 | 
16 |     public ShipmentId generateShipmentId() {
17 |         return new ShipmentId();
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/subscription-query-rest/README.md:
--------------------------------------------------------------------------------
 1 | # Subscription Query REST
 2 | 
 3 | In this demo we will try achieve that our REST API feels more native and on sending a command it returns updated
 4 | projection right away, instead of listening for updates on a different endpoint.
 5 | 
 6 | There are two issues that needs to be address in this case:
 7 | 
 8 | 1. We need to subscribe for updates before we send a command, that’s the only way to be sure we will not miss any
 9 |    updates. Sending commands first and then subscribing for updates will result in race conditions! The simple trick is
10 |    to subscribe for the initial result first (even if we don’t need it). Let’s call it virtual initial result. This will
11 |    open the Subscription query, which will buffer all updates that arrive at this point on. Since we now have a buffer
12 |    for updates, we can send a command and after the command has sent we can subscribe to updates flux. If an update
13 |    arrives after sending a command and before we are subscribed for updates, we will read it automatically from the
14 |    buffer, therefore we are sure we will not miss any updates.
15 | 
16 | 2. We need to read our own writes, multiple updates/events could be dispatch at the same time, we can’t guarantee order
17 |    and which one will arrive first. Without some kind of correlation, we will easily get into trouble and get someone
18 |    else’s updates. The safest way to go is to introduce a unique id for each command. We can attach this data to event
19 |    meta-data, and once projection has materialized we can track which command is responsible for this update. Luckily
20 |    Axon Framework offers this functionality out of the box. Every event contains a tracking id which is the id of the
21 |    command that created that event. We will use this correlation mechanism to read our own writes.


--------------------------------------------------------------------------------
/subscription-query-rest/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.3'
2 | services:
3 |   axonserver:
4 |     image: axoniq/axonserver
5 |     hostname: axonserver
6 |     ports:
7 |       - '8024:8024'
8 |       - '8124:8124'
9 | 


--------------------------------------------------------------------------------
/subscription-query-rest/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 |          xmlns="http://maven.apache.org/POM/4.0.0"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <modelVersion>4.0.0</modelVersion>
 6 |     <parent>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <artifactId>code-samples</artifactId>
 9 |         <version>0.0.2-SNAPSHOT</version>
10 |     </parent>
11 | 
12 |     <artifactId>subscription-query-rest</artifactId>
13 | 
14 |     <name>Subscription Query - REST</name>
15 |     <description>
16 |         Module explaining how to use the Subscription Query to spoof a synchronous UI with an asynchronous backend
17 |     </description>
18 | 
19 |     <dependencies>
20 |         <!-- Axon -->
21 |         <dependency>
22 |             <groupId>org.axonframework</groupId>
23 |             <artifactId>axon-spring-boot-starter</artifactId>
24 |         </dependency>
25 |         <dependency>
26 |             <groupId>org.axonframework</groupId>
27 |             <artifactId>axon-test</artifactId>
28 |         </dependency>
29 |         <!-- Spring -->
30 |         <dependency>
31 |             <groupId>org.springframework.boot</groupId>
32 |             <artifactId>spring-boot-starter-web</artifactId>
33 |         </dependency>
34 |         <dependency>
35 |             <groupId>org.springframework.boot</groupId>
36 |             <artifactId>spring-boot-starter-webflux</artifactId>
37 |             <scope>test</scope>
38 |         </dependency>
39 |         <!-- Other -->
40 |         <dependency>
41 |             <groupId>io.projectreactor</groupId>
42 |             <artifactId>reactor-core</artifactId>
43 |         </dependency>
44 |         <!-- Testing -->
45 |         <dependency>
46 |             <groupId>org.junit.jupiter</groupId>
47 |             <artifactId>junit-jupiter</artifactId>
48 |             <scope>test</scope>
49 |         </dependency>
50 |         <dependency>
51 |             <groupId>org.testcontainers</groupId>
52 |             <artifactId>junit-jupiter</artifactId>
53 |         </dependency>
54 |     </dependencies>
55 | </project>


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/SubscriptionQueryRestApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | 
 6 | @SpringBootApplication
 7 | public class SubscriptionQueryRestApplication {
 8 | 
 9 |     public static void main(String[] args) {
10 |         SpringApplication.run(SubscriptionQueryRestApplication.class, args);
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/api/CreateMyEntityCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | public record CreateMyEntityCommand(
 6 |         @TargetAggregateIdentifier String entityId
 7 | ) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/api/GetMyEntityByCorrelationIdQuery.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.api;
2 | 
3 | public record GetMyEntityByCorrelationIdQuery(
4 |         String correlationId
5 | ) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/api/MyEntityCreatedEvent.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.api;
2 | 
3 | public record MyEntityCreatedEvent(
4 |         String entityId
5 | ) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/api/ValidateMyEntityCommand.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.modelling.command.TargetAggregateIdentifier;
 4 | 
 5 | public record ValidateMyEntityCommand(
 6 |         @TargetAggregateIdentifier String entityId, String email
 7 | ) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/command/MyEntityAggregate.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.command;
 2 | 
 3 | import io.axoniq.dev.samples.api.CreateMyEntityCommand;
 4 | import io.axoniq.dev.samples.api.MyEntityCreatedEvent;
 5 | import org.axonframework.commandhandling.CommandHandler;
 6 | import org.axonframework.eventsourcing.EventSourcingHandler;
 7 | import org.axonframework.modelling.command.AggregateIdentifier;
 8 | import org.axonframework.spring.stereotype.Aggregate;
 9 | 
10 | import static org.axonframework.modelling.command.AggregateLifecycle.apply;
11 | 
12 | @Aggregate
13 | class MyEntityAggregate {
14 | 
15 |     @AggregateIdentifier
16 |     private String entityId;
17 | 
18 |     public MyEntityAggregate() {
19 |         // Required by Axon Framework
20 |     }
21 | 
22 |     @CommandHandler
23 |     public MyEntityAggregate(CreateMyEntityCommand command) {
24 |         apply(new MyEntityCreatedEvent(command.entityId()));
25 |     }
26 | 
27 |     @EventSourcingHandler
28 |     public void on(MyEntityCreatedEvent event) {
29 |         entityId = event.entityId();
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/query/MyEntity.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.query;
2 | 
3 | public record MyEntity(
4 |         String id
5 | ) {
6 | 
7 | }
8 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/java/io/axoniq/dev/samples/query/MyEntityProjection.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.query;
 2 | 
 3 | import io.axoniq.dev.samples.api.GetMyEntityByCorrelationIdQuery;
 4 | import io.axoniq.dev.samples.api.MyEntityCreatedEvent;
 5 | import org.axonframework.eventhandling.EventHandler;
 6 | import org.axonframework.messaging.annotation.MetaDataValue;
 7 | import org.axonframework.queryhandling.QueryHandler;
 8 | import org.axonframework.queryhandling.QueryUpdateEmitter;
 9 | import org.springframework.stereotype.Component;
10 | 
11 | import java.util.Optional;
12 | 
13 | @Component
14 | class MyEntityProjection {
15 | 
16 |     private final QueryUpdateEmitter emitter;
17 | 
18 |     public MyEntityProjection(QueryUpdateEmitter emitter) {
19 |         this.emitter = emitter;
20 |     }
21 | 
22 |     @QueryHandler
23 |     /* We are creating virtual initial result, doesn't need to return anything, but also do not return null */
24 |     public Optional<Void> on(GetMyEntityByCorrelationIdQuery query) {
25 |         return Optional.empty();
26 |     }
27 | 
28 |     @EventHandler
29 |     public void on(MyEntityCreatedEvent event, @MetaDataValue("correlationId") String correlationId) {
30 |         MyEntity entity = new MyEntity(event.entityId());
31 | 
32 |         /* save your entity in your repository here */
33 | 
34 |         /* Inject correlationId from Event Metadata, which is basically command id that produced this event.
35 |          Emit and update to all observers that are interested in this correlationId */
36 |         emitter.emit(GetMyEntityByCorrelationIdQuery.class,
37 |                      query -> query.correlationId().equals(correlationId),
38 |                      entity);
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/subscription-query-rest/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | axon.serializer.general=jackson


--------------------------------------------------------------------------------
/subscription-query-streaming/docker-compose.yml:
--------------------------------------------------------------------------------
1 | version: '3.3'
2 | services:
3 |   axonserver:
4 |     image: axoniq/axonserver
5 |     hostname: axonserver
6 |     ports:
7 |       - '8024:8024'
8 |       - '8124:8124'
9 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <modelVersion>4.0.0</modelVersion>
 6 |     <parent>
 7 |         <artifactId>code-samples</artifactId>
 8 |         <groupId>io.axoniq</groupId>
 9 |         <version>0.0.2-SNAPSHOT</version>
10 |     </parent>
11 | 
12 |     <artifactId>subscription-query-streaming</artifactId>
13 | 
14 |     <name>Subscription Query - Streaming</name>
15 |     <description>Module explaining how to use the Subscription Query to stream</description>
16 | 
17 |     <dependencies>
18 |         <!-- Axon -->
19 |         <dependency>
20 |             <groupId>org.axonframework</groupId>
21 |             <artifactId>axon-spring-boot-starter</artifactId>
22 |         </dependency>
23 |         <!-- Spring -->
24 |         <dependency>
25 |             <groupId>org.springframework.boot</groupId>
26 |             <artifactId>spring-boot-starter-webflux</artifactId>
27 |         </dependency>
28 |         <!-- Other -->
29 |         <dependency>
30 |             <groupId>io.projectreactor</groupId>
31 |             <artifactId>reactor-core</artifactId>
32 |         </dependency>
33 |     </dependencies>
34 | </project>


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/java/io/axoniq/dev/samples/AxonConfig.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.axonframework.config.ConfigurerModule;
 4 | import org.axonframework.eventhandling.gateway.EventGateway;
 5 | import org.axonframework.lifecycle.Phase;
 6 | import org.axonframework.messaging.Message;
 7 | import org.axonframework.messaging.interceptors.LoggingInterceptor;
 8 | import org.axonframework.queryhandling.QueryGateway;
 9 | import org.springframework.context.annotation.Bean;
10 | import org.springframework.context.annotation.Configuration;
11 | 
12 | /**
13 |  * Basic Axon configuration adding the {@link LoggingInterceptor} to the {@link QueryGateway} and {@link EventGateway}.
14 |  * This provides easy logging of all the messages being published, ensuring that portion of the application works.
15 |  *
16 |  * @author Steven van Beelen
17 |  */
18 | @Configuration
19 | public class AxonConfig {
20 | 
21 |     @Bean
22 |     public LoggingInterceptor<Message<?>> loggingInterceptor() {
23 |         return new LoggingInterceptor<>();
24 |     }
25 | 
26 |     @SuppressWarnings("resource")
27 |     @Bean
28 |     public ConfigurerModule loggingInterceptorConfigurerModule(LoggingInterceptor<Message<?>> loggingInterceptor) {
29 |         return configurer -> configurer.onInitialize(config -> config.onStart(Phase.OUTBOUND_QUERY_CONNECTORS, () -> {
30 |             config.eventGateway().registerDispatchInterceptor(loggingInterceptor);
31 |             config.queryGateway().registerDispatchInterceptor(loggingInterceptor);
32 |         }));
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/java/io/axoniq/dev/samples/SubscriptionQueryStreamingApplication.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | import org.springframework.scheduling.annotation.EnableScheduling;
 6 | 
 7 | /**
 8 |  * Sample application providing an endpoint in the {@link io.axoniq.dev.samples.ui.QueryController} to open a stream of
 9 |  * {@link org.springframework.http.codec.ServerSentEvent}s on.
10 |  * <p>
11 |  * This stream is fed by Axon's
12 |  * {@link org.axonframework.queryhandling.QueryGateway#subscriptionQuery(Object, Class, Class)}. The Query Model
13 |  * returned by this subscription query is updated through scheduled "fake" events containing {@link java.util.UUID}
14 |  * strings. The query model updates are made in the {@link io.axoniq.dev.samples.querymodel.ModelProjector}, whereas the
15 |  * events are published from the {@link io.axoniq.dev.samples.commandmodel.EventPublisher}.
16 |  *
17 |  * @author Steven van Beelen
18 |  */
19 | @EnableScheduling
20 | @SpringBootApplication
21 | public class SubscriptionQueryStreamingApplication {
22 | 
23 |     public static void main(String[] args) {
24 |         SpringApplication.run(SubscriptionQueryStreamingApplication.class, args);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/java/io/axoniq/dev/samples/api/ModelQuery.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | /**
 4 |  * Query message towards requesting the query model of this application.
 5 |  *
 6 |  * @author Steven van Beelen
 7 |  */
 8 | public record ModelQuery() {
 9 | 
10 | }
11 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/java/io/axoniq/dev/samples/api/StreamUpdatedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | /**
 4 |  * Event containing an update to the stream.
 5 |  *
 6 |  * @author Steven van Beelen
 7 |  */
 8 | public record StreamUpdatedEvent(
 9 |         String update
10 | ) {
11 | 
12 | }
13 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/java/io/axoniq/dev/samples/commandmodel/EventPublisher.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.commandmodel;
 2 | 
 3 | import io.axoniq.dev.samples.api.StreamUpdatedEvent;
 4 | import org.axonframework.eventhandling.gateway.EventGateway;
 5 | import org.springframework.scheduling.annotation.Scheduled;
 6 | import org.springframework.stereotype.Component;
 7 | 
 8 | import java.util.UUID;
 9 | 
10 | /**
11 |  * Scheduled event publisher. Uses the {@link EventGateway} to publish the {@link StreamUpdatedEvent} on set intervals.
12 |  * The events are filled with a {@link UUID}.
13 |  *
14 |  * @author Steven van Beelen
15 |  */
16 | @Component
17 | public class EventPublisher {
18 | 
19 |     private final EventGateway eventGateway;
20 | 
21 |     public EventPublisher(EventGateway eventGateway) {
22 |         this.eventGateway = eventGateway;
23 |     }
24 | 
25 |     @Scheduled(initialDelay = 1_000, fixedDelay = 6_000)
26 |     public void publishEvent() {
27 |         eventGateway.publish(new StreamUpdatedEvent(UUID.randomUUID().toString()));
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/java/io/axoniq/dev/samples/querymodel/ModelProjector.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.querymodel;
 2 | 
 3 | import io.axoniq.dev.samples.api.ModelQuery;
 4 | import io.axoniq.dev.samples.api.StreamUpdatedEvent;
 5 | import org.axonframework.config.ProcessingGroup;
 6 | import org.axonframework.eventhandling.EventHandler;
 7 | import org.axonframework.queryhandling.QueryHandler;
 8 | import org.axonframework.queryhandling.QueryUpdateEmitter;
 9 | import org.springframework.stereotype.Component;
10 | 
11 | import java.util.ArrayList;
12 | import java.util.List;
13 | 
14 | /**
15 |  * Basic projector class of a {@link List} of strings model. Adds the contents of the {@link StreamUpdatedEvent} to a
16 |  * list and emits updates of these same events to the {@link ModelQuery}.
17 |  *
18 |  * @author Steven van Beelen
19 |  */
20 | @Component
21 | @ProcessingGroup("model-projector")
22 | public class ModelProjector {
23 | 
24 |     private final QueryUpdateEmitter updateEmitter;
25 |     private final List<String> updates;
26 | 
27 |     public ModelProjector(QueryUpdateEmitter updateEmitter) {
28 |         this.updateEmitter = updateEmitter;
29 |         this.updates = new ArrayList<>();
30 |     }
31 | 
32 |     @EventHandler
33 |     public void on(StreamUpdatedEvent event) {
34 |         updates.add(event.update());
35 |         updateEmitter.emit(ModelQuery.class, query -> true, event.update());
36 |     }
37 | 
38 |     @SuppressWarnings("unused")
39 |     @QueryHandler
40 |     public List<String> handle(ModelQuery query) {
41 |         return updates;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | spring.application.name=Subscription Query Streaming
2 | axon.serializer.general=jackson


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/.browserslistrc:
--------------------------------------------------------------------------------
 1 | # This file is used by the build system to adjust CSS and JS output to support the specified browsers below.
 2 | # For additional information regarding the format and rule options, please see:
 3 | # https://github.com/browserslist/browserslist#queries
 4 | 
 5 | # For the full list of supported browsers by the Angular framework, please see:
 6 | # https://angular.io/guide/browser-support
 7 | 
 8 | # You can see what browsers were selected by your queries by running:
 9 | #   npx browserslist
10 | 
11 | last 1 Chrome version
12 | last 1 Firefox version
13 | last 2 Edge major versions
14 | last 2 Safari major versions
15 | last 2 iOS major versions
16 | Firefox ESR
17 | not IE 11 # Angular supports IE 11 only as an opt-in. To opt-in, remove the 'not' prefix on this line.
18 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/.editorconfig:
--------------------------------------------------------------------------------
 1 | # Editor configuration, see https://editorconfig.org
 2 | root = true
 3 | 
 4 | [*]
 5 | charset = utf-8
 6 | indent_style = space
 7 | indent_size = 2
 8 | insert_final_newline = true
 9 | trim_trailing_whitespace = true
10 | 
11 | [*.ts]
12 | quote_type = single
13 | 
14 | [*.md]
15 | max_line_length = off
16 | trim_trailing_whitespace = false
17 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/.gitignore:
--------------------------------------------------------------------------------
 1 | # See http://help.github.com/ignore-files/ for more about ignoring files.
 2 | 
 3 | # compiled output
 4 | /dist
 5 | /tmp
 6 | /out-tsc
 7 | # Only exists if Bazel was run
 8 | /bazel-out
 9 | 
10 | # dependencies
11 | /node_modules
12 | 
13 | # profiling files
14 | chrome-profiler-events*.json
15 | 
16 | # IDEs and editors
17 | /.idea
18 | .project
19 | .classpath
20 | .c9/
21 | *.launch
22 | .settings/
23 | *.sublime-workspace
24 | 
25 | # IDE - VSCode
26 | .vscode/*
27 | !.vscode/settings.json
28 | !.vscode/tasks.json
29 | !.vscode/launch.json
30 | !.vscode/extensions.json
31 | .history/*
32 | 
33 | # misc
34 | /.sass-cache
35 | /connect.lock
36 | /coverage
37 | /libpeerconnection.log
38 | npm-debug.log
39 | yarn-error.log
40 | testem.log
41 | /typings
42 | 
43 | # System Files
44 | .DS_Store
45 | Thumbs.db
46 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/README.md:
--------------------------------------------------------------------------------
 1 | # Ui
 2 | 
 3 | This project was generated with [Angular CLI](https://github.com/angular/angular-cli) version 12.1.1.
 4 | 
 5 | ## Development server
 6 | 
 7 | Run `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The app will automatically reload if you change any of the source files.
 8 | 
 9 | ## Code scaffolding
10 | 
11 | Run `ng generate component component-name` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module`.
12 | 
13 | ## Build
14 | 
15 | Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory.
16 | 
17 | ## Running unit tests
18 | 
19 | Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
20 | 
21 | ## Running end-to-end tests
22 | 
23 | Run `ng e2e` to execute the end-to-end tests via a platform of your choice. To use this command, you need to first add a package that implements end-to-end testing capabilities.
24 | 
25 | ## Further help
26 | 
27 | To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.
28 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/karma.conf.js:
--------------------------------------------------------------------------------
 1 | // Karma configuration file, see link for more information
 2 | // https://karma-runner.github.io/1.0/config/configuration-file.html
 3 | 
 4 | module.exports = function (config) {
 5 |   config.set({
 6 |     basePath: '',
 7 |     frameworks: ['jasmine', '@angular-devkit/build-angular'],
 8 |     plugins: [
 9 |       require('karma-jasmine'),
10 |       require('karma-chrome-launcher'),
11 |       require('karma-jasmine-html-reporter'),
12 |       require('karma-coverage'),
13 |       require('@angular-devkit/build-angular/plugins/karma')
14 |     ],
15 |     client: {
16 |       jasmine: {
17 |         // you can add configuration options for Jasmine here
18 |         // the possible options are listed at https://jasmine.github.io/api/edge/Configuration.html
19 |         // for example, you can disable the random execution with `random: false`
20 |         // or set a specific seed with `seed: 4321`
21 |       },
22 |       clearContext: false // leave Jasmine Spec Runner output visible in browser
23 |     },
24 |     jasmineHtmlReporter: {
25 |       suppressAll: true // removes the duplicated traces
26 |     },
27 |     coverageReporter: {
28 |       dir: require('path').join(__dirname, './coverage/ui'),
29 |       subdir: '.',
30 |       reporters: [
31 |         { type: 'html' },
32 |         { type: 'text-summary' }
33 |       ]
34 |     },
35 |     reporters: ['progress', 'kjhtml'],
36 |     port: 9876,
37 |     colors: true,
38 |     logLevel: config.LOG_INFO,
39 |     autoWatch: true,
40 |     browsers: ['Chrome'],
41 |     singleRun: false,
42 |     restartOnFileChange: true
43 |   });
44 | };
45 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/proxy.conf.json:
--------------------------------------------------------------------------------
1 | {
2 |   "/app": {
3 |     "target": "http://localhost:8080/app",
4 |     "secure": false
5 |   }
6 | }
7 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app-routing.module.ts:
--------------------------------------------------------------------------------
 1 | import { NgModule } from '@angular/core';
 2 | import { RouterModule, Routes } from '@angular/router';
 3 | 
 4 | const routes: Routes = [];
 5 | 
 6 | @NgModule({
 7 |   imports: [RouterModule.forRoot(routes)],
 8 |   exports: [RouterModule]
 9 | })
10 | export class AppRoutingModule { }
11 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app.component.css:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/subscription-query-streaming/src/main/ui/src/app/app.component.css


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app.component.html:
--------------------------------------------------------------------------------
 1 | <div class="content" role="main">
 2 | 
 3 |   <div>
 4 |     <span>App is running!</span>
 5 | 
 6 |     <div *ngFor="let message of messages">
 7 |       <div>{{message}}</div>
 8 |     </div>
 9 |   </div>
10 | 
11 | </div>
12 | 
13 | <router-outlet></router-outlet>
14 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app.component.spec.ts:
--------------------------------------------------------------------------------
 1 | import { TestBed } from '@angular/core/testing';
 2 | import { RouterTestingModule } from '@angular/router/testing';
 3 | import { AppComponent } from './app.component';
 4 | 
 5 | describe('AppComponent', () => {
 6 |   beforeEach(async () => {
 7 |     await TestBed.configureTestingModule({
 8 |       imports: [
 9 |         RouterTestingModule
10 |       ],
11 |       declarations: [
12 |         AppComponent
13 |       ],
14 |     }).compileComponents();
15 |   });
16 | 
17 |   it('should create the app', () => {
18 |     const fixture = TestBed.createComponent(AppComponent);
19 |     const app = fixture.componentInstance;
20 |     expect(app).toBeTruthy();
21 |   });
22 | 
23 |   it(`should have as title 'ui'`, () => {
24 |     const fixture = TestBed.createComponent(AppComponent);
25 |     const app = fixture.componentInstance;
26 |     expect(app.title).toEqual('ui');
27 |   });
28 | 
29 |   it('should render title', () => {
30 |     const fixture = TestBed.createComponent(AppComponent);
31 |     fixture.detectChanges();
32 |     const compiled = fixture.nativeElement;
33 |     expect(compiled.querySelector('.content span').textContent).toContain('ui app is running!');
34 |   });
35 | });
36 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app.component.ts:
--------------------------------------------------------------------------------
 1 | import { Component, OnInit } from '@angular/core';
 2 | import { SseService } from "./app.sse.service";
 3 | 
 4 | @Component({
 5 |   selector: 'app-root',
 6 |   templateUrl: './app.component.html',
 7 |   styleUrls: ['./app.component.css']
 8 | })
 9 | export class AppComponent implements OnInit {
10 |   constructor(private _sseService: SseService) {  }
11 |   messages: String[] = []
12 | 
13 |   ngOnInit(): void {
14 |     this._sseService
15 |       .getServerSentEvents()
16 |       .subscribe(data => this.messages.push(data));
17 |   }
18 | }
19 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app.module.ts:
--------------------------------------------------------------------------------
 1 | import { NgModule } from '@angular/core';
 2 | import { BrowserModule } from '@angular/platform-browser';
 3 | 
 4 | import { AppRoutingModule } from './app-routing.module';
 5 | import { AppComponent } from './app.component';
 6 | 
 7 | @NgModule({
 8 |   declarations: [
 9 |     AppComponent
10 |   ],
11 |   imports: [
12 |     BrowserModule,
13 |     AppRoutingModule
14 |   ],
15 |   providers: [],
16 |   bootstrap: [AppComponent]
17 | })
18 | export class AppModule { }
19 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/app/app.sse.service.ts:
--------------------------------------------------------------------------------
 1 | import { Injectable, NgZone } from '@angular/core';
 2 | import { Observable } from "rxjs";
 3 | 
 4 | // Simple service providing an Observable of Strings. This Observable is filled with the events from the EventSource
 5 | // retrieved from 'http://localhost:8080/app/updates'.
 6 | @Injectable({
 7 |   providedIn: 'root'
 8 | })
 9 | export class SseService {
10 |   constructor(private _zone: NgZone) {}
11 | 
12 |   getEventSource(): EventSource {
13 |     // Since the angular app is being run from localhost:4200, and not localhost:8000
14 |     // we need to point it to the correct endpoint first.
15 |     return new EventSource('http://localhost:8080/app/updates');
16 |   }
17 | 
18 |   getServerSentEvents(): Observable<String> {
19 |     return new Observable(observer => {
20 |       const eventSource = this.getEventSource();
21 | 
22 |       // We can't use .onmessage = ... here, because the type of the event is not 'message'.
23 |       // Since the type of the event is `update`, we have to use `.addEventListener()` method,
24 |       // to specify which event type we are listening to.
25 |       eventSource.addEventListener('update', (event: any) => {
26 |         this._zone.run(() => {
27 |           observer.next("type = [" + event.type + "] data = [" + event.data + "]");
28 |         });
29 |       });
30 | 
31 |       eventSource.onerror = error => {
32 |         this._zone.run(() => {
33 |           observer.error(error);
34 |         });
35 |       };
36 |     });
37 |   }
38 | }
39 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/assets/.gitkeep:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/subscription-query-streaming/src/main/ui/src/assets/.gitkeep


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/environments/environment.prod.ts:
--------------------------------------------------------------------------------
1 | export const environment = {
2 |   production: true
3 | };
4 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/environments/environment.ts:
--------------------------------------------------------------------------------
 1 | // This file can be replaced during build by using the `fileReplacements` array.
 2 | // `ng build` replaces `environment.ts` with `environment.prod.ts`.
 3 | // The list of file replacements can be found in `angular.json`.
 4 | 
 5 | export const environment = {
 6 |   production: false
 7 | };
 8 | 
 9 | /*
10 |  * For easier debugging in development mode, you can import the following file
11 |  * to ignore zone related error stack frames such as `zone.run`, `zoneDelegate.invokeTask`.
12 |  *
13 |  * This import should be commented out in production mode because it will have a negative impact
14 |  * on performance if an error is thrown.
15 |  */
16 | // import 'zone.js/plugins/zone-error';  // Included with Angular CLI.
17 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AxonIQ/code-samples/a51275eaa7368473dce8984eab2d737920f054cc/subscription-query-streaming/src/main/ui/src/favicon.ico


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/index.html:
--------------------------------------------------------------------------------
 1 | <!doctype html>
 2 | <html lang="en">
 3 | <head>
 4 |   <meta charset="utf-8">
 5 |   <title>Ui</title>
 6 |   <base href="/">
 7 |   <meta name="viewport" content="width=device-width, initial-scale=1">
 8 |   <link rel="icon" type="image/x-icon" href="favicon.ico">
 9 | </head>
10 | <body>
11 |   <app-root></app-root>
12 | </body>
13 | </html>
14 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/main.ts:
--------------------------------------------------------------------------------
 1 | import { enableProdMode } from '@angular/core';
 2 | import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
 3 | 
 4 | import { AppModule } from './app/app.module';
 5 | import { environment } from './environments/environment';
 6 | 
 7 | if (environment.production) {
 8 |   enableProdMode();
 9 | }
10 | 
11 | platformBrowserDynamic().bootstrapModule(AppModule)
12 |   .catch(err => console.error(err));
13 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/styles.css:
--------------------------------------------------------------------------------
1 | /* You can add global styles to this file, and also import other style files */
2 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/src/test.ts:
--------------------------------------------------------------------------------
 1 | // This file is required by karma.conf.js and loads recursively all the .spec and framework files
 2 | 
 3 | import 'zone.js/testing';
 4 | import { getTestBed } from '@angular/core/testing';
 5 | import {
 6 |   BrowserDynamicTestingModule,
 7 |   platformBrowserDynamicTesting
 8 | } from '@angular/platform-browser-dynamic/testing';
 9 | 
10 | declare const require: {
11 |   context(path: string, deep?: boolean, filter?: RegExp): {
12 |     keys(): string[];
13 |     <T>(id: string): T;
14 |   };
15 | };
16 | 
17 | // First, initialize the Angular testing environment.
18 | getTestBed().initTestEnvironment(
19 |   BrowserDynamicTestingModule,
20 |   platformBrowserDynamicTesting()
21 | );
22 | // Then we find all the tests.
23 | const context = require.context('./', true, /\.spec\.ts$/);
24 | // And load the modules.
25 | context.keys().map(context);
26 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/tsconfig.app.json:
--------------------------------------------------------------------------------
 1 | /* To learn more about this file see: https://angular.io/config/tsconfig. */
 2 | {
 3 |   "extends": "./tsconfig.json",
 4 |   "compilerOptions": {
 5 |     "outDir": "./out-tsc/app",
 6 |     "types": []
 7 |   },
 8 |   "files": [
 9 |     "src/main.ts",
10 |     "src/polyfills.ts"
11 |   ],
12 |   "include": [
13 |     "src/**/*.d.ts"
14 |   ]
15 | }
16 | 


--------------------------------------------------------------------------------
/subscription-query-streaming/src/main/ui/tsconfig.spec.json:
--------------------------------------------------------------------------------
 1 | /* To learn more about this file see: https://angular.io/config/tsconfig. */
 2 | {
 3 |   "extends": "./tsconfig.json",
 4 |   "compilerOptions": {
 5 |     "outDir": "./out-tsc/spec",
 6 |     "types": [
 7 |       "jasmine"
 8 |     ]
 9 |   },
10 |   "files": [
11 |     "src/test.ts",
12 |     "src/polyfills.ts"
13 |   ],
14 |   "include": [
15 |     "src/**/*.spec.ts",
16 |     "src/**/*.d.ts"
17 |   ]
18 | }
19 | 


--------------------------------------------------------------------------------
/upcaster/README.md:
--------------------------------------------------------------------------------
 1 | # Upcasters
 2 | 
 3 | This module's intention is to give insights on how to create an upcaster and how to test it. This example uses a Json
 4 | serializer.
 5 | 
 6 | The FlightDelayedEvent is used as example. The original (null) revision looks like this:
 7 | 
 8 | ```json
 9 | {
10 |   "arrivalTime": "2021-05-27T15:06:10.629267",
11 |   "flightId": "KL123",
12 |   "origin": "LAX",
13 |   "destination": "LON"
14 | }
15 | 
16 | ```
17 | 
18 | Then a new requirement popped up to put the origin and destination into a separate object called `leg`. Please note,
19 | that this is just an example, and we do recommend keeping your event structure as flat as possible. The upcasted event
20 | should look like this:
21 | 
22 | ```json
23 | {
24 |   "arrivalTime": "2021-05-27T15:06:10.629267",
25 |   "flightId": "KL123",
26 |   "leg": {
27 |     "origin": "LAX",
28 |     "destination": "LON"
29 |   }
30 | }
31 | ```
32 | 
33 | You can find the implementation of the upcaster in
34 | the [FlightDelayedEventUpcaster](src/main/java/io/axoniq/dev/samples/upcaster/json/FlightDelayedEvent0_to_1Upcaster.java).
35 | The implementation of the test can be
36 | found [here](src/test/java/io/axoniq/dev/samples/upcaster/json/FlightDelayedEvent0_To_1UpcasterTest.java)
37 | 
38 | To get this upcaster invoked on the event handler it should be added to
39 | the [EventUpcasterChainFactory](src/main/java/io/axoniq/dev/samples/upcaster/json/EventUpcasterChainFactory.java) or
40 | annotate it as a Spring component together with an Order annotation.
41 | 


--------------------------------------------------------------------------------
/upcaster/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <parent>
 6 |         <artifactId>code-samples</artifactId>
 7 |         <groupId>io.axoniq</groupId>
 8 |         <version>0.0.2-SNAPSHOT</version>
 9 |     </parent>
10 |     <modelVersion>4.0.0</modelVersion>
11 | 
12 |     <artifactId>upcaster</artifactId>
13 | 
14 |     <name>Upcaster</name>
15 |     <description>Module showing several Upcaster implementations</description>
16 | 
17 |     <properties>
18 |         <jsonassert.version>1.5.3</jsonassert.version>
19 |     </properties>
20 | 
21 |     <dependencies>
22 |         <!-- Axon -->
23 |         <dependency>
24 |             <groupId>org.axonframework</groupId>
25 |             <artifactId>axon-spring-boot-starter</artifactId>
26 |         </dependency>
27 |         <!-- Spring -->
28 |         <dependency>
29 |             <groupId>org.springframework.boot</groupId>
30 |             <artifactId>spring-boot-starter-web</artifactId>
31 |         </dependency>
32 |         <!-- Testing -->
33 |         <dependency>
34 |             <groupId>org.skyscreamer</groupId>
35 |             <artifactId>jsonassert</artifactId>
36 |             <version>${jsonassert.version}</version>
37 |             <scope>test</scope>
38 |         </dependency>
39 |         <dependency>
40 |             <groupId>org.junit.jupiter</groupId>
41 |             <artifactId>junit-jupiter</artifactId>
42 |         </dependency>
43 |     </dependencies>
44 | </project>


--------------------------------------------------------------------------------
/upcaster/src/main/java/io/axoniq/dev/samples/api/AirportCode.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | public enum AirportCode {
 4 |     AMS("Amsterdam"),
 5 |     LON("London"),
 6 |     PAR("Paris"),
 7 |     NYC("New York City"),
 8 |     LAX("Los Angeles");
 9 | 
10 |     AirportCode(@SuppressWarnings("unused") String airportName) {
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/upcaster/src/main/java/io/axoniq/dev/samples/api/FlightDelayedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import org.axonframework.serialization.Revision;
 4 | 
 5 | import java.time.LocalDateTime;
 6 | import java.util.Objects;
 7 | 
 8 | @Revision("1.0")
 9 | public record FlightDelayedEvent(
10 |         String flightId,
11 |         Leg leg,
12 |         LocalDateTime arrivalTime
13 | ) {
14 | 
15 | }
16 | 


--------------------------------------------------------------------------------
/upcaster/src/main/java/io/axoniq/dev/samples/api/Leg.java:
--------------------------------------------------------------------------------
1 | package io.axoniq.dev.samples.api;
2 | 
3 | public record Leg(
4 |         AirportCode origin,
5 |         AirportCode destination
6 | ) {
7 | 
8 | }
9 | 


--------------------------------------------------------------------------------
/upcaster/src/main/java/io/axoniq/dev/samples/api/PassengerSeatAdjustedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | public record PassengerSeatAdjustedEvent(
 4 |         String flightId,
 5 |         String passengerId,
 6 |         int seatNumber
 7 | ) {
 8 | 
 9 | }
10 | 


--------------------------------------------------------------------------------
/upcaster/src/main/java/io/axoniq/dev/samples/api/PassengerSeatsAdjustedEvent.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.api;
 2 | 
 3 | import java.util.Map;
 4 | 
 5 | /**
 6 |  * An old event of the flight domain that's now been deprecated.
 7 |  * <p>
 8 |  * This event contained a complete list of all the passenger seat adjustments of a flight in one go. As time passed, the
 9 |  * application developers noticed they required an event for every separate change. Hence, they introduced that
10 |  * {@link PassengerSeatAdjustedEvent} and added a one-to-many upcaster to make this adjustment.
11 |  *
12 |  * @author Steven van Beelen
13 |  * @see io.axoniq.dev.samples.upcaster.json.PassengerSeatsToPassengerSeatAdjustedEventUpcaster
14 |  * @deprecated in favor of singular {@link PassengerSeatAdjustedEvent}s
15 |  */
16 | @Deprecated
17 | public record PassengerSeatsAdjustedEvent(
18 |         String flightId,
19 |         Map<String, Integer> passengerSeats
20 | ) {
21 | 
22 | }
23 | 


--------------------------------------------------------------------------------
/upcaster/src/main/java/io/axoniq/dev/samples/upcaster/json/EventUpcasterChainFactory.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.upcaster.json;
 2 | 
 3 | import org.axonframework.config.Configurer;
 4 | import org.axonframework.serialization.upcasting.event.EventUpcasterChain;
 5 | 
 6 | import java.util.function.Function;
 7 | 
 8 | /**
 9 |  * Utility class constructing the {@link EventUpcasterChain} to configure on the
10 |  * {@link org.axonframework.eventsourcing.eventstore.EventStore}.
11 |  * <p>
12 |  * In a Spring Boot environment exposing an {@code EventUpcasterChain} bean is sufficient for the framework to pick it
13 |  * up correctly. To that end we can use the {@link #buildEventUpcasterChain()} method.
14 |  * <p>
15 |  * When using Axon's {@link org.axonframework.config.Configurer} directly, you should configure all upcasters separately
16 |  * by invoking the {@link org.axonframework.config.Configurer#registerEventUpcaster(Function)} method. The
17 |  * {@link #configureUpcasters(Configurer)} shows how we should implement this.
18 |  *
19 |  * @author Yvonne Ceelie
20 |  */
21 | @SuppressWarnings("unused")
22 | public abstract class EventUpcasterChainFactory {
23 | 
24 |     /**
25 |      * Constructs an {@link EventUpcasterChain} combining all the upcasters of this application.
26 |      * <p>
27 |      * Can be used to expose an {@code EventUpcasterChain} bean in a Spring environment.
28 |      *
29 |      * @return an {@link EventUpcasterChain}
30 |      */
31 |     public static EventUpcasterChain buildEventUpcasterChain() {
32 |         return new EventUpcasterChain(
33 |                 new FlightDelayedEvent0_to_1Upcaster(),
34 |                 new PassengerSeatsToPassengerSeatAdjustedEventUpcaster()
35 |         );
36 |     }
37 | 
38 |     /**
39 |      * Configures all the upcasters of this application with the given {@code configurer}.
40 |      * <p>
41 |      * Can be utilized to configure upcasters if the application code uses Axon's {@link Configurer} directly.
42 |      *
43 |      * @param configurer the {@link Configurer} to register all upcasters with
44 |      */
45 |     public static void configureUpcasters(Configurer configurer) {
46 |         configurer.registerEventUpcaster(config -> new FlightDelayedEvent0_to_1Upcaster())
47 |                   .registerEventUpcaster(config -> new PassengerSeatsToPassengerSeatAdjustedEventUpcaster());
48 |     }
49 | 
50 |     private EventUpcasterChainFactory() {
51 |         // Utility class
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/upcaster/src/test/java/io/axoniq/dev/samples/upcaster/json/UpcasterTestingUtils.java:
--------------------------------------------------------------------------------
 1 | package io.axoniq.dev.samples.upcaster.json;
 2 | 
 3 | import org.axonframework.eventhandling.EventData;
 4 | import org.axonframework.eventhandling.GenericDomainEventEntry;
 5 | import org.axonframework.messaging.MetaData;
 6 | 
 7 | import java.io.BufferedReader;
 8 | import java.io.InputStream;
 9 | import java.io.InputStreamReader;
10 | import java.nio.charset.StandardCharsets;
11 | import java.time.Instant;
12 | import java.util.UUID;
13 | import java.util.stream.Collectors;
14 | 
15 | public abstract class UpcasterTestingUtils {
16 | 
17 |     public static String extractFileContentsToString(String fileName) {
18 |         InputStream fileInputStream = UpcasterTestingUtils.class.getResourceAsStream(fileName);
19 |         if (fileInputStream == null) {
20 |             throw new IllegalArgumentException("File name [" + fileName + "] is unknown");
21 |         }
22 |         InputStreamReader fileStreamReader = new InputStreamReader(fileInputStream, StandardCharsets.UTF_8);
23 |         return new BufferedReader(fileStreamReader)
24 |                 .lines()
25 |                 .collect(Collectors.joining("\n"));
26 |     }
27 | 
28 |     public static EventData<?> generateDomainEventData(String payloadType,
29 |                                                        String payloadRevision,
30 |                                                        Object payload) {
31 |         return generateDomainEventData(UUID.randomUUID().toString(), payloadType, payloadRevision, payload);
32 |     }
33 | 
34 |     public static EventData<?> generateDomainEventData(String aggregateIdentifier,
35 |                                                        String payloadType,
36 |                                                        String payloadRevision,
37 |                                                        Object payload) {
38 |         return new GenericDomainEventEntry<>("aggregateType",
39 |                                              aggregateIdentifier,
40 |                                              0,
41 |                                              UUID.randomUUID().toString(),
42 |                                              Instant.now(),
43 |                                              payloadType,
44 |                                              payloadRevision,
45 |                                              payload,
46 |                                              MetaData.emptyInstance());
47 |     }
48 | 
49 |     private UpcasterTestingUtils() {
50 |         // Utility class
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/upcaster/src/test/resources/FlightDelayedEventRev_1.json:
--------------------------------------------------------------------------------
1 | {
2 |   "arrivalTime": "2021-05-27T15:06:10.629267",
3 |   "flightId": "KL123",
4 |   "leg": {
5 |     "origin": "LAX",
6 |     "destination": "LON"
7 |   }
8 | }
9 | 


--------------------------------------------------------------------------------
/upcaster/src/test/resources/FlightDelayedEventRev_null.json:
--------------------------------------------------------------------------------
1 | {
2 |   "arrivalTime": "2021-05-27T15:06:10.629267",
3 |   "flightId": "KL123",
4 |   "origin": "LAX",
5 |   "destination": "LON"
6 | }
7 | 


--------------------------------------------------------------------------------
/upcaster/src/test/resources/PassengerSeatAdjustedEventOne.json:
--------------------------------------------------------------------------------
1 | {
2 |   "flightId": "98d74c7b-5bf2-4224-a525-1839c5e94199",
3 |   "passengerId": "e7b4e728-aa0f-40bd-a6c7-6db9c7f3aae3",
4 |   "seatNumber": 1
5 | }


--------------------------------------------------------------------------------
/upcaster/src/test/resources/PassengerSeatAdjustedEventThree.json:
--------------------------------------------------------------------------------
1 | {
2 |   "flightId": "98d74c7b-5bf2-4224-a525-1839c5e94199",
3 |   "passengerId": "c7d630cc-def8-463d-87db-061ec549efb2",
4 |   "seatNumber": 3
5 | }


--------------------------------------------------------------------------------
/upcaster/src/test/resources/PassengerSeatAdjustedEventTwo.json:
--------------------------------------------------------------------------------
1 | {
2 |   "flightId": "98d74c7b-5bf2-4224-a525-1839c5e94199",
3 |   "passengerId": "8576e25b-eb30-422d-b522-85135eecc1f4",
4 |   "seatNumber": 2
5 | }


--------------------------------------------------------------------------------
/upcaster/src/test/resources/PassengerSeatsAdjustedEvent.json:
--------------------------------------------------------------------------------
1 | {
2 |   "flightId": "98d74c7b-5bf2-4224-a525-1839c5e94199",
3 |   "passengerSeats": {
4 |     "c7d630cc-def8-463d-87db-061ec549efb2": 3,
5 |     "8576e25b-eb30-422d-b522-85135eecc1f4": 2,
6 |     "e7b4e728-aa0f-40bd-a6c7-6db9c7f3aae3": 1
7 |   }
8 | }


--------------------------------------------------------------------------------