Перейти к основному содержимому

Spring

OpenIDE разбирает Spring-приложение на бины, эндпоинты, сущности, репозитории и миграции и показывает связи между ними. Навигация, автодополнение и базовые инструменты для Spring Boot есть в OpenIDE. Первоклассная поддержка Spring в OpenIDE Pro доступна благодаря встроенному Amplicode PRO со всеми его возможностями: генерация CRUD-контроллеров, DTO и MapStruct-мапперов, миграции Liquibase и Flyway, конфигурация Spring Security, Docker Compose и Spring MCP для AI-агентов. Отдельно покупать и устанавливать Amplicode не нужно.

Редакция: базовая поддержка в OpenIDE, полная — в OpenIDE Pro.

Плагин: Amplicode

Amplicode Explorer и Bean Navigation: структура Spring-приложения, эндпоинты и связи бинов видны без поиска по файлам

Описано по материалам amplicode.ru и версии Amplicode 2026.1 (ноябрь 2026). Ролики и скриншоты взяты с amplicode.ru.

Что поддерживается​

ВозможностьЧто есть
СтекSpring Boot, Spring MVC, Spring Data (JPA, JDBC, MongoDB), Spring Security, Spring AOP, Spring Reactive; JPA и Hibernate, MapStruct, Liquibase и Flyway, Kafka; код на Java и Kotlin
Структура приложенияПанель Amplicode Explorer: конфигурации, слой данных, эндпоинты, Kafka, Docker, Kubernetes
БиныBean Navigation, инжекция бина по имени, поиск циклических зависимостей до запуска
ЭндпоинтыСписок с группировкой, поиск, значок доступности по правилам Spring Security, HTTP-запрос от эндпоинта
КонфигурацияАвтодополнение и навигация в application.properties и application.yml, свои классы с @ConfigurationProperties, поля @Value по имени свойства
Генерация кодаCRUD REST-контроллер и отдельные методы, DTO, MapStruct-мапперы, делегирование методов между слоями, Spring Web тесты
Spring Data и JPAСущности, атрибуты и ассоциации, репозитории, derived- и @Query-методы, аудит, сущности из таблиц базы
МиграцииChangelog Liquibase и версионированные миграции Flyway по разнице схем, скрипт инициализации, окно предпросмотра
Spring SecurityКонфигурация и SecurityFilterChain: HTTP session, JWT, OAuth 2.0 / OIDC, Spring Authorization Server, LDAP
ИнфраструктураDockerfile, Docker Compose, Helm-чарты, Terraform
AI-агентыSpring MCP и Spring Agent Toolkit

Для Spring анализ местами глубже, чем в IntelliJ IDEA Ultimate: например, циклические зависимости бинов видны ещё до запуска приложения.

Навигация по приложению​

Amplicode Explorer: структура проекта​

Панель Amplicode Explorer показывает приложение по слоям, а не по папкам: подключённые конфигурации и источники данных, сущности со связями, репозиториями, DTO и проекциями, эндпоинты, Kafka, файлы Docker и Kubernetes. От узла дерева можно перейти к исходному коду.

Панель Amplicode Explorer проекта BlogApplication: узлы Configurations со Spring Data JPA и Data Sources, Persistence с сущностями BaseEntity, Post и User, их связями Refers to и Referenced by, репозиториями и DTO, ниже Events, Endpoints и Docker с файлом docker-compose.yaml

Amplicode Explorer: конфигурации, сущности со связями, эндпоинты и Docker Compose в одном дереве.

Обзор Amplicode Explorer: от репозитория в дереве — к его коду, от сущности — к связям и DTO

Бины​

У каждого бина на полях редактора (в гаттере) стоит значок Bean Navigation. Он открывает дерево связей: какие бины инжектированы в текущий (Autowires) и куда инжектирован он сам (Autowired in). В дереве видны бины приложения и сторонних библиотек, а для интерфейсов — все реализации. К бину можно перейти и прямо из места инжекции. Бины, зарегистрированные программно через registerBean(), учитываются наравне с остальными.

Bean Navigation: переход от контроллера к мапперу с предпросмотром кода

Циклические зависимости находятся до запуска приложения: в дереве Bean Navigation бин, замыкающий цикл, помечен как Cyclic reference.

Окно Bean Navigation для ProductController: в ветке Autowires цепочка ProductService, ProductServiceImpl, FileUploader, YandexS3Storage, внутри которой ProductService помечен как Cyclic reference; раздел Autowired in пуст

Цикл ProductService → YandexS3Storage → ProductService виден в дереве связей до старта приложения.

Эндпоинты​

Раздел Endpoints в Amplicode Explorer собирает HTTP-эндпоинты приложения: метод, путь и тип ответа. Эндпоинты группируются по классам, по пути или выводятся плоским списком.

