This Project shows an sample application on Spring 5 reactive stack with Spring WebFlux.
It implements the backend for a media mangamement app similar to OneDrive or GoogleDrive with less functionality. It focuses on a good usage of technologies rather than a wide functionality.
The backend supports CRUD operations for media, folders, tagging of media and metadata extraction such as a simple user management. There are functional endpoints for each of these functions given in the Handler classes.
- Security is done with OIDC provider Okta which is free for projects with small traffic (up to 1000 monthly active users). There you will need an application where you must whitelist the routes for this project.
- Persistence is done with MongoDB. We used a free MongoDb Atlas Cluster. You can create an account and use it up to a specific size for free. You can specify your collection in the connection string you'll get. The collections will be created automatically.
Alternatively, you can use your own (local) MongoDB instance.
To setup this project you need to add an application.properties file to src/main/resources and src/test/resources. There you must specify your okta and MongoDb Atlas properties. You need the following properties:
# MongoDB connection string
spring.data.mongodb.uri= TODO your_mongo_db_connection_string
# Okta-Config
okta.baseUrl= TODO your_okta_base_url (ending with .oktapreview.com)
okta.oauth2.issuer=${okta.baseUrl}/oauth2/default
okta.oauth2.clientId= TODO your_client_id
okta.apiKey= TODO your_api_key
okta.apiUrl=${okta.baseUrl}/api/v1
# users group
okta.userGroupIds= TODO your_group_ids (if you have groups)You'll find example files in src/(main|test)/resources. Copy example.application.properties to application.properties and adjust it to your needs (okta keys and MongoDB connection string).
Don't forget to use different DB collections for test and production usage.
We have implemented a frontend which uses this api too. It's implemented with Angular 7 and you'll find the code here.