How stevenartz/modul_183_backend works
Modul_183 is a Spring-based backend for authenticating users and managing people and their songs in MySQL. The main workflow is an HTTP request: authentication or a song/person endpoint delegates authorization and input handling, then DAO code performs database access and returns domain objects or a status. The README documents no capabilities, so endpoint scope is inferred from the source index and sampled code. Unsampled controllers and modules are represented only where their references are listed; unsupported links are omitted.
Main entry points: RequestHandler.java Request handler · PersonDAO.java Person DAO · Mapper.java Result mapper · SongDAO.java Song DAO
Components 21
HTTP API
- Authentication endpoints
src/main/java/com/uls/controller/AuthenticationController.java - Person endpoints
src/main/java/com/uls/controller/PersonController.java - Song endpoints
src/main/java/com/uls/controller/SongController.java
Authentication & validation
- Request handler
src/main/java/com/uls/security/RequestHandler.java - JWT helper
src/main/java/com/uls/security/JWTHelper.java - SHA-512 hasher
src/main/java/com/uls/security/SHA512Hasher.java - HTML escaping
src/main/java/com/uls/security/HTMLEscaper.java - Input patterns
src/main/java/com/uls/security/Regex.java
Persistence
- Person DAO
src/main/java/com/uls/dao/personDAO/PersonDAO.java - Song DAO
src/main/java/com/uls/dao/songDAO/SongDAO.java - SQL query builder
src/main/java/com/uls/dao/manager/QueryManager.java - Result mapper
src/main/java/com/uls/dao/mapper/Mapper.java - Connection factory
src/main/java/com/uls/dao/factory/ConnectionFactory.java - Person model
src/main/java/com/uls/model/Person.java - Song model
src/main/java/com/uls/model/Song.java - Person column names
src/main/java/com/uls/dao/type/PersonType.java - Song column names
src/main/java/com/uls/dao/type/SongType.java - Person DAO contract
src/main/java/com/uls/dao/personDAO/IPersonDAO.java - Song DAO contract
src/main/java/com/uls/dao/songDAO/ISongDAO.java
Other components
- API client
- MySQL database
Connections 29
- API client → Authentication endpoints: sends auth request
src/main/java/com/uls/controller/AuthenticationController.java - API client → Person endpoints: sends person request
src/main/java/com/uls/controller/PersonController.java - API client → Song endpoints: sends song request
src/main/java/com/uls/controller/SongController.java - Authentication endpoints → Request handler: checks credentials
src/main/java/com/uls/controller/AuthenticationController.java - Authentication endpoints → JWT helper: creates token
src/main/java/com/uls/controller/AuthenticationController.java - Person endpoints → Request handler: handles requests
src/main/java/com/uls/controller/PersonController.java - Person endpoints → Person DAO: looks up people
src/main/java/com/uls/controller/PersonController.java - Song endpoints → Request handler: checks requests
src/main/java/com/uls/controller/SongController.java - Song endpoints → Song DAO: manages songs
src/main/java/com/uls/controller/SongController.java - Request handler → JWT helper: verifies tokens
src/main/java/com/uls/security/RequestHandler.java - Request handler → Person DAO: looks up account
src/main/java/com/uls/security/RequestHandler.java - Request handler → SHA-512 hasher: hashes password
src/main/java/com/uls/security/RequestHandler.java - Request handler → HTML escaping: escapes input
src/main/java/com/uls/security/RequestHandler.java - Request handler → Input patterns: validates fields
src/main/java/com/uls/security/RequestHandler.java - Person DAO → Connection factory: gets connection
src/main/java/com/uls/dao/personDAO/PersonDAO.java - Person DAO → SQL query builder: gets SQL
src/main/java/com/uls/dao/personDAO/PersonDAO.java - Person DAO → Result mapper: maps results
src/main/java/com/uls/dao/personDAO/PersonDAO.java - Song DAO → Connection factory: gets connection
src/main/java/com/uls/dao/songDAO/SongDAO.java - Song DAO → SQL query builder: gets SQL
src/main/java/com/uls/dao/songDAO/SongDAO.java - Song DAO → Result mapper: maps results
src/main/java/com/uls/dao/songDAO/SongDAO.java - Connection factory → MySQL database: opens JDBC connection
src/main/java/com/uls/dao/factory/ConnectionFactory.java - SQL query builder → Person column names: uses column names
src/main/java/com/uls/dao/manager/QueryManager.java - SQL query builder → Song column names: uses column names
src/main/java/com/uls/dao/manager/QueryManager.java - Result mapper → Person column names: reads columns
src/main/java/com/uls/dao/mapper/Mapper.java - Result mapper → Song column names: reads columns
src/main/java/com/uls/dao/mapper/Mapper.java - Result mapper → Person model: creates persons
src/main/java/com/uls/dao/mapper/Mapper.java - Result mapper → Song model: creates songs
src/main/java/com/uls/dao/mapper/Mapper.java - Person DAO → Person DAO contract: implements contract
src/main/java/com/uls/dao/personDAO/PersonDAO.java - Song DAO → Song DAO contract: implements contract
src/main/java/com/uls/dao/songDAO/SongDAO.java