Раздел Endpoints в Amplicode Explorer проекта spring-petclinic: под OwnerRestController шесть эндпоинтов с цветными метками POST, GET, DEL, PTCH и PUT, путями /rest/owners и типами ответа OwnerDto и OwnerMinimalDto; ниже остальные контроллеры, узлы Kafka, Docker и Kubernetes

Эндпоинты контроллера: HTTP-метод, путь и возвращаемый тип.

Чтобы найти эндпоинт по части пути, нажмите Shift+Ctrl+/ (на macOS Shift+Cmd+/): откроется вкладка Endpoints окна Поиск везде (Search Everywhere).

Анимация: в Amplicode Explorer проекта OrdersApplication группировка эндпоинтов переключается между By Path, By Controller и Flatten, затем на вкладке Endpoints окна Search Everywhere по запросу orderlines находятся три эндпоинта OrderController

Группировка эндпоинтов и поиск по части пути.

В тестах URL автодополняется по имени и типу запроса, а от адреса в тесте можно перейти к методу контроллера.

Автодополнение адреса эндпоинта в тесте MockMvc и переход от URL к методу контроллера

Конфигурация​

В application.properties и application.yml автодополняются имена и значения свойств. Учитываются не только свойства Spring, но и собственные классы с @ConfigurationProperties. По свойствам работает навигация.

Автодополнение имени и значения свойства в application.properties
  • @Value по имени свойства. В месте, где нужно значение из application.yml или .properties, начните печатать название свойства — поле с @Value и путём до свойства появится само.
  • Переменные окружения в Docker Compose и Helm. В docker-compose.yml, values.yaml и шаблонах Helm подсказываются имена переменных окружения для свойств Spring.
  • Wrap properties into (Pro). Контекстное действие оборачивает значения свойств в переменные окружения: например, localhost превращается в ${POSTGRES_HOST:localhost}.
Wrap properties into: параметры подключения к базе в application.properties заменяются переменными окружения

Spring AOP​

В выражениях AspectJ, которые использует Spring AOP, работают подсветка, автодополнение и проверка имён. Из выражения можно перейти к пакетам, классам и методам проекта и библиотек, а также к pointcut-методам. Поддерживаются execution, this, target, @target, @within, @annotation и @args.

Генерация кода​

Генератор и AI-агент выводят код из разного: агент — из промпта и файлов проекта, генератор — из модели приложения и заранее заданного правила. Правило в генераторе — это случай, который кто-то уже разобрал, а не догадка по формулировке.

Что генерируетсяИз чего
CRUD REST-контроллерИз репозитория, с DTO, фильтром и пагинацией
Отдельный CRUD-методИз списка CRUD methods в существующем контроллере
DTOИз сущности: отмечаете нужные поля, включая вложенные связи
MapStruct-мапперИз пары «сущность → DTO»
Spring Web тестыИз эндпоинтов контроллера
Конфигурация Spring SecurityЧерез диалог: способ аутентификации и SecurityFilterChain
Конфигурация стартераДействием Add Configuration в Amplicode Explorer

Действия Amplicode собраны в трёх местах: в меню Код → Сгенерировать… (Code → Generate…, Alt+Insert, на macOS Cmd+N), в палитре панели Amplicode Designer и в значках на полях редактора. Кодогенерация — контроллеры, делегирование, тесты, Add Configuration — входит в OpenIDE Pro; инжекция бинов при наборе работает и в OpenIDE.

Инжекция бинов​

Начните вводить имя нужного бина в теле метода — он будет инжектирован в класс автоматически. Учитываются Lombok и выбранный способ инжекции.

Инжекция бина при наборе: в контроллере с RequiredArgsConstructor появляется поле ownerRepository

CRUD REST-контроллер​

Контроллер создаётся из Amplicode Explorer: Endpoints → New → CRUD REST Controller. В диалоге выбираются репозиторий, класс DTO, путь запроса, фильтр списка, прокси-сервис и пагинация. Там же создаётся пустой REST- или MVC-контроллер и обработчик исключений.

Amplicode Explorer проекта spring-petclinic: в контекстном меню раздела Endpoints пункты REST/MVC Controller, CRUD REST Controller и Exception Handler; справа диалог New REST/MVC Controller с типом REST, классом OwnerRestController, пакетом и Request path /rest/owners

Создание контроллера из раздела Endpoints: тип, класс, пакет и путь запроса.

Диалог New CRUD REST Controller: репозиторий, DTO, путь запроса и пагинация, на выходе контроллер со всеми методами

В существующий контроллер методы добавляются по одному: Код → Сгенерировать… (Code → Generate…) → CRUD methods. В списке — получение одной записи, набора и всех записей с фильтром, пагинацией и сортировкой, создание, полное и частичное обновление, удаление.

Меню Generate в классе OwnerRestController с пунктами Amplicode: Create Event Handler, Autowire Bean, Exception Handler, Delegate from, Generate Spring Web Tests, Generate OpenApi Schema и CRUD methods; рядом список CRUD methods от Get All (with filter, paging, sorting) до Delete Many (by ids)

