Работа с фреймворком Micronaut в Java-бекенд разработке

Micronaut отличается от привычных контейнеров тем, что почти всё решает до запуска: внедрение зависимостей, метаданные бинов, реализации репозиториев, перехватчики и клиенты появляются во время компиляции, а не в рантайме. Это меняет и способ писать код, и способ его отлаживать. Пропущенный annotation processor, отсутствующий @Serdeable, @Transactional через this, фильтр, попавший в конвейер раньше SecurityFilter, — ошибки, которых нет в рефлексивных фреймворках, и которые в Micronaut приходится узнавать в лицо.

Курс идёт по механизмам фреймворка в том порядке, в котором они нужны работающему сервису: контейнер бинов и конфигурация, HTTP-сервер и привязка параметров, контракты API и Micronaut Serialization, модель исполнения (event loop, виртуальные потоки, реактивные типы, распространение контекста), Micronaut Data JDBC и транзакции, compile-time AOP, HTTP-клиенты и устойчивость интеграций, Micronaut Security, Redis, планировщик и события, Micronaut Kafka, тестирование, наблюдаемость, real-time (WebSocket, SSE, GraphQL), GraalVM native image и AOT, эксплуатация в проде.

Сквозной проект

Весь курс собирает одну систему — Meterway, платформу учёта потребления и тарификации для сервисов, которые продают доступ по факту использования. Она принимает поток событий потребления от чужих систем, дедуплицирует их, проверяет квоту, складывает агрегаты, применяет ступенчатый тариф и выставляет счёт за расчётный период, а об исходящих событиях уведомляет вебхуками.

Из инженерных задач Meterway взяты те, у которых нет однострочного решения: идемпотентный приём на высокой частоте, опоздавшие и переупорядоченные события, денежная арифметика без потери копеек, атомарная проверка квоты под конкуренцией, повторяемое закрытие периода, мультитенантная изоляция на уровне запроса и данных, холодный старт ingest-подов.

Проект лежит в репозитории курса целиком: ./gradlew run поднимает окружение через Micronaut Test Resources и запускает приложение. Файл, показанный в уроке, находится в проекте в том же виде.

Репозиторий проекта можно клонировать здесь.

Стек

Java 27, Micronaut Framework 5.1 (platform BOM 5.1.3), Gradle 9.6 на Kotlin DSL, Netty, Micronaut Serialization, Micronaut Data JDBC и PostgreSQL 18, Flyway, Redis 8 через Lettuce, Apache Kafka 4.x, Micronaut Security с JWT и API-ключами, Micrometer с Prometheus, OpenTelemetry, JUnit 6 с Micronaut Test и Test Resources, GraalVM native image.

Чего в курсе нет

Курс не учит языку Java и не объясняет бекенд как таковой: HTTP-методы, индексы, транзакции как понятие, устройство JWT как формата предполагаются известными. Новый синтаксис Java (records, sealed-иерархии, pattern matching, виртуальные потоки) вводится по мере надобности, а не как отдельная тема. Spring упоминается только там, где опыт Spring мешает не наступить на compile-time грабли. Jackson Databind, RxJava 2 и идиомы Micronaut 3/4 не используются — кроме урока про миграцию с четвёртой версии.

Как проходит обучение

Уроки текстовые, читаются как главы технической книги: инженерная ситуация, механизм фреймворка, исходный код, последствия в проде, типичные ошибки. Код занимает больше места, чем рассуждения. Каждый урок заканчивается практической задачей по Meterway и вопросами для самопроверки. Главы с третьей по пятнадцатую завершаются тестовыми задачами с одним верным вариантом; у каждой есть объяснение, которое видно после ответа.