hibernate orm

Hibernate ORM — это мощное решение для объектно-реляционного сопоставления для Java, которое позволяет легко разрабатывать логику персистентности для приложений, библиотек и платформ.

Hibernate реализует JPA, стандартный API для объектно-реляционного постоянства в Java, но также предлагает обширный набор функций и API, выходящих за рамки спецификации.

Посетите Hibernate.org для получения дополнительной информации.

Непрерывная интеграция

Hibernate использует как Jenkins, так и GitHub Actions для своих нужд CI. Видеть

• Дженкинс Джобс

• Действия GitHub: задания

Сборка из исходников

Для сборки требуется минимум Java 11 и максимум Java 17.

Hibernate использует Gradle в качестве инструмента сборки. Если вы новичок в Gradle, см. раздел «Основы Gradle Primer» ниже.

Авторам следует прочитать Руководство для участников.

См. руководства по настройке IntelliJ или Eclipse в качестве среды разработки.

Градл Праймер

Инструмент сборки Gradle имеет потрясающую документацию. 2, в частности, которые необходимы:

• Руководство пользователя Gradle — это типичное руководство пользователя, в котором применяется тематический подход к описанию всех возможностей Gradle.

• Руководство по Gradle DSL уникально и отлично подходит для быстрого ознакомления с некоторыми аспектами Gradle.

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

Примечание

Проект определяет Gradle Wrapper. Остальная часть раздела предполагает выполнение через оболочку.

Выполнение задач

Gradle использует концепцию задач сборки (эквивалентных целям Ant или фазам/целям Maven). Список доступных задач можно получить через

 задачи градиента

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

1. cd в каталог этого модуля и выполните задачу

2. назовите «путь задачи». Например, чтобы запустить тесты модуля hibernate-core из корневого каталога, вы можете сказать gradle hibernate-core:test

Общие задачи

Общие задачи, которые вы можете использовать при создании Hibernate, включают:

• build — Собирает (jars) и тестирует этот проект.

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

• jar — генерирует jar-архив со всеми скомпилированными классами.

• test — запускает тесты

• PublishToMavenLocal — устанавливает jar проекта в локальный кэш Maven (он же ~/.m2/repository). Обратите внимание, что Gradle никогда не использует это, но это может быть полезно для тестирования вашей сборки с другими локальными сборками на основе Maven.

• Clean — Очищает каталог сборки.

Тестирование и базы данных

Тестирование конкретной базы данных можно выполнить двумя разными способами:

Использование «Плагина матричного тестирования» для Gradle.

Придет позже…

Использование «профилей»

Сборка Hibernate определяет несколько «профилей» тестирования базы данных в databases.gradle . Эти профили можно активировать по имени с помощью свойства сборки db , которое можно передать либо как системную опору JVM ( -D ), либо как свойство проекта Gradle ( -P ). В приведенных ниже примерах используется подход свойств проекта Gradle.

 gradle чистая сборка -Pdb=pgsql

Чтобы запустить тест из вашей IDE, вам необходимо убедиться, что расширение свойств происходит. Используйте следующую команду:

 gradle чистая компиляция -Pdb=pgsql

ПРИМЕЧАНИЕ. Если вы выполняете тесты с драйвером JDBC, который недоступен через Maven Central, обязательно добавьте эти драйверы в свой локальный кеш репозитория Maven (~/.m2/repository) или (лучше) добавьте его на личный сервер репозитория Maven.

Запуск тестов для конкретной базы данных из IDE с использованием «профилей».

Вы можете запустить любой тест для любой конкретной базы данных, настроенной в профиле databases.gradle .

Все, что вам нужно сделать, это запустить следующую команду:

 ./gradlew setDataBase -Pdb=pgsql

или вы можете использовать сокращенную версию:

 ./gradlew sDB -Pdb=pgsql

Вы можете сделать это из модуля, который вы хотите протестировать, или из корневой папки hibernate-orm .

После этого просто выберите любой тест из IDE и запустите его как обычно. Hibernate выберет конфигурацию базы данных из файла hibernate.properties , который был настроен задачей setDataBase Gradle.

Запуск тестовых баз данных локально в виде докер-контейнеров

Вам не обязательно устанавливать все базы данных локально, чтобы иметь возможность протестировать их, если у вас есть Docker. Скрипт docker_db.sh позволяет запустить предварительно настроенную базу данных, которую можно использовать для тестирования.

Все, что вам нужно сделать, это запустить следующую команду:

 ./docker_db.sh postgresql

если опустить аргумент, будет выведен список возможных вариантов.

Когда база данных запущена правильно, вы можете запускать тесты со специальными профилями с суффиксом _ci , например pgsql_ci для PostgreSQL. Используя системное свойство dbHost вы можете настроить IP-адрес вашего хоста докера.

Команда для запуска тестов может выглядеть следующим образом:

 ./gradlew test -Pdb=pgsql_ci "-DdbHost=192.168.99.100"

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

База данных	docker_db.sh	Команда Gradle
Н2	-	./gradlew test -Pdb=h2
HSQLDB	-	./gradlew test -Pdb=hsqldb
Апач Дерби	-	./gradlew test -Pdb=derby
MySQL	./docker_db.sh mysql	./gradlew test -Pdb=mysql_ci
МарияДБ	./docker_db.sh mariadb	./gradlew test -Pdb=mariadb_ci
PostgreSQL	./docker_db.sh postgresql	./gradlew test -Pdb=pgsql_ci
EnterpriseDB	./docker_db.sh edb	./gradlew test -Pdb=edb_ci
Оракул	./docker_db.sh oracle	./gradlew test -Pdb=oracle_ci
DB2	./docker_db.sh db2	./gradlew test -Pdb=db2_ci
SQL-сервер	./docker_db.sh mssql	./gradlew test -Pdb=mssql_ci
Sybase ASE (jTDS)	./docker_db.sh sybase	./gradlew test -Pdb=sybase_ci
Sybase ASE (jConnect)	./docker_db.sh sybase	./gradlew test -Pdb=sybase_jconn_ci
SAP Хана	./docker_db.sh hana	./gradlew test -Pdb=hana_ci
ТараканДБ	./docker_db.sh cockroachdb	./gradlew test -Pdb=cockroachdb
ТиБД	./docker_db.sh tidb	./gradlew test -Pdb=tidb
Информикс	./docker_db.sh informix	./gradlew test -Pdb=informix

Чтобы остановить контейнер, запущенный docker , используйте команду

 docker stop $container_name

ПРИМЕЧАНИЕ

Замените команду podman на docker если используете podman

Например, чтобы остановить контейнер mariadb

 docker stop mariadb