Список CRUD methods: десять готовых методов для существующего контроллера.

Добавление метода Create One из палитры Amplicode Designer в существующий контроллер

Для метода получения списка фильтр собирается в диалоге: атрибут, условие и учёт регистра для каждой строки.

Диалог New JPA Specification Filter для сущности Owner: класс OwnerFilter, включён Java Record, в таблице Query Conditions три условия — firstName StartsWith, lastName StartsWith и city Is, для всех отмечен IgnoreCase

Фильтр для списка владельцев: поиск по началу имени и фамилии и по городу без учёта регистра.

Делегирование методов между слоями​

Действие Delegate from… переносит метод из одного Spring-объекта в другой с нужными преобразованиями: например, вызывает метод репозитория в сервисе или контроллере и сразу превращает результат в DTO.

Delegate methods: метод save из OwnerRepository становится POST-эндпоинтом контроллера

Тесты для контроллеров​

Действие Generate Spring Web Tests… создаёт тестовый класс для выбранных эндпоинтов. В диалоге задаются целевой класс, способ вызова — Mock MVC или Test REST Template — и значения параметров запроса.

Диалог Generate Spring Web Tests: источник OwnerRestController, цель OwnerRestControllerTest, слева отмечены методы getOne, delete, patch, update, create и getAll с метками HTTP-методов, справа имя метода и параметр запроса id со значением по умолчанию 0

Генерация тестов: по одному тестовому методу на каждый отмеченный эндпоинт.

Генерация Spring Web тестов: выбор эндпоинтов, тестового класса и контекста теста

Новый проект и конфигурации стартеров​

Проект создаётся через Файл → Новый → Проект… (File → New → Project…): в списке есть тип Spring Boot. Мастер создаёт пустое Maven-приложение. Стартеры добавляются после создания — действием Add Configuration в Amplicode Explorer. Вместе с зависимостью добавляется конфигурация: например, готовый класс настройки для Spring Security или совместная настройка MapStruct и Lombok.

Анимация: в Amplicode Explorer нового проекта awesome-application открыт список Add Configuration с разделами Spring Data, Security, Web, Kafka, Cloud и Testcontainers; выбран пункт Spring Security Configuration

Список Add Configuration: Spring Data JPA и MongoDB, DB Migration, Security, Web, Actuators, Kafka, Cloud Config, Testcontainers.

Add Configuration на примере Kafka: bootstrap-серверы, сериализаторы и group id задаются в диалоге

Spring Data, JPA и работа с базой​

Сущности и связи​

Сущности JPA, доменные объекты Spring Data JDBC и документы MongoDB создаются через диалоги. В OpenIDE Pro атрибуты добавляются и в существующие объекты — из палитры Amplicode Designer: базовый тип, ассоциация, @Embedded, @ElementCollection, перечисление, идентификатор. Там же — индексы, именованные запросы, обработчики жизненного цикла и утилиты equals(), hashCode() и toString().

Создание JPA-сущности и её атрибутов через диалоги Amplicode

Связи «один ко многим» и «многие ко многим» можно задать по-разному: одно- или двунаправленно, через List или Set, через @JoinColumn или @JoinTable. Варианты по-разному влияют на производительность, и диалог New Association Attribute предупреждает о неэффективном маппинге до того, как он попадёт в код.

Диалог New Association Attribute: кардинальность, каскады, тип коллекции и предупреждение о неэффективном маппинге

Ещё два действия для модели (Pro):

  • JPA-сущность из DTO. При подходе API-first готовый DTO превращается в сущность вместе с ассоциативными атрибутами.
  • Extract to MappedSuperclass. Общие атрибуты и методы выносятся в родительский класс с @MappedSuperclass.

Репозитории и запросы​

Метод Spring Data можно создать там, где он понадобился: наберите имя в месте вызова, и метод с нужной сигнатурой появится в репозитории. Автодополнение подсказывает атрибуты сущности и ключевые слова запроса. Работает для JPA, JDBC и MongoDB.

Метод findByFirstNameAndLastName набирается в контроллере и создаётся в репозитории через диалог Create Repository Method

В OpenIDE Pro derived- и @Query-методы собираются и через палитру Amplicode Designer: поиск одной записи или коллекции, подсчёт, проверка существования, удаление, обновление. Условия запроса задаются таблицей.

Палитра Amplicode Designer в репозитории: метод поиска собирается в диалоге Create Find Collection Method

Когда имя derived-метода перестаёт помещаться на экране, действия Extract JPQL Query и Extract JPQL Query and configure… переносят запрос в @Query на JPQL. Второе действие заодно предлагает сократить имя метода.

Интерфейс PostRepository: у метода с длинным именем findAllByAuthor_CreatedByAndPublishedAtBetweenAndTextGreaterThanEqual открыт список контекстных действий, выделены Extract JPQL Query and configure и Extract JPQL Query

