How postreen/multimedia-service works
Rugid Multimedia Service is a Spring-based media file service. Clients upload, retrieve, delete, or request the default ID for images and videos; REST endpoints validate requests and dispatch to shared domain use cases, with file bytes persisted by a filesystem adapter. It also exposes an image gRPC adapter. The README gives no capability details, so the workflow is grounded mainly in the source index and shown excerpts; unsampled wiring is omitted where it cannot be established.
Main entry points: ImageEndpoint.java Image REST API · VideoEndpoint.java Video REST API · FileOutputPort.java File Output Port · UploadFileService.java Upload Service
Components 17
Inbound APIs
- Image REST API
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - Video REST API
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java - Image gRPC API
src/main/java/com/rugid/multimediaservice/adapter/in/grpc/ImageServiceGrpc.java
Media Use Cases
- Upload Service
src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java - Download Service
src/main/java/com/rugid/multimediaservice/domain/core/service/DownloadFileService.java - Delete Service
src/main/java/com/rugid/multimediaservice/domain/core/service/DeleteFileService.java - Default ID Service
src/main/java/com/rugid/multimediaservice/domain/core/service/GetDefaultFileUrlService.java - Upload Use Case
src/main/java/com/rugid/multimediaservice/domain/port/in/UploadFileUseCase.java - Download Use Case
src/main/java/com/rugid/multimediaservice/domain/port/in/DownloadFileUseCase.java - Delete Use Case
src/main/java/com/rugid/multimediaservice/domain/port/in/DeleteFileUseCase.java - Default ID Use Case
src/main/java/com/rugid/multimediaservice/domain/port/in/GetDefaultFileUrlUseCase.java
File Storage
- File Output Port
src/main/java/com/rugid/multimediaservice/domain/port/out/FileOutputPort.java - System File Adapter
src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java
Validation and Errors
- DTO Validator
src/main/java/com/rugid/multimediaservice/adapter/in/rest/validator/JsonDtoValidator.java - Exception Handler
src/main/java/com/rugid/multimediaservice/adapter/in/exception/handler/GlobalExceptionHandler.java
Other components
- API Client
- Local Filesystem
Connections 19
- API Client → Image REST API: calls REST
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - API Client → Video REST API: calls REST
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java - API Client → Image gRPC API: calls gRPC
- Image REST API → DTO Validator: validates requests
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - Video REST API → DTO Validator: validates requests
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java - Image REST API → Upload Service: invokes upload
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - Image REST API → Download Service: invokes download
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - Image REST API → Delete Service: invokes delete
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - Image REST API → Default ID Service: requests default ID
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java - Video REST API → Upload Service: invokes upload
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java - Video REST API → Delete Service: invokes delete
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java - Video REST API → Default ID Service: requests default ID
src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java - Image gRPC API → Delete Use Case: references use case
src/main/java/com/rugid/multimediaservice/adapter/in/grpc/ImageServiceGrpc.java - Upload Service → File Output Port: writes media
src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java - Download Service → File Output Port: reads media
src/main/java/com/rugid/multimediaservice/domain/core/service/DownloadFileService.java - Delete Service → File Output Port: deletes media
src/main/java/com/rugid/multimediaservice/domain/core/service/DeleteFileService.java - System File Adapter → File Output Port: implements port
src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java - System File Adapter → Local Filesystem: reads and writes
src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java - DTO Validator → Exception Handler: raises validation error