How franticskipper/book-store works
This is a Spring-based book catalog API. Clients create, retrieve, update, delete, and search books; requests pass through the controller to the service, which maps DTOs and uses a repository for persistence. Search criteria are built from reusable specifications, and search price ranges have custom validation. The source excerpts and index support these principal links; the README provides no additional capability detail, and the concrete database configuration was not sampled.
Main entry points: BookSpecificationBuilder.java Book spec builder · BookServiceImpl.java Book service · BookController.java Book controller · BookMapper.java Book mapper
Components 23
API and contracts
- Book controller
src/main/java/com/book/store/controller/BookController.java - Create request
src/main/java/com/book/store/dto/CreateBookRequestDto.java - Book response
src/main/java/com/book/store/dto/BookDto.java
Book domain
- Book service
src/main/java/com/book/store/service/impl/BookServiceImpl.java - Service contract
src/main/java/com/book/store/service/BookService.java - Book mapper
src/main/java/com/book/store/mapper/BookMapper.java - Mapper config
src/main/java/com/book/store/config/MapperConfig.java - Book entity
src/main/java/com/book/store/model/Book.java
Search and validation
- Search parameters
src/main/java/com/book/store/dto/BookSearchParameters.java - Book spec builder
src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java - Specification builder contract
src/main/java/com/book/store/repository/specification/SpecificationBuilder.java - Author filter
src/main/java/com/book/store/repository/book/specification/AuthorSpecification.java - Title filter
src/main/java/com/book/store/repository/book/specification/TitleSpecification.java - Minimum price filter
src/main/java/com/book/store/repository/book/specification/MinPriceSpecification.java - Maximum price filter
src/main/java/com/book/store/repository/book/specification/MaxPriceSpecification.java - Book spec provider
src/main/java/com/book/store/repository/book/specification/BookSpecificationProvider.java - Price range constraint
src/main/java/com/book/store/validation/PriceRangeValidation.java - Price range validator
src/main/java/com/book/store/validation/PriceRangeValidator.java
Persistence and errors
- Book repository
src/main/java/com/book/store/repository/book/BookRepository.java - Book database
- Not found exception
src/main/java/com/book/store/exception/EntityNotFoundException.java - Exception handler
src/main/java/com/book/store/exception/CustomGlobalExceptionHandler.java
Other components
- API client
Connections 26
- API client → Book controller: sends requests
src/main/java/com/book/store/controller/BookController.java - Book controller → Service contract: dispatches operations
src/main/java/com/book/store/controller/BookController.java - Book controller → Create request: accepts input
src/main/java/com/book/store/controller/BookController.java - Book controller → Search parameters: binds search
src/main/java/com/book/store/controller/BookController.java - Book controller → Book response: returns books
src/main/java/com/book/store/controller/BookController.java - Book service → Service contract: implements contract
src/main/java/com/book/store/service/impl/BookServiceImpl.java - Book service → Book mapper: maps books
src/main/java/com/book/store/service/impl/BookServiceImpl.java - Book service → Book repository: reads and writes
src/main/java/com/book/store/service/impl/BookServiceImpl.java - Book service → Book spec builder: builds search spec
src/main/java/com/book/store/service/impl/BookServiceImpl.java - Book service → Not found exception: throws on missing
src/main/java/com/book/store/service/impl/BookServiceImpl.java - Book mapper → Mapper config: uses config
src/main/java/com/book/store/mapper/BookMapper.java - Book mapper → Book entity: maps entity
src/main/java/com/book/store/mapper/BookMapper.java - Book mapper → Create request: maps input
src/main/java/com/book/store/mapper/BookMapper.java - Book mapper → Book response: maps output
src/main/java/com/book/store/mapper/BookMapper.java - Book repository → Book entity: stores entities
src/main/java/com/book/store/repository/book/BookRepository.java - Book repository → Book database: persists books
- Book spec builder → Specification builder contract: implements builder
src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java - Book spec builder → Author filter: uses filter
src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java - Book spec builder → Title filter: uses filter
src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java - Book spec builder → Minimum price filter: uses filter
src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java - Book spec builder → Maximum price filter: uses filter
src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java - Author filter → Book spec provider: implements provider
src/main/java/com/book/store/repository/book/specification/AuthorSpecification.java - Search parameters → Price range constraint: declares constraint
src/main/java/com/book/store/dto/BookSearchParameters.java - Price range constraint → Price range validator: registers validator
src/main/java/com/book/store/validation/PriceRangeValidation.java - Price range validator → Search parameters: validates range
src/main/java/com/book/store/validation/PriceRangeValidator.java - Exception handler → Not found exception: handles exception
src/main/java/com/book/store/exception/CustomGlobalExceptionHandler.java