https://github.com/eventuate-examples/eventuate-examples-java-customers-and-orders

Java version of the Customers and Orders event sourcing example from my presentations
https://github.com/eventuate-examples/eventuate-examples-java-customers-and-orders

Last synced: 3 months ago
JSON representation

Java version of the Customers and Orders event sourcing example from my presentations

• Host: GitHub
• URL: https://github.com/eventuate-examples/eventuate-examples-java-customers-and-orders
• Owner: eventuate-examples
• Created: 2016-06-23T22:35:10.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-09-12T22:12:46.000Z (over 1 year ago)
• Last Synced: 2024-08-01T13:33:55.778Z (6 months ago)
• Language: Java
• Size: 399 KB
• Stars: 387
• Watchers: 38
• Forks: 206
• Open Issues: 18
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-ccamel - eventuate-examples/eventuate-examples-java-customers-and-orders - Java version of the Customers and Orders event sourcing example from my presentations (Java)

README

        
This is the Java version of the customers and orders example that I've used in numerous presentations

on developing microservices with event sourcing and CQRS.

The code is built using the Eventuate platform.

It illustrates how to implement an eventually consistent credit limit check using event sourcing.

For more information, see this [presentation from Gluecon 2016](http://www.slideshare.net/chris.e.richardson/a-pattern-language-for-microservices-gluecon-2016/24)

# About Eventuate™

![](http://eventuate.io/i/logo.gif)

The application is built using [Eventuate](http://eventuate.io/), which is an application platform for writing transactional microservices.

It provides a simple yet powerful event-driven programming model that is based on event sourcing and Command Query Responsibility Segregation (CQRS).

Eventuate solves the distributed data management problems inherent in a microservice architecture.

It consists of a scalable, distributed event store and client libraries for various languages and frameworks including Java, Scala, and the Spring framework.

# Building and running the application.

This is a Java 8, Gradle project. However, you do not need to install Gradle since it will be downloaded automatically. You just need to have Java 8 installed.

## Building and running using Eventuate Local

First, build the application:

```

./gradlew assemble

```

Next, you can launch the application using [Docker Compose](https://docs.docker.com/compose/)

Note:

If the containers aren't accessible via `localhost` - e.g. you are using Docker Toolbox, you will have to use `${DOCKER_HOST_IP}` instead of localhost.

See this http://eventuate.io/docs/usingdocker.html[guide to setting `DOCKER_HOST_IP`] for more information.

```

./gradlew ComposeBuild

./gradlew ComposeUp

```

Where `database-mode` is one of:

* `mysqlbinlog` - use MySQL with Binlog-based event publishing

* `postgreswal` - use Postgres with Postgres WAL-based event publishing

* `postgrespolling` - use Postgres with generic JDBC polling-based event publishing

Finally, you can use the Swagger UI provided by the services to create customers and orders, and view the order history:

* `http://localhost:8081/swagger-ui.html` - Create a customer

* `http://localhost:8083/swagger-ui.html` - Create an order

* `http://localhost:8082/swagger-ui.html` - View the customer and the order

(Hint: best to open these URLs in separate tabs)

The script `./show-urls.sh` will display the URLs.