kotlin-spring-boot-rest-jpa-jwt-starter

Features:

• spring-boot 2.6.x
• kotlin 1.6.x
• JWT Authentication/Authorization with spring-security inspired by Auth0
• JPA mysql / OpenCVS / POI
• Travis CI / codecov

Install & play

• create a mysql db

-- for mysql 5.7
CREATE DATABASE starterspringkotlin;
GRANT ALL ON starterspringkotlin.* TO starterspringkotlin@localhost IDENTIFIED BY 'starterspringkotlin';
FLUSH PRIVILEGES;
-- for mysql 8
CREATE DATABASE starterspringkotlin;
CREATE USER 'starterspringkotlin'@'localhost' IDENTIFIED BY 'starterspringkotlin';
GRANT ALL PRIVILEGES ON starterspringkotlin.* TO 'starterspringkotlin'@'localhost';
FLUSH PRIVILEGES;

check src/main/resources/application.yaml for mysql 5.7 or 8 support (keys are spring.jpa.database-platform and spring.datasource.url)

• compile & integration tests

mvn -Ddockerfile.skip clean compile test

• run app

mvn spring-boot:run

• some CLI tests

curl http://localhost:4080/starter-test/api/v1/test
# result: Pong!%

curl http://localhost:4080/starter-test/api/v1/restricted
# result {"timestamp":"***","status":403,"error":"Forbidden","message":"Access Denied","path":"/starter-test/api/v1/restricted"}%

curl -s -i -H "Content-Type: application/json" -X POST -d '{ "username": "john.doe", "password": "test1234"}' http://localhost:4080/starter-test/login | grep Authorization
# result: Authorization: Bearer ***

curl  -H "Authorization: Bearer ***"  http://localhost:4080/starter-test/api/v1/restricted
# result: Pong!%

Docker

mvn clean package -Dmaven.test.skip=true
docker run -it -p 8888:8888 --rm osahner/kotlin-spring-boot-rest-jpa-jwt-starter:latest

curl http://localhost:8888/starter-test/api/v1/test
# result: Pong!%

Why

This is my tiny backend cookbook. I need and use it on regular basis for different small to midsized projects.

• Like it -> use it.
• Found an error -> please tell me.

Changelog

• v0.8.1-SNAPSHOT: spring-boot 2.6.x
• v0.8.0-SNAPSHOT: renamed default branch to main, spring-boot 2.5.x, kotlin 1.4.10
• v0.7.1-SNAPSHOT: spring-boot 2.4.0
• v0.6.6-SNAPSHOT: spring-boot 2.3.4, kotlin 1.4.10, update docker build
• v0.6.5-SNAPSHOT: spring-boot 2.3.2, kotlin 1.3.72, fix JPA uneccessary creation of hibernate_sequence and join tables without primary key, enhanced PoiExportService
• v0.6.4-SNAPSHOT: spring-boot 2.2.4, kotlin 1.3.70, fix REST API naming convention
• v0.6.1-SNAPSHOT: add Docker
• v0.6.0-SNAPSHOT: update spring-boot 2.2.0.RELEASE, add address controller with csv import an xls export
• v0.5.0-SNAPSHOT: spring-boot 2.1.9, and kotlin 1.3.50
• v0.4.1-SNAPSHOT: spring-boot 2.1.3 and kotlin 1.3.21, add codecov, fixed code style, fix tests, add coverage
• v0.3.1-SNAPSHOT: update jdk11, spring-boot 2.1.2 and kotlin 1.3.20
• v0.1.0-SNAPSHOT: switch to jar packaging standalone app, update kotlin 1.2.61, jwt 0.10.5
• v0.0.5-SNAPSHOT: update spring-boot 2.0.4.RELEASE, kotlin 1.2.60, jwt 0.10.1

Rename local master branch to main

git branch -m master main
git fetch origin
git branch -u origin/main main

LICENCE

MIT © Oliver Sahner