Spring Hibernate Учебник

2. Создание проекта Spring Boot

Мы будем использовать один из самых популярных веб-инструментов для создания примера проекта на этом уроке и не будем делать это из командной строки, мы будем использовать Spring Initializr . Просто откройте ссылку в вашем браузере и изучите все вокруг. Для настройки нашего проекта мы использовали следующую конфигурацию:

Мы добавили три зависимости в этом инструменте:

• Web : это базовая зависимость Spring, которая собирает связанные с конфигурацией и основные аннотации в проекте.
• H2 : поскольку мы используем базу данных в памяти, эта зависимость обязательна.
• Данные JPA : мы будем использовать Spring Data JPA для нашего уровня доступа к данным.

Затем распакуйте загруженный zip-проект и импортируйте его в свою любимую среду IDE.

3. Maven Зависимости

Для начала нам нужно посмотреть, какие зависимости Maven были добавлены в наш проект инструментом, а какие нужны другие. У нас будет следующая зависимость от нашего файла pom.xml :

pom.xml

Найдите последние связанные с Spring зависимости здесь . Мы добавили зависимости, которые также необходимы для поиска в Hibernate.

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

Наконец, чтобы понять все JAR-файлы, которые добавляются в проект при добавлении этой зависимости, мы можем запустить простую команду Maven, которая позволяет нам видеть полное дерево зависимостей для проекта, когда мы добавляем в него некоторые зависимости. Вот команда, которую мы можем использовать:

Проверьте дерево зависимостей

Когда мы запустим эту команду, она покажет нам следующее дерево зависимостей:

Дерево зависимостей

Заметили что-то? Так много зависимостей было добавлено, просто добавив четыре зависимости в проект. Spring Boot собирает все связанные зависимости и ничего не оставляет для нас в этом вопросе. Самым большим преимуществом является то, что все эти зависимости гарантированно совместимы друг с другом.

4. Структура проекта

Прежде чем мы продолжим работу и начнем работать над кодом для проекта, давайте представим здесь структуру проекта, которая будет у нас после завершения добавления всего кода в проект:

Мы разделили проект на несколько пакетов, чтобы следовать принципу разделения интересов, а код оставался модульным.

Обратите внимание, что каталог indexpath был создан Hibernate для хранения индексов (обсуждается далее в уроке), и он не будет существовать при импорте проекта в вашу среду IDE.

5. Определение спящих диалектов

В файле application.properties мы определяем два свойства, которые используются Spring Data JPA, который присутствует в пути к классам проекта. Spring Boot использует Hibernate в качестве реализации JPA по умолчанию.

application.properties

Здесь spring.jpa.hibernate.ddl-auto свойство spring.jpa.hibernate.ddl-auto . Благодаря этому Spring Data автоматически создает таблицы базы данных на основе сущностей, которые мы определили в нашем проекте, а столбцы будут создаваться из полей сущностей. Поскольку мы установили свойство для update , всякий раз, когда мы обновляем поле в нашем классе Entity, оно автоматически обновляется в БД, как только мы повторно запускаем проект.

6. Определение сущности

Мы начнем с добавления в наш проект очень простой модели Person . Его определение будет очень стандартным, как:

Person.java

Для краткости мы опускаем стандартные методы получения и установки, но их необходимо создавать, поскольку Джексон использует их во время сериализации и десериализации объекта.

Аннотация @Entity помечает этот POJO как объект, который будет управляться API-интерфейсами Spring Data, а его поля будут обрабатываться как столбцы таблицы (если не помечены как временные), а @Field отмечают, что это поле должно быть проиндексировано Hibernate, чтобы мы могли Запустите запрос полнотекстового поиска по этим полям.

Наконец, мы добавили пользовательскую реализацию для метода toString() чтобы мы могли печатать связанные данные при тестировании нашего приложения.

7. Создание сервисного интерфейса

В этом разделе мы определим интерфейс службы, который будет выступать в качестве контракта для реализации и представлять все действия, которые наша служба должна поддерживать. Эти действия будут связаны с созданием нового пользователя и получением информации, связанной с объектами в базе данных.

Вот определение контракта, которое мы будем использовать:

PersonService.java

Обратите внимание, что в конце контракта также предусмотрено два метода для поддержки поиска в Hibernate.

8. Внедрение Сервиса

Мы будем использовать приведенное выше определение интерфейса для обеспечения его реализации, чтобы мы могли выполнять операции CRUD, связанные с Person мы определили ранее. Мы сделаем это здесь:

PersonServiceImpl.java

