How charan-1707/employee-management-system works
This is a Spring Boot REST API for employee record management. Clients send validated create, read, update, partial-update, and delete requests through the controller; the service applies those operations, maps between DTOs and entities, and delegates persistence to the Spring Data repository. Responses are standardized by response advice, while centralized exception handling formats errors. The README documents MySQL persistence. Source excerpts show the main request and service flow; database wiring details are not sampled, so that connection is based on the README’s architecture description.
Main entry points: EmployeeController.java Employee Controller · EmployeeService.java Employee Service · GlobalExceptionHandler.java Exception Handler · EmployeeRepository.java Employee Repository
Components 15
REST API
- Employee Controller
src/main/java/com/charan/employeemanagementsystem/controller/EmployeeController.java - Response Wrapper
src/main/java/com/charan/employeemanagementsystem/advices/GlobalResponseHandler.java - API Response
src/main/java/com/charan/employeemanagementsystem/advices/ApiResponse.java
Employee Services
- Employee Service
src/main/java/com/charan/employeemanagementsystem/service/EmployeeService.java - Mapper Configuration
src/main/java/com/charan/employeemanagementsystem/config/ModelMapperConfig.java
Employee Data
- Employee DTO
src/main/java/com/charan/employeemanagementsystem/dto/EmployeeDTO.java - Employee Entity
src/main/java/com/charan/employeemanagementsystem/entity/EmployeeEntity.java - Employee Repository
src/main/java/com/charan/employeemanagementsystem/repository/EmployeeRepository.java
Validation And Errors
- Role Constraint
src/main/java/com/charan/employeemanagementsystem/annotations/EmployeeRoleValidation.java - Role Validator
src/main/java/com/charan/employeemanagementsystem/annotations/EmployeeRoleValidator.java - Exception Handler
src/main/java/com/charan/employeemanagementsystem/advices/GlobalExceptionHandler.java - API Error
src/main/java/com/charan/employeemanagementsystem/advices/ApiError.java - Not Found Exception
src/main/java/com/charan/employeemanagementsystem/exceptions/ResourceNotFoundException.java
Other components
- API Client
- MySQL Database
Connections 18
- API Client → Employee Controller: sends requests
README.md - Employee Controller → Employee Service: delegates operations
src/main/java/com/charan/employeemanagementsystem/controller/EmployeeController.java - Employee Controller → Employee DTO: validates input
src/main/java/com/charan/employeemanagementsystem/controller/EmployeeController.java - Employee Service → Employee Repository: reads and writes
src/main/java/com/charan/employeemanagementsystem/service/EmployeeService.java - Employee Service → Employee DTO: maps to and from
src/main/java/com/charan/employeemanagementsystem/service/EmployeeService.java - Employee Service → Employee Entity: maps to and from
src/main/java/com/charan/employeemanagementsystem/service/EmployeeService.java - Employee Repository → Employee Entity: persists
src/main/java/com/charan/employeemanagementsystem/repository/EmployeeRepository.java - Employee Repository → MySQL Database: persists via JPA
README.md - Employee DTO → Role Constraint: applies constraint
src/main/java/com/charan/employeemanagementsystem/dto/EmployeeDTO.java - Role Constraint → Role Validator: registers validator
src/main/java/com/charan/employeemanagementsystem/annotations/EmployeeRoleValidation.java - Employee Controller → Exception Handler: errors handled by advice
src/main/java/com/charan/employeemanagementsystem/advices/GlobalExceptionHandler.java - Employee Service → Not Found Exception: raises when absent
src/main/java/com/charan/employeemanagementsystem/service/EmployeeService.java - Employee Controller → Not Found Exception: raises when absent
src/main/java/com/charan/employeemanagementsystem/controller/EmployeeController.java - Exception Handler → Not Found Exception: handles exception
src/main/java/com/charan/employeemanagementsystem/advices/GlobalExceptionHandler.java - Exception Handler → API Error: builds error
src/main/java/com/charan/employeemanagementsystem/advices/GlobalExceptionHandler.java - Exception Handler → API Response: wraps error
src/main/java/com/charan/employeemanagementsystem/advices/GlobalExceptionHandler.java - Response Wrapper → API Response: wraps response
src/main/java/com/charan/employeemanagementsystem/advices/GlobalResponseHandler.java - Employee Controller → API Client: returns HTTP response
README.md