spring-fileserver

Simple FileServer demo

This is simple spring-boot FileServer demo. This server makes specified base directory accessible via REST APIs allowing you to list, download, upload and delete files and create empty directories.

Rest Endpoints

All REST endpoints use 'dynamic' path. This means that path ** is used as relative path in base directory.

• GET http://localhost:8888/services/files/list/** - list content directory or subdirectory
  curl -X GET http://localhost:8888/services/files/list/
• GET http://localhost:8888/services/files/download/** - download file on path. file must exist.
  curl -X GET http://localhost:8888/services/files/list/path/to/001-data.txt

Upload files

• POST http://localhost:8888/services/files/upload/** - upload file, parent directory(ies) must exist before upload
  curl -F 'file=@/local/path/to/file.txt' http://localhost:8888/services/files/upload/path/to/001-data.txt

Delete files and directories

• DELETE http://localhost:8888/services/files/delete/** - delete file or directory
  curl -X DELETE http://localhost:8888/services/files/delete/path/to/001-data.txt

Create empty directory

• POST http://localhost:8888/services/files/createdir/** - create empty directory
  curl -X POST http://localhost:8888/services/files/createdir/path/to/directory

Build and run

Variable file.server.home in application.properties file defines base directory to be exposed via REST APIs.

gradle clean build
java -jar build/libs/springboot-fileserver-0.0.1-SNAPSHOT.jar --spring.config.location=file:./src/main/resources/application.properties