В этом разделе мы напишем приложение Spring Data JPA, которое сохраняет запись в базе данных и затем извлекает ее. Для этого добавим зависимости Spring со стороны конфигурации Apache Maven.

Листинг 9. Зависимости Maven от Spring

Модуль spring-data-jpa обеспечивает поддержку репозитория для JPA и содержит транзитивные зависимости от других модулей, которые нам понадобятся, например spring-core и spring-context.

Кроме того, нам нужна зависимость spring-test для запуска тестов с помощью расширения Spring.

Стандартный файл конфигурации для Spring Data JPA — это Java класс для создания и настройки бинов, необходимых для Spring Data. Конфигурацию можно сделать с помощью XML файла или Java кода. Мы используем второй вариант. Создадим следующий файл конфигурации для персистентного приложения:

Листинг 10. Класс SpringDataConfiguration

• Аннотация @EnableJpaRepositories будет сканировать класс конфигурации для репозиториев Spring Data #1.
• Создаем бин источника данных #2 и указываем свойства JDBC - драйвер #3, URL базы данных #4, имя пользователя #5 и пароль #6 для доступа.
• Далее создаем бин диспетчера транзакций на основе фабрики диспетчеров классов-сущностей #7. Каждое взаимодействие с базой данных должно происходить в пределах транзакции, и поэтому для Spring Data нужен бин диспетчера транзакций.
• Создаем бин адаптера вендора JPA, который необходим для JPA, чтобы взаимодействовать с Hibernate #8. Настраиваем этот адаптер вендора для доступа к базе данных MySQL #9.
• Мы создаем объект, принадлежащий классу LocalContainerEntityManagerFactoryBean – это бин, который производит EntityManagerFactory в соответствии со контрактом начальной загрузки стандартного контейнера JPA #10.
• Настраиваем источник данных #11, адаптер вендора #12 и пакеты сканирования для классов сущностей #13. As the Item entity is located in cscs23.orm, we set this package to be scanned.
• Spring Data JPA обеспечивает поддержку для уровней доступа к данным на основе JPA за счет уменьшения объема стандартного кода и создания реализаций для интерфейсов репозитория. Нам нужно только определить интерфейс нашего собственного репозитория для расширения интерфейсов Spring Data.

Листинг 11. Интерфейс ItemRepository



Интерфейс ItemRepository расширяет CrudRepository<Item, Long>. Это репозиторий сущностей Item с идентификатором Long. Помните, что класс Item имеет поле id с аннотацией @Id of type Long. Мы можем напрямую вызывать методы save, findAll или findById, унаследованные из CrudRepository, и можем использовать их без дополнительной информации для выполнения операций с базой данных.

Для дополнительных операций можно использовать интерфейс JpaRepository, который, в свою очередь, расширяет интерфейс CrudRepository. Он идет с дополнительными методами, включая в данном случае методы, которые позволяют выполнять разбиение на страницы, сортировку или пакетные операции.

Spring Data JPA использует шаблон proxy для поддержки механизма взаимодействия с базой данных. Целью proxy является замена другого объекта. Spring Data JPA создаст класс proxy, реализующий интерфейс ItemRepository, а также создаст его методы (рис. 1). Этот класс proxy будет определять все методы, унаследованные от CrudRepository, в том числе save, findAll или findById. Программисту больше не придется тратить время на написание логики этих методов — их реализация осуществляется со стороны Spring Data JPA. Это работает в духе фреймфорков и, в частности, Spring — происходит инверсия контроля, рабочий поток уже включен, обеспечиваются точки перехвата, которые программист должен заполнить, сосредоточившись на бизнес-логике.

Сохраняем запись Item в базу данных, используя Spring Data JPA.

Листинг 12. Класс ItemSpringDataJPATest





Рис. 1 Класс Proxy в Spring Data JPA реализует интерфейс ItemRepository

• Расширяем тест, используя SpringExtension #1. Это расширение используется для интеграции контекста тестирования Spring с тестированием JUnit 5 Jupiter.
• Контекст тестирования Spring настраивается с помощью бинов, определенных в ранее представленном классе SpringDataConfiguration #2.
• Бин ItemRepository внедряется с помощью Spring через auto-wiring #3. Это возможно, поскольку пакет cscs23.orm.repositories, в котором находится ItemRepository, используется в качестве аргумента аннотации @EnableJpaRepositories в листинге 10.
• Если мы хотим проверить и вызвать itemRepository.getClass(), то увидим, что это что-то вроде com.sun.proxy.$Proxy41 – proxy, сгенерированный Spring Data JPA, как показано на Рис. 1.
• Создаем новый экземпляр класса Item и устанавливаем его свойство info #4.
• Сохраняем объект item #5. Метод save унаследован от интерфейса CrudRepository, и его тело будет сгенерировано Spring Data JPA при создании класса proxy. Он просто сохранить сущность Item в базу данных.
• Мы опять имеет все преимущества работы с JPA или Hibernate: нет кода SQL и не нужен JDBC; нет операций CRUD внутри кода Java, только классы, объекты и методы; переносимость на каждый диалект SQL обеспечивается ORM.
• Кроме того, тест Spring Data JPA намного короче, чем тесты с использованием интерфейса JPA или Hibernate. Это возможно потому, что стандартный код был удален и больше нет необходимости явного создания объектов или явного контроля транзакции. Благодаря внедрению объекта из репозитория генерируются методы класса proxy.  Основная нагрузка теперь на стороне конфигурации, но ее необходимо делать только один раз для каждого приложения.