0xtheprodev / spring-clean-example

Clean Architecture Example with Spring Framework (Java)

spring-clean-example

Description

Example Application Interface using Spring framework in Java

This example showcases Repository Pattern in Hexagonal Architecture (also known as Clean Architecture). Here we have two Entities - Books and Authors, whose relationships have been exploited to create CRUD endpoint in REST under OpenAPI standard.

Installation

• Run the application using Maven:

  $ ./mvnw spring-boot:run

• For Windows users:

  $ mvnw spring-boot:run

Testing

• Run test suite along with Coverage reporting:

  $ ./mvnw jacoco:prepare-agent test install jacoco:report

  or for Windows

  $ mvnw jacoco:prepare-agent test install jacoco:report

Swagger UI

• Open Swagger UI at localhost:8080/swagger-ui after running the application.

License

© MIT License