How mawaaw/spring-boot-port-adapter-architecture works
This is a Spring Boot reservation-management API for clients, rooms, and reservations. The main workflow accepts a REST request, delegates reservation rules to the application service, checks client and room eligibility and date availability, then persists and returns a reservation. Client and room management are separate API branches; persistence adapters and JPA repositories form the storage layer. The README is empty, and only some source was sampled, so links for unsampled branches are omitted rather than inferred.
Main entry points: ReservationServiceImpl.java Reservation service · ReservationRepositoryImpl.java Reservation adapter · ReservationController.java Reservation API · ClientController.java Client API
Components 18
REST API
- Reservation API
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java - Client API
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java - Room API
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/RoomController.java - Exception handler
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/exception/GlobalExceptionHandler.java
Application
- Reservation service
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Client service
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ClientServiceImpl.java - Room service
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/RoomServiceImpl.java - API DTOs
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/dto - Client repository port
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ClientRepository.java - Reservation repository port
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/ReservationRepository.java - Room repository port
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/port/out/RoomRepository.java
Domain
- Reservation domain
src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/model - Domain exceptions
src/main/java/org/mawaaw/springbootportadapterarchitecture/domain/exception
Persistence
- Reservation adapter
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java - Reservation JPA
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/jpa/ReservationJpaRepository.java - JPA entities
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/entity - Entity mappers
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/mapper
Other components
- API caller
Connections 19
- API caller → Reservation API: sends request
- API caller → Client API: sends request
- API caller → Room API: sends request
- Reservation API → Reservation service: delegates to
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ReservationController.java - Client API → Client service: delegates to
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/ClientController.java - Room API → Room service: delegates to
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/out/rest/RoomController.java - Reservation service → Client repository port: checks client
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation service → Room service: looks up room
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation service → Reservation repository port: checks and saves
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation service → Reservation domain: uses models
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation service → Domain exceptions: raises errors
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation service → Entity mappers: maps data
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation service → API DTOs: accepts and returns
src/main/java/org/mawaaw/springbootportadapterarchitecture/application/service/ReservationServiceImpl.java - Reservation adapter → Reservation repository port: implements
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java - Reservation adapter → Reservation JPA: uses
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java - Reservation adapter → Entity mappers: maps entities
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java - Reservation adapter → JPA entities: converts
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/impl/ReservationRepositoryImpl.java - Reservation JPA → JPA entities: queries
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/adapter/in/persistence/jpa/ReservationJpaRepository.java - Exception handler → Domain exceptions: handles
src/main/java/org/mawaaw/springbootportadapterarchitecture/infrastructure/exception/GlobalExceptionHandler.java