README.md

jactor-persistence

What is this repository for?

The main purpose is to learn about programming microservices using Kotlin, (with REST and spring JPA). I also use GitHub to get a deeper understanding of continuous integration/DevOps using GitHub workflow/actions, gradle, and docker running integration testing with cucumber.

This project is a microservice dealing with persistence to a database using JPA (java persistence api) via spring-data-jpa and is a microservice to use under com.github.jactor.percistence (formerly as part of the archived project jactor-rises)

Set up

• a spring-boot 2 application
  • build with gradle.
  • is using h2 (in-memory database)
  • run it with docker, spring-boot, or as any other java-application
• this application is documented with swagger. After startup, use link:
  • http://localhost:1099/jactor-persistence/swagger-ui/index.html?configUrl=/jactor-persistence/v3/api-docs/swagger-config#/ (swagger ui)

Build

This is application is build with gradle.

From the root of the source code:

./gradlew build

Run

All commands are being executed from the root of the source code.

Run it with gradle:

./gradlew bootRun

After a valid build one can execute the generated jar file as plain java:

java -jar build/lib/jactor-persistence-<version>-SNAPSHOT.jar

or build and run an image with docker:

docker build -t jactor-persistence .
docker run -p 1099:1099 jactor-persistence

Some technologies used

Implementation

• spring-boot 3.3.x
  • with spring-data-jpa
  • with spring-webflow (mvc)
• h2
• kotlin

Unit testing

• assertk
• junit jupiter
• mockk and springmockk

Build and documentation

• flyway
• github actions
• gradle (8.x)
• swagger-ui
  • herunder springdoc
• sdk man