Spring Boot Integration
Latest stable Based on Image release 0.3.0
bluetape4k-images-spring-boot provides Spring Boot 4 auto-configuration for image storage, optional CDN URL signing, health, and metrics. Core processing remains in the image library.
Auto-configuration groups
Section titled “Auto-configuration groups”- Storage configuration selects local or S3-backed
ImageStorage. - CDN configuration creates optional CloudFront URL signing support.
- Health configuration exposes storage availability through Actuator contracts.
- Metrics configuration instruments storage operations when Micrometer is present.
- Processing configuration binds processing properties only; the application still creates and owns its processor or pipeline components.
Optional AWS and observability dependencies are compile-only in the library. The application brings the features it uses.
Configuration ownership
Section titled “Configuration ownership”Bind storage roots, bucket and region settings, CDN keys, upload policy, and feature switches from the application’s secure configuration. Validate local roots and create directories with appropriate permissions. Use the standard AWS provider chain or application credential policy; never place secrets in manual examples or repository files.
Start with the workshop
Section titled “Start with the workshop”The Spring Boot image API workshop demonstrates multipart upload, local storage, download, thumbnail processing, configuration, and tests. Replace its local assumptions before production. For OCR, use the separate Spring Boot OCR workshop.
Read storage and CDN before selecting an operational backend.