/EventuateDemo

Primary LanguageJava

Requirement

Java 8. If you are using Linux running environment and you have multiple Java versions installed, please use

sudo update-alternatives --config java
sudo update-alternatives --config javac

to select Java 8 among multiple available Java versions.

Notice

Sometimes failures would occur in the building process. Please use

docker stop $(docker ps -a -q)
docker rm $(docker ps -a -q)

to stop all running containers and remove them.

Operating System: Linux Ubuntu 18.04 LTS

Developing and extending project

The extended extra function:

  1. Update Customer
  2. Delete Customer
  3. Refund Order
  4. Get Order
  5. Delete Order in History

Problems Encountered

The Eventuate application requires a set of complicated configuration and a high-standard running environment. Since we are at home and we are unable to use lab machines (so Linux system is not guaranteed), many of us did not have a proper running environment configured after a long-time research. Therefore, a heavy workload is required if we want to build a brand-new application. To show our understanding of Eventuate, we can only extend the original application.

Building and running using Eventuate Local

First, build the application:

./gradlew assemble -P eventuateDriver=local

Next, you can launch the application using Docker Compose

export DOCKER_HOST_IP=...
./gradlew mysqlbinlogComposeBuild
./gradlew mysqlbinlogComposeUp

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

Note: You need to set DOCKER_HOST_IP before running Docker Compose. DOCKER_HOST_IP is the IP address of the machine running the Docker daemon. It must be an IP address or resolvable hostname. It cannot be localhost. See this guide to setting DOCKER_HOST_IP for more information.

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

  • http://${DOCKER_HOST_IP?}:8081/swagger-ui.html - Create a customer
  • http://${DOCKER_HOST_IP?}:8083/swagger-ui.html - Create an order
  • http://${DOCKER_HOST_IP?}: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.