中文版

• Build and Run
• NOTICE
• Usage
  • Import init.sql
  • Config application.yml
  • Access resources with Swagger
• Deploy
• License

spring-microservices-boilerplate is a boilerplate which is very helpful for java programmer and friendly to front end.

And build with:

• Spring Boot
• Spring OAuth 2
• Spring Security
• Spring Data JPA

And use specification-arg-resolver for filter.

NOTE If you need RSA sign check, you can use validateWithSignCheck of ValidateHelper

$ cd <spring-microservices-boilerplate root path>
$ ./gradlew clean build bootRun

• Validate failed -> Response http status is 422(Unprocessable Entity)
• Server error -> Response http status is 500(Internal Server Error)

Run it, Open your browser and access http://localhost:8080/swagger-ui.html#/.

NOTE Default port is 8080, you can modify it which key is server.port in application.yml.

You can test API by the tips.

1. Get access_token and refresh_token with login API. and result is:

You'll get a 429 response when you add a "Limit-Key" header value like "root" and request the api too often.
(3 times in 10 seconds, you can config it in application.yml).

Request with "Limit-Key" header: and result is:

2. Or get new access_token with refresh_token.

3. Access users. and result is:

1. Build war and use tomcat.
2. Build jar and run java -jar foo.jar
3. Use Docker. You can build your docker image by Dockerfile. And run it with docker-compose.yml.

MIT

Copyright (c) since 2015 saintdan

Version history is here. ;)