Контекстные действия для derived-метода: запрос переносится в аннотацию @Query.

Extract JPQL Query: derived-метод превращается в метод с коротким именем и запросом на JPQL

В проектах на Spring Boot 3 и новее над методами репозиториев показывается запрос, который выполнится в рантайме: JPQL для Spring Data JPA и SQL для Spring Data JDBC. Запрос берётся из AOT-метаданных. Щелчок по подсказке предлагает вставить запрос в @Query или задать Entity Graph. Значки на полях ведут от интерфейса репозитория к сгенерированной AOT-реализации и обратно.

Интерфейс InventoryRepository: над методами findByProductAndCity и findByProduct серым показаны JPQL-запросы; открыто меню Query с пунктами Inline JPQL Query, Inline JPQL Query and configure и Define an entity graph; справа pom.xml с целью process-aot

Запрос из AOT-метаданных над методом репозитория и действия с ним.

Аудит (Pro). Поддерживаются стандартные аннотации аудита Spring Data. IDE предупреждает, если не подключена нужная конфигурация, и генерирует реализацию AuditorAware.

DTO и MapStruct​

Действие Create DTO создаёт DTO из доменного объекта — JPA-сущности, документа MongoDB или Elasticsearch. DTO может быть классом, Java Record или интерфейсом. В диалоге отмечаются нужные поля, включая вложенные связи: для связи выбирается новый класс, вложенный класс, существующий DTO или плоский набор полей.

Диалог New DTO для сущности Owner: класс OwnerDto, флажки Java Record, All args constructor, equals() and hashCode(), toString(), Mutable; в списке полей отмечены id, firstName, lastName, address, city и telephone, связь pets не отмечена

Создание DTO: набор полей и вид класса выбираются в одном диалоге.

Create DTO: вложенная связь visits оформляется отдельным вложенным классом VisitDto

Маппер создаётся из пары «сущность → DTO». На выбор — MapStruct, ModelMapper или собственный метод преобразования. DTO и маппер можно создать и прямо в месте использования, через автодополнение.

Диалог Map Owner To: переключатель MapStruct, ModelMapper или Custom mapper method, поля Source type, Target type и MapStruct interface, выбор между Use stream().map() и Create mapper method for collection

Настройка преобразования сущности в DTO: способ маппинга и интерфейс MapStruct.

DTO и метод MapStruct-маппера создаются на лету в коде контроллера

При переименовании поля сущности предлагается рефакторинг, который переименует и поле связанного DTO: иначе маппинг ломается молча.

Синхронизация DTO и сущности: новый атрибут сущности добавляется в связанные DTO

Reverse Engineering: сущности из базы​

Обратное проектирование: выбираете таблицы, представления и отдельные колонки — получаете JPA-сущности или доменные объекты Spring Data JDBC с учётом ограничений и индексов. Диалог открывается из контекстного меню пакета: Новый → JPA Entities from DB (New → JPA Entities from DB).

Диалог Entities from DB: подключение dataSource к PostgreSQL, слева дерево Mapped Relations, Tables и Views с отмеченной таблицей posts, справа класс Post, стратегия идентификатора IDENTITY и список колонок с именами атрибутов и Java-типами, колонка author_id сопоставлена связи ManyToOne с User

Таблица posts превращается в сущность Post: внешний ключ author_id распознан как связь ManyToOne.

JPA Entities from DB: из таблиц базы получаются сущности с атрибутами, связями и индексами

Мелочи, на которых обычно ломается маппинг, придуманный «на глазок»:

  • связующая таблица из двух внешних ключей распознаётся как @ManyToMany; кардинальность связей определяется и там, где в базе она явно не задана. Если первичный ключ таблицы одновременно внешний, он остаётся обычным полем с @Id, а @MapsId получает связь с родительской сущностью — так требует JPA;
  • представление получает @Immutable, только геттеры и protected-конструктор без аргументов, то есть создать такую сущность в бизнес-логике нельзя. Первичного ключа у представления нет, поэтому идентификатор выбираете вы;
  • для SQL-типа без точного соответствия в Java тип не выдумывается: вместо Object генерируется //todo с квик-фиксами, а выбранный вами вариант запоминается на будущее;
  • новые колонки базы добавляются в уже существующую сущность, не затирая написанное руками.

Диалог Entities from DB для уже существующей сущности User: в разделе Mapped Relations выбрана таблица users, в списке Columns отмечены новые колонки email и last_activity с типами String и Instant

Новые колонки email и last_activity добавляются в существующую сущность User.

Атрибуты для новых колонок базы добавляются в существующую сущность через пункт From DB

Диалог Entities from DB для представления: в дереве отмечено user_statistics в разделе Views, класс UserStatistic, вместо стратегии идентификатора ссылка Select columns to be used as primary key, колонки user_id и number_of_posts

Сущность для представления user_statistics: колонки для идентификатора выбираются вручную.

