io.github.crabzilla:crabzilla-kotlin-example1-service

Yet another Event Sourcing experiment

License

License

Categories

Categories

Kotlin Languages
GroupId

GroupId

io.github.crabzilla
ArtifactId

ArtifactId

crabzilla-kotlin-example1-service
Last Version

Last Version

0.0.5
Release Date

Release Date

Type

Type

jar
Description

Description

Yet another Event Sourcing experiment

Download crabzilla-kotlin-example1-service

How to add to project

<!-- https://jarcasting.com/artifacts/io.github.crabzilla/crabzilla-kotlin-example1-service/ -->
<dependency>
    <groupId>io.github.crabzilla</groupId>
    <artifactId>crabzilla-kotlin-example1-service</artifactId>
    <version>0.0.5</version>
</dependency>
// https://jarcasting.com/artifacts/io.github.crabzilla/crabzilla-kotlin-example1-service/
implementation 'io.github.crabzilla:crabzilla-kotlin-example1-service:0.0.5'
// https://jarcasting.com/artifacts/io.github.crabzilla/crabzilla-kotlin-example1-service/
implementation ("io.github.crabzilla:crabzilla-kotlin-example1-service:0.0.5")
'io.github.crabzilla:crabzilla-kotlin-example1-service:jar:0.0.5'
<dependency org="io.github.crabzilla" name="crabzilla-kotlin-example1-service" rev="0.0.5">
  <artifact name="crabzilla-kotlin-example1-service" type="jar" />
</dependency>
@Grapes(
@Grab(group='io.github.crabzilla', module='crabzilla-kotlin-example1-service', version='0.0.5')
)
libraryDependencies += "io.github.crabzilla" % "crabzilla-kotlin-example1-service" % "0.0.5"
[io.github.crabzilla/crabzilla-kotlin-example1-service "0.0.5"]

Dependencies

compile (18)

Group / Artifact Type Version
io.github.crabzilla : crabzilla-kotlin-example1-database jar 0.0.5
io.github.crabzilla : crabzilla-vertx jar 0.0.5
org.jetbrains.kotlin : kotlin-stdlib jar 1.1.4
org.jetbrains.kotlin : kotlin-reflect jar 1.1.4
com.fasterxml.jackson.module : jackson-module-kotlin jar 2.9.0.pr4
io.github.microutils : kotlin-logging jar 1.4.6
org.jdbi : jdbi3-kotlin jar 3.0.0-beta2
org.jdbi : jdbi3-kotlin-sqlobject jar 3.0.0-beta2
org.slf4j : slf4j-simple jar 1.7.8
com.typesafe : config jar 1.3.1
com.google.inject : guice jar 4.1.0
com.google.inject.extensions : guice-multibindings jar 4.1.0
com.fasterxml.jackson.module : jackson-module-parameter-names jar 2.9.0.pr4
com.fasterxml.jackson.datatype : jackson-datatype-jdk8 jar 2.9.0.pr4
com.fasterxml.jackson.core : jackson-annotations jar 2.9.0.pr4
com.fasterxml.jackson.datatype : jackson-datatype-jsr310 jar 2.9.0.pr4
javax.inject : javax.inject jar 1
org.slf4j : slf4j-api jar 1.7.8

provided (1)

Group / Artifact Type Version
org.projectlombok : lombok jar 1.16.18

test (5)

Group / Artifact Type Version
io.vertx : vertx-unit jar 3.5.0.Beta1
org.junit.vintage : junit-vintage-engine jar 4.12.0-RC2
org.junit.jupiter : junit-jupiter-api jar 5.0.0-RC2
org.mockito : mockito-core jar 2.7.4
org.assertj : assertj-core jar 3.5.0

Project Modules

There are no modules declared in this project.

Build Status codecov Maven Central

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
  1. Clone it:
git clone https://github.com/crabzilla/crabzilla
cd crabzilla
  1. Start docker-compose running a Postgres database (port 5432 will be used):
docker-compose up
  1. Open another terminal and build it, running both unit and integration tests:
mvn clean install -DskipTests=false

Random notes

  1. Crabzilla tries to provide a chassis for wiring and running your domain by using plain verticles.
  2. 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
  3. So far events from all entities are written as an UnitOfWork in Json format into a single partitioned append only table.
io.github.crabzilla

Versions

Version
0.0.5