Мы просто использовали бин DAL для доступа к методам, которые мы определили выше. Мы также использовали @Transactional(readOnly = true) чтобы нам не нужно было открывать сеанс Hibernate, который необходим при выполнении некоторых операций записи, но, поскольку нам нужно только выполнить поиск, мы можем с уверенностью упомянуть свойство readOnly для true .

9. Определение репозитория JPA

Поскольку большинство операций выполняется самим репозиторием JPA, давайте определим это здесь:

PersonRepository.java

Хотя приведенное выше определение интерфейса пустое, у нас все же есть некоторые моменты, которые нам нужно понять:

• Аннотация @Repository помечает этот интерфейс как Spring Bean, который инициализируется при запуске приложения. С этой аннотацией Spring позаботится о том, чтобы корректно управлять бросками взаимодействия с базой данных
• Мы использовали Person в качестве параметра, чтобы показать, что этот интерфейс JPA будет управлять Person Entity
• Наконец, мы также передали тип данных Long в качестве параметра. Это означает, что сущность Person содержит уникальный идентификатор типа Long

10. Определение интерфейса уровня доступа к данным (DAL)

Хотя мы определили репозиторий JPA, который выполняет все операции CRUD, мы все равно будем создавать слой DAL, который определяет запросы для поиска в произвольном тексте Hibernate. Давайте посмотрим на контракт, который мы определяем:

PersonDAL.java

11. Реализация интерфейса DAL

В интерфейсе DAL, который мы определили, мы будем реализовывать два различных типа поиска в свободном тексте:

• Нечеткий поиск: Нечеткий поиск применим, когда мы хотим найти термины, которые находятся на расстоянии от поискового запроса. Чтобы понять разрыв, давайте рассмотрим пример. Термины Hibernate и Hibernat имеют пробел 1 из-за пропуска e в более позднем слове, термины Hibernate и Hibernawe также имеют пробел 1 как один символ в более поздней Hibernawe w может быть заменен для формирования прежней строки.
• Поиск с подстановочными знаками: они похожи на операторы SQL, которые имеют подходящую фразу. Как и соответствующие фразы для Hibernate могут быть Hiber , bernate и т. Д.

Давайте реализуем оба из них на нашем уровне DAL.

11.1 Определение нечеткого запроса

Мы начнем с реализации нечеткого поиска. Это очень интеллектуальный и сложный поиск, так как для этого требуется токенизация каждого термина, сохраненного в индексах базы данных. Узнайте больше о том, как Lucene делает это здесь .

Давайте реализуем этот поисковый запрос здесь:

Нечеткий запрос

Мы просто использовали расстояние редактирования 2. Это максимальный разрыв, который поддерживается Hibernate и движком Lucene.

11.2 Определение подстановочного запроса

Подстановочный запрос легко понять и реализовать. Это работает так же, как операторы SQL LIKE:

Подстановочный запрос

Мы применили * к передней и задней части термина, чтобы LIKE мог работать в обоих направлениях.

12. Построение поискового индекса в Hibernate

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

BuildSearchIndex.java

Хотя мы создали поисковый индекс в Hibernate, но где будут храниться индексированные данные. Мы настроим это дальше.

13. Хранение данных индекса

Поскольку Hibernate должен хранить данные индекса, чтобы ему не приходилось перестраивать их при каждом выполнении операции, мы предоставим Hibernate каталог файловой системы, в котором он может хранить эти данные:

application.properties

directory_provider просто предоставляет тип системы, в которой будут храниться данные, поскольку мы можем даже хранить данные индексации в облаке.

14. Создание Runner из командной строки

Теперь мы готовы запустить наш проект. Чтобы вставить данные образца в

DataJpaApp.java

15. Запуск проекта с Maven

С приложением maven легко запустить приложение, просто используйте следующую команду:

Запуск приложения

Как только мы запустим проект, мы увидим следующий результат:

Как и ожидалось, мы сначала создали несколько примеров данных и подтвердили их, вызвав вызов метода count() . Наконец, вызваны методы поиска для получения ожидаемых результатов.

16. Вывод

На этом уроке мы изучили, как мы можем использовать Hibernate для настройки API-интерфейсов Spring Data и как он может помочь нам автоматически создавать таблицы в нашей базе данных, просто определяя классы POJO для наших сущностей. Даже когда мы обновляем наши объекты, нам не нужно беспокоиться о внесении изменений в базу данных!

Мы также запустили примеры с поиском Hibernate, который наш движок Lucene использует для индексации, а Hibernate предоставляет нам полезную оболочку для функций Lucene.

17. Скачать исходный код

Это был пример со Spring Boot и Hibernate ORM Framework.