You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sambo Chea a4fd70a188 Upgraded to spring boot 2.4.4 4 weeks ago
.github/workflows Add github actions 5 months ago
gradle/wrapper Upgraded to spring boot 2.4.4 4 weeks ago
src feat: add graphql exception handler 4 weeks ago
.gitignore refactor: application level prepare for graphql and switch to sqlite 1 month ago
Dockerfile Dockerfile fixed: use gradlew instead of gradle to run the version specified in 4 months ago
LICENSE Create LICENSE 1 month ago Instruction for pre-commit hook 2 months ago
build.gradle Upgraded to spring boot 2.4.4 4 weeks ago
docker-compose.yml adding docker-compose file 3 years ago
example-logo.png update readme 4 years ago
gradlew updated Gradle, Spring Boot, MyBatis, Joda Time to latest 7 months ago
gradlew.bat updated Gradle, Spring Boot, MyBatis, Joda Time to latest 7 months ago

RealWorld Example App using Kotlin and Spring


Spring boot + MyBatis codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This codebase was created to demonstrate a fully fledged fullstack application built with Spring boot + Mybatis including CRUD operations, authentication, routing, pagination, and more.

For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

How it works

The application uses Spring boot (Web, Mybatis).

  • Use the idea of Domain Driven Design to separate the business term and infrastruture term.
  • Use MyBatis to implement the Data Mapper pattern for persistence.
  • Use CQRS pattern to separate the read model and write model.

And the code organize as this:

  1. api is the web layer to implement by Spring MVC
  2. core is the business model including entities and services
  3. application is the high level services for query with the data transfer objects
  4. infrastructure contains all the implementation classes as the technique details


Integration with Spring Security and add other filter for jwt token process.

The secret key is stored in


It uses a H2 in memory database (for now), can be changed easily in the for any other database.

Getting started

You need Java 8 installed.

./gradlew bootRun

To test that it works, open a browser tab at http://localhost:8080/tags .
Alternatively, you can run

curl http://localhost:8080/tags

Try it out with Docker

You need Docker installed.

docker-compose up -d

Try it out with a RealWorld frontend

The entry point address of the backend API is at http://localhost:8080, not http://localhost:8080/api as some of the frontend documentation suggests.

Run test

The repository contains a lot of test cases to cover both api test and repository test.

./gradlew test

Use git pre-commit hook

Follow the instruction from google-java-format-git-pre-commit-hook to use a pre-commit hook to make the code format style stable from different contributors.


Please fork and PR to improve the code.