This project is a very simple implementation of a blob store http service that is backed by MySQL

It leverages Spring Auto-Reconfiguration to know how to run "in the cloud". That is, it expects a bound database service to work correctly.

No considerations have been made for performance.

Note I in no way recommend deploying this service to the public internet as it is currently designed. This service is designed as a workaround for when you are unwilling or unable to leverage a cloud file store (e.g. AWS S3).

As written, it is intended to be deployed on Cloud Foundry instances that exist behind a firewall.

Aside from the API Key mentioned here, no real considerations have been made to secure the application.

Ensure that BLOBBER_API_KEY is set, clients of this store should provide the same key as a header (X-API-KEY) when posting files.

cf set-env [application-name] BLOBBER_API_KEY [inscrutable-key]

Initialize your database with the following schema

CREATE TABLE files 
 ( 
 id VARCHAR(255), 
 content_bytes LONGBLOB, 
 content_type VARCHAR(255) 
 ); 

I use the this cf cli plugin: andreasf/cf-mysql-plugin to easily connect to my bound database.

./gradlew build
cf push [application-name] -p build/libs/blobber-0.0.1-SNAPSHOT.jar

Upload a file like so

curl -X POST \
 http://[application-name].cfapps.io/files \
 -H 'content-type: multipart/form-data' \
 -H 'x-api-key: [inscrutable-key]' \
 -F file=@[path-to-your-file].png

Currently the service will return a UUID which you can use to construct a public URL

{
 "uuid": "some-fancy-uuid" 
}

becomes:

http://[application-name].cfapps.io/files/some-fancy-uuid

./gradlew test