How team-dodn/spring-boot-java-template works
This is a modular Spring Boot service template whose executable application exposes HTTP APIs. The principal example flow accepts GET or POST input, converts it to domain data, processes it in a service, and returns a standard API response. The repository also documents separate client, database, logging, monitoring, and shared-enum modules. The shown controller/service and response relationships are source-backed; module-level integration claims come from the README, so no unshown API-to-database or API-to-client call is asserted.
Main entry points: ExampleController.java Example API · ExampleService.java Example Service · ExampleData.java Domain Data · ExampleRepository.java JPA Repository
Components 21
Core API
- Executable App
core/core-api/src/main/java/io/dodn/springboot/CoreApiApplication.java - Example API
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java - Request DTO
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/request/ExampleRequestDto.java - Health API
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/HealthController.java - Response DTOs
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/response/ExampleResponseDto.java
Domain Example
- Example Service
core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java - Domain Data
core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleData.java - Domain Result
core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleResult.java
Storage
- Example Entity
storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleEntity.java - Entity Base
storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/BaseEntity.java - JPA Repository
storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java - MySQL
Integrations
- Feign Example Client
clients/client-example/src/main/java/io/dodn/springboot/client/example/ExampleClient.java - Logging Support
support/logging - Monitoring Support
support/monitoring
Shared Support
- API Envelope
core/core-api/src/main/java/io/dodn/springboot/core/support/response/ApiResponse.java - Error Handling
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/ApiControllerAdvice.java - Async Errors
core/core-api/src/main/java/io/dodn/springboot/core/api/config/AsyncExceptionHandler.java - Shared Enums
core/core-enum/src/main/java/io/dodn/springboot/core/enums/ExampleEnum.java
Other components
- API Caller
- External System
Connections 16
- API Caller → Example API: calls API
README.md - Example API → Request DTO: accepts
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java - Example API → Example Service: calls
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java - Example API → Domain Data: creates
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java - Request DTO → Domain Data: converts to
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/request/ExampleRequestDto.java - Example Service → Domain Result: returns
core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java - Example Service → Domain Data: reads
core/core-api/src/main/java/io/dodn/springboot/core/domain/ExampleService.java - Example API → Response DTOs: builds
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java - Example API → API Envelope: wraps result
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/v1/ExampleController.java - Error Handling → API Envelope: formats errors
core/core-api/src/main/java/io/dodn/springboot/core/api/controller/ApiControllerAdvice.java - Async Errors → Error Handling: logs exceptions
- Example Entity → Entity Base: extends
storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleEntity.java - JPA Repository → Example Entity: repositories
storage/db-core/src/main/java/io/dodn/springboot/storage/db/core/ExampleRepository.java - JPA Repository → MySQL: accesses
README.md - Feign Example Client → External System: communicates via HTTP
README.md - Executable App → Example API: serves API
README.md