How code-with-zoro/pearl-clipboard-backend works
Online Clipboard is a Spring backend for saving and retrieving text and uploaded files by generated key. The principal workflow enters through REST endpoints, is rate-checked by the service, then stores text in Redis or files in S3; retrieval returns text or a signed file URL, with one-time entries intended to be destructive. DTO mapping and clipboard state are the main internal data layer. The README describes caching and rate limiting, while the sampled service uses Redis directly for clipboard state and counters; no separate relational database implementation is evidenced. S3 and Redis wiring beyond the shown calls is not inferred.
Main entry points: ClipboardServices.java Clipboard service · ClipboardControllers.java Clipboard endpoints · s3Services.java S3 file service · DtoMappers.java DTO mapper
Components 11
API layer
- Clipboard endpoints
src/main/java/com/Projects/Online_Clipboard/controllers/ClipboardControllers.java - Exception mapping
src/main/java/com/Projects/Online_Clipboard/Exceptions/GlobalExceptionHandler.java
Clipboard workflows
- Clipboard service
src/main/java/com/Projects/Online_Clipboard/services/ClipboardServices.java
Storage integrations
- Redis store
- S3 file service
src/main/java/com/Projects/Online_Clipboard/services/s3Services.java - AWS S3
Data and errors
- DTO mapper
src/main/java/com/Projects/Online_Clipboard/mapper/DtoMappers.java - Clipboard state
src/main/java/com/Projects/Online_Clipboard/entity/ClipboardEntity.java - Destruction modes
src/main/java/com/Projects/Online_Clipboard/enums/distructionType.java - Request and response DTOs
src/main/java/com/Projects/Online_Clipboard/dtos
Other components
- Client
Connections 11
- Client → Clipboard endpoints: sends requests
README.md - Clipboard endpoints → Clipboard service: dispatches requests
src/main/java/com/Projects/Online_Clipboard/controllers/ClipboardControllers.java - Clipboard endpoints → Request and response DTOs: accepts and returns
src/main/java/com/Projects/Online_Clipboard/controllers/ClipboardControllers.java - Clipboard endpoints → Clipboard service: checks rate limit
src/main/java/com/Projects/Online_Clipboard/controllers/ClipboardControllers.java - Clipboard service → Redis store: reads and writes
src/main/java/com/Projects/Online_Clipboard/services/ClipboardServices.java - Clipboard service → DTO mapper: maps clipboard data
src/main/java/com/Projects/Online_Clipboard/services/ClipboardServices.java - DTO mapper → Clipboard state: creates state
src/main/java/com/Projects/Online_Clipboard/mapper/DtoMappers.java - Clipboard service → S3 file service: uploads and retrieves files
src/main/java/com/Projects/Online_Clipboard/services/ClipboardServices.java - S3 file service → AWS S3: stores and fetches objects
src/main/java/com/Projects/Online_Clipboard/services/s3Services.java - Clipboard service → Exception mapping: raises handled errors
src/main/java/com/Projects/Online_Clipboard/Exceptions/GlobalExceptionHandler.java - Client → AWS S3: file storage integration
README.md