Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 2.81 KB

README.md

File metadata and controls

49 lines (33 loc) · 2.81 KB

iss-policy-service

CoverageQuality Gate Status

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

Architecture

The iss-policy-service microservice is responsible to created offers, converted offers to insurance policies, and allowed for termination of policies. In this service, we demonstrated use of a CQRS pattern for better read/write operation isolation. This service demonstrated two ways of communicating between services: synchronous REST-based calls to a iss-pricing-service through an HTTP client to get the price, and asynchronous event-based calls using Apache Kafka to publish information about newly created policies. In this service we also accessed an RDBMS 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.

How to run Application

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:8082
  • 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

How to run the Unit Test

mvn -B clean verify

How to run the Integration Test

Option 1:

  • 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

Option 2:

  • 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.