Skip to content

naspredam/rest-spring-boot-hexagonal-architecture

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rest-spring-boot-hexagonal-architecture

This project is to expose my interpretation of the hexagonal architecture, under spring-boot framework.

The diagram of the hexagonal architecture relies on the following:

Hexagonal architecture diagram

I have tried to take a diagram that I have seen common on different articles, even though I saw port/adapter to be swap.

This architecture follows the clean architecture from Uncle bob:

https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html

This project is following this diagram on spring-boot framework.

Application diagrams

On this I was doing the following approach diagram:

Application diagram

Where we have as part of the application is:

  • REST implementation
  • Database connection

The colors meant to be:

  • Orange: this is the domain model of our application, that is located on com.example.service.user.domain
  • Blue: this is the application itself, where we have the logic and the ports (to apply this logic from and to). The package is: com.example.service.user.application
  • Green: this is the package com.example.service.user.adapter, where are the implementation of the ports. It was decided to keep the repositories and the controllers, even though this could be moved to the infrastructure package.

What was not played out on this diagram was the package:

com.example.service.user.infrastructure

This package is cross, so it was not having a flow on the diagram, but impacts to be defined shared components.

Domain model

The domain model is a simple one, for user management.

This diagram it is just a simple information for eventual User domain. We can see the following domain model diagram:

Domain model diagram

where the colors here represents:

  • Orange: entity or root aggregate of our domain
  • Blue: value objects

This domain has a functions class, where it is a bunch of functions to access to User entity information.

Architecture tests

It was implemented the arch rules from arch unit library.

The tests are located on:

com.example.service.user.architecture.*

Test strategy

The tests develop were doing unit tests for each class of the project.

Do integration test on the controller, which is our application entry point.

About

Spring boot on rest api for users resource on hexagonal architecture

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages