Home

Awesome

DDDSample

Java CI with Maven

This is the new home of the original DDD Sample app hosted at SourceForge.

Our intention is to move everything from SourceForge to GitHub in due time while starting upgrading both the technical aspects as well as the DDD aspects of the DDD Sample.

This project is a joint effort by Eric Evans' company Domain Language and the Swedish software consulting company Citerus.

The application uses Spring Boot. To start it go to the root directory and type mvn spring-boot:run or run the main method of the Application class from your IDE.
Then open http://localhost:8080/dddsample in your browser (and make sure that no firewall is blocking the communication and that Javascript for localhost is not blocked).

Discussion group: https://groups.google.com/forum/#!forum/dddsample

Development blog: https://citerus.github.io/dddsample-core/

Trello board: https://trello.com/b/PTDFRyxd

How to build

Using Maven (we recommend using the included Maven wrapper), run this command to compile and run all the tests:

./mvnw verify

If you want to compile without running the tests, run the following command:

./mvnw compile

For Windows users, use the included mvnw.cmd file instead, without the ./ but using the same arguments.

How to run

To start the app using the included application server and in-process HSQL database, run this command:

./mvnw spring-boot:run

For Windows users, use the included mvnw.cmd file instead, without the ./ but using the same arguments.

Entity relationships

The diagram was created with diagrams.net (formerly draw.io).

Using the HandlingReport REST API

The HandlingReport API has one endpoint that takes a JSON request body:

POST /dddsample/handlingReport

You can use cURL to send the request using an JSON file for the body:

curl --data-binary "@/path/to/project/src/test/resources/sampleHandlingReport.json" \
-H 'Content-Type: application/json;charset=UTF-8' \
http://localhost:8080/dddsample/handlingReport

See the api-docs.yaml file for a complete API definition.