Что нового в JPA Buddy 3.0

Мы выпустили JPA Buddy 3.0! В этом релизе наконец-то появилась генерация скриптов для Flyway, поддержка Kotlin, а также другие улучшения и исправления. Посмотрим на эти нововведения подробнее.

Для тех, кто не слышал о JPA Buddy: это плагин, который упрощает работу с JPA, Hibernate, Spring Data JPA, Liquibase и подобными технологиями. Подробнее о нем можно почитать в этой статье.

Flyway

Нас часто просили добавить поддержку Flyway, и в этой версии она появилась. Теперь JPA Buddy умеет генерировать скрипты миграции Flyway, сравнивая:

• JPA-сущности и базу данных

• Две базы данных — текущую и устаревшую

Генерация скриптов путем сравнения модели данных с целевой БД выглядит вот так:

JPA Buddy также поможет вам с именованием файлов миграции. Мы добавили целый ряд настроек, который позволяет максимально гибко указать шаблон именования файлов: префикс миграции, шаблон версии, разделитель и описание. Больше об именовании файла миграции можно узнать в документации Flyway (англ).

Шаблон версии можно выбрать из ряда часто используемых, или же определите свой собственный. Для этого есть следующие макросы:

• #date ([format]) – текущая системная дата в указанном SimpleDateFormat

• #increment ([start], [step], [decimalFormat]) – число, используемое для сохранения уникальности имени

• semVer – семантическая версия проекта

Больше информации о доступных переменных и макросах есть на странице нашего плагина.

Kotlin (альфа-версия)

JPA Buddy наконец–то поддерживает Kotlin! За исключением нескольких инспекций, поддерживается та же функциональность, что и для Java: визуальные дизайнеры для сущностей и репозиториев, генерация equals()/hashCode()/toString(), поддержка JPA конвертеров и Hibernate Custom Types, отображение сущностей в дереве JPA Structure и многое другое.

Например, так можно создать атрибут в Kotlin-сущности с помощью JPA Palette и JPA Inspector:

Для репозиториев поддерживаются как обычные методы, так и методы @Query:

Что важно отметить: Kotlin – очень гибкий язык программирования. Код, который делает одно и то же, можно написать совершенно по-разному. Поэтому программировать на Kotlin – одно удовольствие, а вот разрабатывать для него инструменты не так просто. Мы постарались предусмотреть самые распространенные варианты использования Kotlin в JPA-сущностях и Spring Data репозиториях, но некоторые могли упустить и не протестировать.

Если вы пишете на Kotlin, пожалуйста, сообщайте нам обо всех возникающих ошибках и проблемах. Улучшение работы с Kotlin — наш главный приоритет в следующих минорных релизах.

Асинхронные методы в Spring Data репозитория

Диалоги генерации запросов и JPA Inspector теперь поддерживают создание асинхронных методов в Spring Data репозиториях:

Односторонний OneToMany с JoinColumn

В JPA есть поддержка односторонних ассоциаций OneToMany, то есть ассоциаций, которые определены только в одной из сущностей. Один из способов их задать — аннотировать ассоциацию с помощью @JoinColumn:

@Entity
public class Customer {

   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   @Column(name = "ID", nullable = false)
   private Long id;

   @OneToMany
   @JoinColumn(name = "CUST_ID") // this column is located in the ORDER_ table
   private Collection<Order> orders = new ArrayList<>();
}

Столбец «CUST_ID» создается в таблице «ORDER_», при этом в сущности Order соответствующего атрибута нет:

@Entity
@Table(name = "ORDER_")
public class Order {
   @Id
   @GeneratedValue(strategy = GenerationType.IDENTITY)
   @Column(name = "ID", nullable = false)
   private Long id;

   // NOTHING about Customer
}

Теперь JPA Buddy поддерживает создание таких ассоциаций. Для этого в диалоговом окне создания ассоциации нужно установить флажок «Owning side»:

Создание отчетов об ошибках с помощью Sentry

Баги и ошибки неизбежны в любом программном обеспечении, и средства разработки — не исключение. Мы делаем все возможное, чтобы выявить и исправить как можно больше багов, но некоторые из них всё же попадают в релиз. Если вы столкнетесь с ними, пожалуйста, сообщите нам об этом через форму на сайте или в Discord. Это поможет нам сделать JPA Buddy лучше.

Кстати, мы добавили механизм отправки отчетов об исключениях напрямую. Теперь это можно сделать в пару кликов:

Заключение

JPA Buddy продолжает развиваться, в этой статье мы рассмотрели лишь некоторые из улучшений, реализованных в версии 3.0. Многие из реализованных функций были предложены нашим сообществом, и мы призываем вас присоединиться к нам в Discord, чтобы делиться своими идеями и отзывами.