Определение ассоциаций при обратном проектировании, включая связи через связующую таблицу

Сверка сущностей со схемой и SQL в коде​

В OpenIDE Pro 2026.2 и новее с DB-клиентом поля JPA- и Spring Data JDBC-сущностей сверяются с таблицами подключённой базы. Учитывается стратегия именования: поле createdAt сопоставляется с колонкой created_at.

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

Без подключения к базе предупреждения не показываются. Нативные запросы в @Query и SQL внутри changelog Liquibase получают подсветку по диалекту, автодополнение по реальным таблицам и колонкам и проверку имён. Запрос из @Query открывается или выполняется в консоли DB-клиента.

Миграции: Liquibase и Flyway​

Миграция генерируется как разница между двумя состояниями схемы — источником и целью.

  • Источник — JPA-модель проекта или живая база.
  • Цель — другая база или JSON-снапшот модели, снятый раньше.

Снапшот закрывает случай, когда базы нужного состояния просто нет: снимаете снапшот на main, переключаетесь на свою ветку, получаете changelog ровно по её изменениям. Хранить дамп на каждый релиз для этого не нужно.

Диалог Diff Database Changelog: слева Source — актуальное состояние модели с выбором DB или Model, persistence unit Default и Scope; справа Target — предыдущее состояние с выбором DB или Snapshot и подключением blog к PostgreSQL

Источник и цель сравнения: JPA-модель против базы данных.

Формат — changelog Liquibase или версионированная миграция Flyway. Система версионирования подключается к проекту в диалоге DB Migration Settings: Amplicode добавляет зависимости и свойства, создаёт каталог для скриптов и главный changelog. Отдельным действием генерируется скрипт инициализации схемы с нуля — по модели или по существующей базе.

Диалог DB Migration Settings: выбор None, JPA Built-in, Liquibase или Flyway, источник свойств application.properties, Hibernate DDL Auto в значении validate, каталог db, флажок Create init db scripts, тип источника DB и подключение blog

Подключение системы версионирования и генерация скрипта инициализации по существующей базе.

Скрипт инициализации базы: changelog Liquibase со всеми таблицами и ограничениями модели

Миграция по диффу запускается из Amplicode Explorer: раздел DB Versioning → Liquibase Diff Changelog или Flyway Versioned Migration. В открытый changelog изменения дописываются действием Liquibase Diff Changes из меню Код → Сгенерировать… (Code → Generate…).

Liquibase Diff Changelog: изменения JPA-модели превращаются в changeSet-ы в окне Changelog Preview

Окно предпросмотра​

Результат открывается в окне предпросмотра, и здесь разница с генерацией «по тексту» заметнее всего:

  • каждое изменение размечено по уровню риска: добавить колонку — не то же самое, что удалить её или сменить тип. Удаление колонки выделено красным, добавление ограничения NOT NULL — жёлтым;
  • пара «удалить старое, добавить новое», которая получается при переименовании, сводится в один rename одним действием: иначе данные в колонке теряются;
  • изменения раскладываются по нескольким changelog-файлам действием Move to Another Changelog — например, чтобы отделить то, что можно применять автоматически, от того, что стоит применять руками;
  • изменения, которые редко нужны в базе, — например, удаление индекса — попадают в секцию Ignored. Скрипт перетаскивается в секцию и из неё, список игнорируемых изменений задаётся в настройках.

Окно Changelog Preview: слева дерево changeSet-ов — createTable и addForeignKeyConstraint зелёным, users#fax dropColumn красным, users#email addNotNullConstraint жёлтым с лампочкой, в секции Ignored dropIndex; справа каталог, имя файла, главный changelog и XML будущего файла

Окно предпросмотра: безопасные изменения зелёные, удаление колонки красное, NOT NULL жёлтое.

Предпросмотр changelog: удаление и добавление колонки объединяются в renameColumn

Окно Changelog Preview: выделены changeSet-ы с dropColumn и addNotNullConstraint для таблицы users, над деревом подсказка кнопки Move to Another Changelog, справа XML выбранного changeSet с dropColumn для колонки fax

Изменения таблицы users переносятся в отдельный changelog.

Лампочка у изменения означает, что скрипт можно улучшить. Для ограничения NOT NULL на заполненной таблице предлагается значение, которым заменятся существующие NULL.

Окно Changelog Preview с двумя changelog-файлами: для addNotNullConstraint колонки email включён флажок Update NULL values и задано значение n/a, в XML появился атрибут defaultNullValue

Значение для существующих NULL перед добавлением ограничения NOT NULL.

Для Flyway окно то же, вместо changeSet-ов — SQL версионированной миграции. Файл сохраняется в проект, во временный файл или копируется в буфер обмена.

Окно Flyway Versioned Migration Preview: слева изменения миграции V2 — Create Table, Add Foreign Key Constraint, Drop Column красным и Add Not Null Constraint жёлтым, секция Ignored с Drop Index; справа каталог db/migration, имя файла и SQL с CREATE TABLE и ALTER TABLE

Предпросмотр версионированной миграции Flyway.

Предпросмотр миграции Flyway: переименование колонки одной командой ALTER TABLE RENAME COLUMN

Генерация по диффу требует подключения к базе. См. DB-клиент. Применить changelog к базе без настройки плагина Maven или Gradle помогает действие Liquibase Update.

Отдельные выражения​

Одно изменение — колонку, первичный или внешний ключ, ограничение уникальности — можно добавить в changelog или миграцию через палитру Amplicode Designer, не вспоминая синтаксис. Подсказки с действиями показываются и прямо в .sql- и .xml-файлах. Эта часть доступна и в OpenIDE.

Добавление ограничения уникальности в changelog Liquibase через палитру Amplicode Designer

Spring Security​

Если в проекте настроен Spring Security, рядом с каждым эндпоинтом стоит значок замка: открытый — эндпоинт доступен всем, закрытый — нужна аутентификация или роль. В OpenIDE Pro щелчок по замку открывает правило в конфигурации и диалог Authorize Requests, где меняются шаблон пути, HTTP-метод и требуемые роли. Роли приложения собраны в узле Security Roles панели Amplicode Explorer.

Замок у эндпоинта: переход к правилу в конфигурации Spring Security и правка доступа в диалоге Authorize Requests

Конфигурация добавляется из Amplicode Explorer: Add Configuration → Spring Security Configuration. В диалоге выбирается способ аутентификации и его параметры: форма входа, выход, обработка отказа в доступе, remember me, управление сессиями, хранилище пользователей — в памяти, JDBC, JPA или собственное.

Add Configuration → Spring Security Configuration: класс конфигурации с цепочкой фильтров и пользователями в памяти

SecurityFilterChain генерируется для пяти способов аутентификации:

  • HTTP session authentication;
  • JWT authentication;
  • OAuth 2.0 / OIDC Authentication;
  • Spring Authorization Server;
  • LDAP authentication.
Генерация SecurityFilterChain: диалог New Security Configuration для HTTP Session Authentication и результат в коде

Kafka​

Постфиксное автодополнение send подбирает подходящий KafkaTemplate и инжектирует его в класс. В OpenIDE Pro Kafka подключается к приложению через Add Configuration, а KafkaTemplate, KafkaListenerContainerFactory и методы с @KafkaListener создаются из палитры Amplicode Designer.

Постфикс send: в слушателе событий появляется поле KafkaTemplate и вызов отправки сообщения
Kafka Configuration из Amplicode Explorer: класс KafkaConfiguration с фабриками продюсера и шаблоном KafkaTemplate

Docker и инфраструктура​

Amplicode работает поверх плагина Docker (маркетплейс): тот отвечает за контейнеры, образы и запуск Compose, а Amplicode добавляет знание о Spring-приложении.

Docker Compose​

В разделе Docker панели Amplicode Explorer видны Dockerfile и compose-файлы с их сервисами. Учитываются include и extends: сервисы подключённого файла показаны внутри того, который их использует. Сервисы запускаются, останавливаются и открываются в браузере прямо из панели; у запущенного сервиса в редакторе появляется ссылка с его адресом. Действие Down на узле compose-файла останавливает и удаляет только сервисы этого файла.

Проект spring-petclinic: в редакторе app-compose.yaml с директивой include для services.yaml, в Amplicode Explorer под services.yaml сервисы postgres и kafka, под app-compose.yaml — spring-petclinic и те же postgres и kafka, пришедшие через include

Сервисы из подключённого файла видны в дереве вместе с собственными сервисами compose-файла.

Запуск сервисов docker-compose из Amplicode Explorer и ссылка на адрес запущенного pgAdmin в редакторе

Свойства сервиса правятся в панели Amplicode Designer: образ, порты, тома, сеть, healthcheck, параметры конкретной технологии. Значения из .env-файла подставляются в соответствующие поля.

Файл compose.prod.yaml и панель Amplicode Designer для сервиса postgres: разделы PostgreSQL settings с Database name, User и Password, Volumes, Published ports, Networking и Healthcheck; стрелка показывает, что значения взяты из файла prod.env

Amplicode Designer читает параметры PostgreSQL из prod.env.

Правка сервиса Docker Compose в Amplicode Designer: healthcheck и сеть без поиска свойств в документации

В OpenIDE Pro сервисы создаются с нуля через диалоги, а для уже описанного стека предлагаются сопутствующие инструменты: pgAdmin для PostgreSQL, Kafka UI для Kafka. Подключение pgAdmin к базе настраивается автоматически.

Файл compose.dev.yaml: по значку лампочки открыт список Add Kafka-UI service и Add pgAdmin service; слева Amplicode Explorer с разделами Security Roles, Persistence, Endpoints, Kafka и Docker, в котором Dockerfile и три compose-файла

