Skip to content

Spring Boot microservice to demo integration with Dapr for event-driven, Pact for consumer-driven contract testing, Cucumber BDD, Liquibase, etc.

License

Notifications You must be signed in to change notification settings

wenqiglantz/customer-service

Repository files navigation

Customer Service

customer-order.jpg

Customer Service, providing REST endpoints for creating/updating/retrieving/deleting customers. It also publishes three types of events to order-service:

    1. CustomerWasCreated
    1. CustomerWasUpdated
    1. CustomerWasDeleted
  • A. Prerequisites

  • B. Getting Started & Run the Application

      1. Clone the git repo in to your local directory from the github repository
      1. Open the command prompt and navigate to the main project directory.
      1. Copy mssql.jks file located under rest-controller submodule to under "tmp" directory on your local env. Empty file merely for local testing purpose.
  • ** Run Application on Local Docker Containers**

      1. Build the application:
        • mvn clean install
      1. Run the application with Dapr as sidecar WITH docker container:
        • docker-compose up --build
      1. Tear down the app after running the app (warning: this will delete the contents of your app's database):
        • docker-compose down
      1. If you don't have Docker installed locally, run the application with Dapr as sidecar locally WITHOUT docker container:
        • dapr run --components-path ./dapr-components --app-id customer-service --app-port 9100 -- java -jar rest-controller/target/customer-service-0.0.1-SNAPSHOT-exec.jar -p 9100
  • C. Project Code Modules

    • config - Spring Configuration classes for all of the modules.
    • dapr-components - dapr components files for pubsub.
    • data - Contains domain data shared with other applications such as rest-api, events etc.
    • persistence - Responsible for hosting the Entities and Repositories for the database.
    • qa - Integration/Functional Tests.
    • rest-controller - REST Endpoints for the application.
    • service - Contains business logic for the application.
  • D. Application Launch

PubSub

For testing purpose, we are using EMQ X MQTT public broker https://www.emqx.io/mqtt/public-mqtt5-broker.

Pact testing

To run Pact testing, please ensure to update the root pom's pact broker configuration (in placeholder currently) to your desired values.

About

Spring Boot microservice to demo integration with Dapr for event-driven, Pact for consumer-driven contract testing, Cucumber BDD, Liquibase, etc.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages