К основному содержанию
скилл CX Codex

511-frameworks-micronaut-jdbc — скилл для Claude Code

Скилл 511-frameworks-micronaut-jdbc проверяет и улучшает программный JDBC-код в Micronaut: SQL, транзакции, пул соединений, пакетные операции и обработку ошибок.

Apache-2.0 318 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a claude-code
Открыть на GitHub

Что делает 511-frameworks-micronaut-jdbc

Скилл разбирает JDBC-доступ в Micronaut через внедрённый javax.sql.DataSource, включая Hikari из micronaut-jdbc-hikari. Он проверяет PreparedStatement с параметрами, преобразование строк ResultSet в Java records, безопасные запросы одной строки через Optional<T> и перевод SQLException в доменные исключения. Для больших выборок учитывает setFetchSize, а для массовых вставок — addBatch и executeBatch.

Отдельно проверяются границы @Transactional, TransactionDefinition.Propagation и ошибка self-invocation, когда транзакционный метод вызывают через this.method(). Скилл предлагает сверяться с references/511-frameworks-micronaut-jdbc.md и учитывать, когда вместо raw JDBC лучше выбрать Micronaut Data. Перед изменениями нужно выполнить ./mvnw compile или mvn compile, а после — ./mvnw clean verify или mvn clean verify. Если компиляция завершается ошибкой, скилл останавливается.

Какие задачи решает

  • проверить параметризацию SQL-запросов
  • настроить границы транзакций в сервисе
  • перевести SQLException в доменные исключения
  • обработать большие ResultSet без переполнения памяти
  • ускорить массовые вставки через пакетные операции

Примеры запросов агенту

  • Проверь JDBC-доступ в Micronaut и найди конкатенацию строк в SQL.
  • Исправь обход @Transactional при self-invocation и проверь границы транзакции.
  • Переработай чтение большого ResultSet с учётом setFetchSize.

Как установить 511-frameworks-micronaut-jdbc

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a claude-code

2Вручную: положить файлы

~/.claude/skills/511-frameworks-micronaut-jdbc/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/511-frameworks-micronaut-jdbc/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о 511-frameworks-micronaut-jdbc

Как установить 511-frameworks-micronaut-jdbc в Claude Code?

Выполните npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a claude-code, затем проверьте файл ~/.claude/skills/511-frameworks-micronaut-jdbc/SKILL.md.

Что делает 511-frameworks-micronaut-jdbc?

Скилл применяет правила для программного JDBC в Micronaut: параметризованный SQL, пул DataSource, транзакции, пакетные операции, потоковое чтение и перевод ошибок в доменные исключения.

Что нужно выполнить до и после изменений?

До изменений проект должен успешно пройти ./mvnw compile или mvn compile. После изменений нужно запустить ./mvnw clean verify или mvn clean verify.

Исходный текст

SKILL.md · Apache-2.0
---
name: 511-frameworks-micronaut-jdbc
description: Use when you need programmatic JDBC in Micronaut — pooled DataSource, parameterized SQL, io.micronaut.transaction.annotation.Transactional, batching, and domain exception translation. This should trigger for requests such as Review JDBC or SQL data access in a Micronaut project; Improve transactions and parameter binding for Micronaut JDBC; Translate SQLException to domain exceptions or stream large result sets; Fix self-invocation bypassing @Transactional in Micronaut; Review Hikari or pooled datasource usage in Micronaut JDBC. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Micronaut JDBC — programmatic SQL

Apply programmatic JDBC patterns in Micronaut with safe SQL and clear transactions.

**What is covered in this Skill?**

- Injected javax.sql.DataSource (Hikari-backed with micronaut-jdbc-hikari) and try-with-resources for Connection / PreparedStatement
- PreparedStatement with bind parameters — never string concatenation
- Mapping ResultSet rows to Java records (dedicated mapRow method)
- Safe single-row queries with Optional<T>; never assume rs.next() succeeds
- SQLException translation to domain exceptions (catch-translate-rethrow)
- Streaming large result sets with setFetchSize to avoid OOM
- Batch updates with addBatch / executeBatch for bulk inserts
- @Transactional service boundaries and TransactionDefinition.Propagation (e.g. REQUIRES_NEW for independent commits)
- Self-invocation pitfall: call transactional collaborators through injected beans, not this.method()
- SQL text blocks for multi-line SQL (upserts, dialect-specific clauses)
- When to prefer Micronaut Data (`@512`) vs raw JDBC

**Scope:** Apply recommendations based on the reference rules and good/bad code examples.

## Constraints

Compile before JDBC refactors; verify after changes.

- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change
- **PREREQUISITE**: Project must compile before applying JDBC improvements
- **SAFETY**: If compilation fails, stop immediately
- **BLOCKING CONDITION**: Compilation errors must be resolved by the user before proceeding
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
- **BEFORE APPLYING**: Read the reference for detailed rules and examples

## When to use this skill

- Review JDBC or SQL data access in a Micronaut project
- Improve transactions and parameter binding for Micronaut JDBC
- Translate SQLException to domain exceptions or stream large result sets
- Fix self-invocation bypassing @Transactional in Micronaut
- Review Hikari or pooled datasource usage in Micronaut JDBC

## Workflow

1. **Read reference and assess project context**

Read `references/511-frameworks-micronaut-jdbc.md` and inspect the current project setup before proposing changes.

2. **Gather scope and decide target improvements**

Identify requested outcomes, constraints, and the minimum safe set of changes to apply.

3. **Apply framework-aligned changes**

Implement or refactor configuration/code following the reference patterns and project conventions.

4. **Run verification and report results**

Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions.

## Reference

For detailed guidance, examples, and constraints, see [references/511-frameworks-micronaut-jdbc.md](references/511-frameworks-micronaut-jdbc.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
sql-jdbc-access-design Samuel Berthe Скилл sql-jdbc-access-design проектирует, как продукт отдаёт клиентам свои данные по SQL: JDBC/ODBC-эндпоинт, шару в хранилище или хостед-запросы. Пригодится до того, как подключится первый клиент. CX Codex +1 10 100установок micronaut Mindrally Задаёт конвенции Micronaut — DI на этапе компиляции, нативные сборки GraalVM, реактивные сервисы. Держит кодогенерацию в рамках фреймворка на Java-проектах. CX Codex +1 732установок neo4j-driver-java-skill neo4j-contrib Скилл neo4j-driver-java-skill для Claude Code помогает писать Java- и Kotlin-код для подключения к Neo4j. Включается при настройке драйвера, сессий и транзакций или разборе ошибок подключения. CX Codex +1 815установок sql-best-practices Mindrally Скилл sql-best-practices для Claude Code задаёт правила форматирования SQL, индексации, явных JOIN и защиты от SQL-инъекций при работе с базой данных. CX Codex +1 845установок database-development okou-ai Скилл database-development раскладывает изменения в базе по веткам и отправляет к нужному справочнику: миграции, запросы, транзакции, внешние эффекты, порядок деплоя. CX Codex +1 1установок go-database eduardo-sl Скилл go-database для Claude Code помогает писать доступ к базе данных в Go-сервисах. Подключается к задачам с SQL-запросами, транзакциями и миграциями. CX Codex +1 ★ 90звёзд репо

Из того же набора123

Весь набор →
512-frameworks-micronaut-data Скилл 512-frameworks-micronaut-data для работы с репозиториями и сущностями Micronaut Data: маппинг, транзакции, пагинация, проекции и тесты на Testcontainers. CX Codex +1 322установок 502-frameworks-micronaut-rest Скилл 502-frameworks-micronaut-rest помогает проектировать и проверять REST API на Micronaut по стандартам HTTP. Настраивает валидацию DTO и обработку ошибок. CX Codex +1 322установок 523-frameworks-micronaut-testing-acceptance-tests Скилл 523-frameworks-micronaut-testing-acceptance-tests помогает довести приёмочные тесты Micronaut от фактов Gherkin-сценариев до рабочего кода с настоящим HTTP, Testcontainers и WireMock. CX Codex +1 321установок 702-technologies-wiremock Скилл 702-technologies-wiremock помогает проектировать стабы WireMock, настраивать изоляцию тестов и проверять исходящие HTTP-запросы без привязки к фреймворкам. CX Codex +1 318установок 513-frameworks-micronaut-db-migrations-flyway Скилл 513-frameworks-micronaut-db-migrations-flyway помогает добавлять и проверять миграции Flyway в Micronaut: от SQL-файлов и конфигурации до порядка применения и тестов. CX Codex +1 317установок 002-agents-inventory Скилл 002-agents-inventory для автоматического создания контрольного списка с реестром встроенных Java-агентов. Генерирует файл INVENTORY-AGENTS-JAVA.md по строгому шаблону, соблюдая точную структуру и содержание. CX Codex +1 314установок 043-planning-github-issues Скилл 043-planning-github-issues помогает настроить GitHub CLI и выстроить трассировку задач по документам в репозитории без загрузки текста issue в контекст модели. CX Codex +1 312установок 126-java-exception-handling Скилл 126-java-exception-handling для Claude Code помогает применять правила обработки исключений в Java. Подключается к запросам на проверку типов исключений, ресурсов и передачи ошибок. CX Codex +1 307установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой