spring-webmvc-jwt-sample
What is this?
This is a sample project demos how to use JWT token based authentication to protect the RESTful APIs in a Spring WebMVC application.
If you are interested in the new variant built with the Spring WebFlux stack, check spring-reactive-jwt-sample for more details.
Guide
Check the step-by-step GUIDE to get the detailed explanation of the example codes.
The original codes were written in Spring Boot 2.0, there are some slightly difference in the main/master branch due to the changes brought in the latest Spring Boot 2.4.
Prerequisites
Make sure you have installed the following software.
- Java 11
- Apache Maven 3.6.x
- Docker
Build
Clone the source codes from Github.
git clone https://github.com/hantsy/spring-webmvc-jwt-sample
Open a terminal, and switch to the root folder of the project, and run the following command to build the whole project.
docker-compose up postgres // start up a postgres
mvn clean install // build the project
Run the application.
mvn spring-boot:run
// or from command line after building
java -jar target/xxx.jar
Contribution
Any suggestions are welcome, filing an issue or submitting a PR is also highly recommended.