Шаблон приложения Kora Java CRUD

Шаблон для быстрого старта нового проекта на Java и Kora с базовым настроенным HTTP CRUD API для одной сущности. В качестве базы данных выступает Postgres, используется кэш Caffeine, а также другие модули которые использовались бы в реальном приложении в бою.

В шаблоне используются модули:

• HTTP сервер
• OpenAPI HTTP серверная генерация
• Пробы
• Метрики
• JDBC база данных
• JSON конвертация
• Отказоусточивость
• Валидация
• Caffeine кеш

Build

Собрать классы:

./gradlew classes

Собрать артефакт:

./gradlew distTar

Generate

Сгенерировать API для HTTP Server:

./gradlew openApiGenerateHttpServer

Image

Собрать образ приложения:

docker build -t kora-java-crud-template .

Migration

Накатить миграции

./gradlew flywayMigrate

Run

Перед запуском локально требуется запустить базу Postgres и накатить миграции.

Запустить локально:

./gradlew run

Run Docker-Compose

Требуется сначала собрать артефакт.

Запустить как docker-compose:

docker-compose up

Test

Тесты используют Testcontainers, требуется Docker окружение для запуска тестов или аналогичные контейнерные окружения (colima / итп)

Протестировать локально:

./gradlew test