crabzilla
Goal for version 1.0.0
To help writing CQRS and Event Sourcing applications with Vert.x
Status
It's still in very early development stage. Do not use release 0.0.5, master branch is very different from that.
Example
Building
Requirements
- Java 8
- Maven (tested with 3.5.0+)
- Docker compose (tested with 1.18.0)
- Kotlin plugin for your IDE
Steps
- Clone it:
git clone https://github.com/crabzilla/crabzilla
cd crabzilla
- Start docker-compose running a Postgres database (port 5432 will be used):
docker-compose up
- Open another terminal and build it, running both unit and integration tests:
mvn clean install -DskipTests=false
Random notes
- Crabzilla tries to provide a chassis for wiring and running your domain by using plain verticles.
- If your command handling functions are pure, all side effects will occurs within:
- core.UnitOfWorkJournal: to save the events to a database using optimistic concurrency control
- pgc.PgcUnitOfWorkProjector: to project events to a read model using a PostgreSql database using vertx-pg-client
jooq.JooqUowProjector: to project events to a read model using vertx-jooq-classic-reactive
- So far events from all entities are written as an UnitOfWork in Json format into a single partitioned append only table.