Рекомендованные сервисы для стека с PostgreSQL и Kafka.

Создание сервиса PostgreSQL в Docker Compose: база, пользователь, порты и healthcheck задаются в диалоге

Dockerfile​

Для Spring Boot приложения генерируется многоэтапный Dockerfile со слоями (Pro). Параметры генерации описаны в разделе Docker.

Spring Boot Application Dockerfile: сборка, извлечение слоёв и финальный образ

Kubernetes, Helm и Terraform​

  • Helm. Чарт запускается и останавливается из Amplicode Explorer; в Chart.yaml, values.yaml и шаблонах работает автодополнение. В OpenIDE Pro чарт для Spring Boot приложения создаётся целиком, к нему добавляются зависимости — Kafka, PostgreSQL, Keycloak, MariaDB, MongoDB, MySQL, Grafana, Prometheus — и ресурсы: ConfigMap, Secret, PersistentVolumeClaim. Статус релизов — поды, Deployment, StatefulSet — виден на дашборде.
  • Kubernetes. Переадресация портов настраивается из окна Сервисы (Services) без kubectl port-forward; локальный порт запоминается и переживает перезапуск чарта.
  • Terraform. Конфигурации видны в Amplicode Explorer, запускаются и останавливаются оттуда же. Через Amplicode Designer создаются ресурсы Yandex Cloud Managed Kubernetes и S3-хранилище, например Yandex Object Storage.
Создание Helm-чарта для Spring Boot приложения из раздела Kubernetes в Amplicode Explorer

Запуск и отладка​

Spring Boot приложение запускается и отлаживается как обычное Java-приложение: значком на полях у метода main или конфигурацией запуска. Общие приёмы — в разделе Java и Kotlin.

Проверка эндпоинтов​

Для эндпоинта из раздела Endpoints генерируется HTTP-запрос: URL, метод и заголовки подставляются из кода, дальше запрос живёт в репозитории как обычный файл. Генерация запроса от эндпоинта входит в OpenIDE Pro. См. HTTP-клиент Connekt.

Генерация HTTP-запросов от эндпоинтов контроллера в файл Connekt

SQL из логов приложения​

Когда в логах виден SQL-запрос (spring.jpa.show-sql=true), рядом с ним появляется ссылка Execute query: запрос выполняется из консоли IDE. Если включён уровень TRACE для logging.level.org.hibernate.orm.jdbc.bind, в запрос подставляются реальные значения параметров.

Ссылка Execute query у SQL-запроса Hibernate в консоли запуска и результат выполнения

Отладчик для Spring Reactive​

При отладке реактивного кода цепочки операторов показаны в стеке вызовов по именам: Flux.publish, Flux.transform, Flux.concatWith. Переходы между операторами читаются без разбора служебных кадров Reactor.

Окно Debug приложения на Spring Reactive: точка останова в методе map контроллера, в стеке кадры с метками Flux.publish, Flux.transform, Flux.concatWith, Flux.defer и Flux.fromIterable, служебные кадры свёрнуты; справа значения полей объекта Owner

Стек вызовов реактивной цепочки: кадры подписаны именами операторов.

Spring и AI-агенты​

Агенту можно передать структурированную модель проекта — бины, эндпоинты, сущности, миграции и связи между ними — вместо того чтобы он искал их поиском по файлам. Отдаёт её Spring MCP, а набор инструкций, по которым агент решает типовые задачи Spring, называется Spring Agent Toolkit.

Полный обзор Spring Agent Toolkit (6 минут, со звуком): смотреть видео.

Что агент получает через Spring MCP:

ГруппаДанные и действия
Проект и биныСтруктура проекта, модули, зависимости; поиск по контроллерам, сервисам, репозиториям и конфигурациям; граф инжекций; исходный код по полному имени класса, включая библиотечные
Persistence и миграцииJPA-сущности с полями, связями и стратегиями идентификаторов; DTO, мапперы и репозитории для каждой сущности; генерация миграций Flyway и Liquibase
REST и SecurityЭндпоинты с HTTP-методами, сигнатурами и настройками доступа; конфигурации Spring Security и список ролей
Конфигурация и инфраструктураЗначения свойств, профили, файлы конфигурации; Docker Compose, продюсеры и консьюмеры Kafka; тесты проекта

Три окна чата с AI-агентом в IDE: ответ на вопрос о доступных инструментах — работа с файлами, поиск, рефакторинг, затем специализированные инструменты Spring Boot (бины, эндпоинты, конфигурация, Security, профили, тесты), базы данных (сущности, репозитории, миграции) и инфраструктуры (Docker Compose, Kafka)

Агент перечисляет инструменты, которые получил от IDE: кроме файлов и поиска — бины, эндпоинты, сущности, миграции.

