A quickstart project that shows the use of business rules and processes
This example shows
You will need:
mvn clean compile spring-boot:run
mvn clean package
To run the generated native executable, generated in target/
, execute
java -jar target/process-business-rules-springboot.jar
You can take a look at the OpenAPI definition - automatically generated and included in this service - to determine all available operations exposed by this service. For easy readability you can visualize the OpenAPI definition file using a UI tool like for example available Swagger UI.
In addition, various clients to interact with this service can be easily generated using this OpenAPI definition.
Once the service is up and running we can invoke the REST endpoints and examine the logic.
To make use of this application it is as simple as putting a sending request to http://localhost:8080/persons
with appropriate contents. See the following two cases:
Given data:
{ "person" : { "name" : "john", "age" : 20 } }
Submit the JSON object from above:
curl -X POST -H 'Content-Type:application/json' -H 'Accept:application/json' -d '{"person" : {"name" : "john", "age" : 20}}' http://localhost:8080/persons
After the Curl command you should see a similar console log
{ "id":"fd4f629d-6822-4ca2-a8a6-a74f5f81e83d", "person":{ "name":"john", "age":20, "adult":true } }
Because the person is evaluated as an adult, no outstanding tasks should be here for given person.
We can verify there is no task running for Children Handling using following command:
curl http://localhost:8080/persons/{uuid}/tasks
where uuid is the id returned in the previous step.
Given data:
{ "person" : { "name" : "john", "age" : 5 } }
Submit the JSON object from above:
curl -X POST -H 'Content-Type:application/json' -H 'Accept:application/json' -d '{"person" : {"name" : "john", "age" : 5}}' http://localhost:8080/persons
After the Curl command you should see a similar console log
{ "id":"c59054b9-aa1d-4771-bc5e-40f8b32d3ff5", "person":{ "name":"john", "age":5, "adult":false } }
Because the person is not evaluated as an adult, there should be outstanding tasks for given person.
To verify there is a running task for Children
curl http://localhost:8080/persons/{uuid}/tasks
where uuid is the id returned from the preivous step.
Should return something like
[{"id":"c59054b9-aa1d-4771-bc5e-40f8b32d3ff5","name":"ChildrenHandling".....}]
Then to see the Task created perform the following command
curl http://localhost:8080/persons/{uuid}/ChildrenHandling/{tuuid}
where uuid is persons id and tuuid is task id.
It should return something similar to
{ "person":{ "name":"john", "age":5, "adult":false }, "id":"c59054b9-aa1d-4771-bc5e-40f8b32d3ff5", "name":"ChildrenHandling" }
Then we can complete the task and validate child with
curl -X POST -H 'Content-Type:application/json' -H 'Accept:application/json' -d '{}' http://localhost:8080/persons/{uuid}/ChildrenHandling/{tuuid}
Where uuid is persons id and tuuid is task id
Should return something similar to
{ "id":"09f98756-b273-4ceb-9308-fae7cc423904", "person":{ "name":"john", "age":5, "adult":false } }
and there should be no outstanding task for the person anymore.
In the operator
directory you'll find the custom resources needed to deploy this example on OpenShift with the Kogito Operator.