We decided to implement it in an extremely simplified version of an insurance sales system to test the following aspects of microservice development:
- Project creation and development
- Access of both relational and NoSQL databases
- Blocking and non-blocking operations implementation
- Microservice to microservice communication (synchronous and asynchronous)
- Service discovery
- Running background jobs
The iss-payment-service microservice is responsible to created Policy Account, showed Policy Account list, and registered payments from the bank statement file. This module managed policy accounts. Once the policy was created, an account was created in this service with the expected income. Payment-service also had an implementation of a scheduled process in which a CSV file with payments was imported, and payments were assigned to policy accounts. This component showed asynchronous communication between services using Kafka and had the ability to create background jobs using Spring boot. It also allowed for the database to be accessed using JPA.
This is a spring boot project that exposes different endpoints and data can be persisted in postgresql database.
In the Integration Tests, the Testcontainers Java library is used for starting postgresql and kafka in a docker container.
Running application from command line using Docker, this is the cleanest way. In order for this approach to work, of course, you need to have Docker installed in your local environment.
- From the root directory you can run the following command:
docker-compose -f docker/docker-compose.yml up --build
- Application will be running on: http://localhost:8084
- To stop it you can open other terminal in the same directory, and then run the following command:
docker-compose -f docker/docker-compose.yml down
mvn -B clean verify
- Import the testcontainers-demo application as a Maven project to your IDE.
- Run maven clean verify with profile 'integration-test' to build the project and start running the IT tests.
mvn -B clean verify -Pintegration-test
- Import the testcontainers-demo application as a Maven project to your IDE.
- Run maven clean install command to build the project.
- Then you can search for XXXIT.java or XXXE2ETestCase.java class and run it as a junit test.