Разделение труда такое: структуру приложения агент берёт из Spring MCP, а задачи уровня кода — сущности, DTO, мапперы, контроллеры, конфигурацию Security — закрывают навыки. Существующие миграции агент видит через MCP и там же может сгенерировать новую по текущему состоянию модели. Окно предпросмотра с разметкой риска и обратное проектирование остаются действиями IDE: отдельного навыка для них в наборе нет.

Сервер включается в Настройки → Инструменты → Amplicode → MCP Server (Settings → Tools → Amplicode → MCP Server). Там же — автонастройка клиентов и страница Exposed Tools, где отдельные инструменты или целые группы отключаются без перезапуска IDE. Spring MCP входит в OpenIDE Pro. Установка навыков и подключение агентов — в разделе Spring Agent Toolkit.

Подробный обзор Spring Agent Toolkit от команды Amplicode (6 минут, со звуком)

Что есть в OpenIDE и что добавляет OpenIDE Pro​

ОбластьOpenIDEOpenIDE Pro добавляет
Навигация и конфигурацияAmplicode Explorer, Bean Navigation, инжекция бинов, автодополнение свойств, @Value по имени свойства, циклические зависимостиAdd Configuration, делегирование методов, Wrap properties into
Spring WebАвтодополнение и навигация по эндпоинтам в тестахCRUD REST-контроллер, отдельные CRUD-методы, Spring Web тесты, HTTP-запрос от эндпоинта
Spring Data и JPAАвтодополнение методов репозитория, создание доменных объектовDerived- и @Query-методы через Designer, Extract JPQL Query, аудит, сущности из DTO, Extract to MappedSuperclass, подсказки по ассоциациям, Reverse Engineering
DTO и мапперы—Create DTO, MapStruct-мапперы, синхронизация DTO и сущности
МиграцииОтдельные выражения Liquibase и FlywayСкрипт инициализации, миграция по диффу, окно предпросмотра
Spring SecurityЗначок доступности эндпоинтаКонфигурация, SecurityFilterChain, правка доступа по щелчку на значке
KafkaПостфикс send с инжекцией KafkaTemplateКонфигурация, KafkaTemplate, KafkaListenerContainerFactory, @KafkaListener
Docker и HelmПросмотр и правка compose-сервисов, запуск и остановка сервисов и чартов, автодополнение в HelmDockerfile, создание и рекомендации compose-сервисов, Helm-чарт с зависимостями и ресурсами, дашборд релизов
ОтладкаОтладчик для Spring Reactive—
AI-агенты—Spring MCP

Построчное сравнение — в разделе Сравнение редакций. Все возможности Pro можно попробовать 60 дней без регистрации: см. Пробный период и Купить OpenIDE Pro.

Частые вопросы​

Amplicode входит в OpenIDE Pro или его нужно покупать отдельно?​

Входит. В OpenIDE Pro встроен Amplicode PRO со всеми возможностями, отдельная подписка и установка не нужны. В пробном периоде Pro он работает без ввода своей лицензии. Если у вас уже есть подписка Amplicode и она активна в другой IDE, конфликта с OpenIDE Pro нет.

Что из Spring работает без OpenIDE Pro?​

Навигация, автодополнение и базовые инструменты: Amplicode Explorer, Bean Navigation, инжекция бинов, автодополнение в application.properties и application.yml, автодополнение методов Spring Data, значки доступности эндпоинтов. Генерация кода, миграции по диффу, обратное проектирование и Spring MCP — в Pro. Подробнее — в таблице выше.

Как создать проект Spring Boot? Есть ли Spring Initializr?​

Есть: в Файл → Новый → Проект… (File → New → Project…) выберите тип Spring Boot. Мастер создаёт Maven-проект, зависимости в диалоге не выбираются — добавьте их после создания через Add Configuration в Amplicode Explorer.

При создании проекта Spring Boot доступен только Maven. Как выбрать Gradle?​

Установите плагин init-spring из маркетплейса OpenIDE.

Можно ли отключить Amplicode, если проект не на Spring?​

Да, плагин отключается в Настройки → Плагины (Settings → Plugins). Учтите, что вместе с Amplicode поставляется HTTP-клиент Connekt, который полезен и вне Spring-проектов.

Amplicode Designer для docker-compose не отображается. Что делать?​

Скорее всего, некорректно построились индексы. Выполните Файл → Инвалидировать кэши… (File → Invalidate Caches…) и откройте проект заново.

Как снова открыть приветственную вкладку Spring Agent Toolkit?​

Нажмите Shift дважды, чтобы открыть Поиск везде (Search Everywhere), и наберите «Spring Agent Toolkit».

Что дальше​

  • Spring Agent Toolkit — навыки и Spring MCP для AI-агента.
  • HTTP-клиент Connekt — запросы к эндпоинтам приложения и сценарии.
  • DB-клиент — подключение к базе, SQL-консоль и данные.
  • Docker — контейнеры, образы и Compose из IDE.
  • Java и Kotlin — отладка, сборка и профилирование JVM.