https://github.com/boweihan/spring-boot-auth-boilerplate
Simple server implementation with Spring Boot - bootstrapped with authentication/encryption/models - techologies: Java, Spring, Postgres
https://github.com/boweihan/spring-boot-auth-boilerplate
gradle javascript server spring springboot
Last synced: 2 months ago
JSON representation
Simple server implementation with Spring Boot - bootstrapped with authentication/encryption/models - techologies: Java, Spring, Postgres
- Host: GitHub
- URL: https://github.com/boweihan/spring-boot-auth-boilerplate
- Owner: boweihan
- License: mit
- Created: 2017-09-16T20:21:43.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-03-11T02:32:54.000Z (over 8 years ago)
- Last Synced: 2025-01-31T09:45:39.924Z (over 1 year ago)
- Topics: gradle, javascript, server, spring, springboot
- Language: Java
- Homepage:
- Size: 43.8 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Convenience.
“The state of convenience lies in the hands of proper planning.
When you know this, you will become a good planner;
and when you become a good planner, you save your life from stress!”
- Israelmore Ayivor
basic-spring-boot-server
basic-spring-boot-server presents an opioninated implementation of
a generic Java backend. The purpose is to provide a groundwork on which real ideas
and applications can be prototyped.
What's Included?
- Spring Framework REST implementation and functionality
- Jetty as our HTTP server
- Spring Boot Actuator for production metrics and endpoints
- User/Role basic authentication and authorization
- Secure field encryption (Bcrypt)
- Spring Data with Hibernate ORM for data access management
- Unit tests that run on build
- DB Seeding
- Custom exceptions and exception handling
- Postgres as a database
How do I use it?
basic-spring-boot-server uses gradle as a build tool. First, start by creating a gradle wrapper:
Wrapper: gradle wrapper --gradle-version 2.13
Next, build the project with gradle:
./gradlew build
Lastly, start up your server!
java -jar build/libs/gs-spring-boot-0.1.0.jar
Or execute both commands at once :)
./gradlew build && java -jar build/libs/gs-spring-boot-0.1.0.jar
If this didn't work right away, you might need to configure your local postgres database (next section).
Configuring PostgreSQL to work with basic-spring-boot-server
Local DB configuration can be found in application.yml. Replace the existing properties with your local
PostgreSQL config. For example:
url=jdbc:postgresql://localhost:5432/YOUR_DATABASE_NAME
username=YOUR_USERNAME
password=YOUR_PASSWORD
Deployment
basic-spring-boot-server is configured to work with Heroku out of the box.
To deploy the application to your Heroku account simply follow the instructions here:
https://devcenter.heroku.com/articles/deploying-gradle-apps-on-heroku
Base production configurations are set up in application.yml.
Notes
- Server is configured to run on port 8080
- API security management is configured in WebSecurityConfig.java
- On startup, your database will be seeded with an admin user ("admin"/"admin@bsbs.com")