Tutorials

General Notes

These tutorials focus on the usage of Jexxa.
The included business logic has no special meaning but is based on typical scenarios from business applications that can easily be transferred to other domains.

We assume you have a basic understanding of:

• Java programming and building applications with Maven
• (Optional) some initial experience with databases and message buses
• (Optional) a first idea of the ports and adapters architecture (see this article)

Additional Information

• To implement the tutorials yourself, you can use the jexxa-blank-archetype to generate a project skeleton.
• All tutorials run by default without requiring additional infrastructure services such as a message bus or database.
• If you just want to run the tutorials, you can use:
  • Prebuilt Docker images available here
  • Docker stacks for each tutorial:
    • HelloJexxa
    • TimeService
    • BookStore
    • ContractManagement
• If you want to build the tutorials locally, make sure you have a running developer stack, which provides:
  • a Postgres database
  • an ActiveMQ broker
  • Swagger-UI to access these applications

---

HelloJexxa

See documentation: HelloJexxa

TimeService — Async Messaging

See documentation: TimeService

TimeService — Flow of Control

See documentation: TimeService — Flow of Control

BookStore — Using a Repository

See documentation: BookStore

BookStore — Pattern Language

See documentation: BookStore — Pattern Language

BookStore — Architecture Validation

See documentation: BookStore — Architecture Validation

BookStore — Writing Tests

See documentation: BookStore — Writing Tests

BookStore — OpenAPI Support

See documentation: BookStore — With OpenAPI Support

BookStoreCN — Using Cloud-Native Technology with Jexxa

See documentation: BookStoreCN — Using Cloud-Native Technology with Jexxa

ContractManagement — Using an ObjectStore

See documentation: ContractManagement

---

Copyright and License

Code and documentation copyright © 2020–2025 Michael Repplinger.
Code released under the Unlicense.
Documentation released under Creative Commons.