Hibernate ORM은 애플리케이션, 라이브러리 및 프레임워크에 객체 관계 매핑(ORM) 지원을 제공하는 라이브러리입니다.

또한 ORM의 표준 Java 사양인 JPA 사양의 구현도 제공합니다.

이것은 소스 코드의 저장소입니다: 추가 정보는 Hibernate.org를 참조하세요.

소스에서 빌드하기

빌드하려면 JAVA_HOME으로 Java 8 JDK가 필요합니다.

소스를 얻으려면 Git이 필요합니다.

Hibernate는 빌드 도구로 Gradle을 사용합니다. Gradle을 처음 사용하는 경우 아래 Gradle 입문서 섹션을 참조하세요.

기여자는 기여 가이드를 읽어야 합니다.

개발 환경 설정을 위한 IntelliJ 또는 Eclipse 가이드를 참조하세요.

Hibernate 소스 작업을 시작하려면 CONTRIBUTING.md의 시작하기 섹션을 확인하세요.

지속적 통합

Hibernate는 CI 요구 사항을 위해 Jenkins를 사용합니다. 프로젝트는 업스트림 저장소에 푸시될 때마다 지속적으로 빌드됩니다. 전체적으로 몇 가지 다른 작업이 있으며, 모두 http://ci.hibernate.org/view/ORM/에서 확인할 수 있습니다.

Gradle 입문서

이 섹션에서는 Gradle을 처음 접하는 개발자와 기여자가 빠르게 생산성을 높이기 위해 알아야 할 몇 가지 기본 사항을 설명합니다. Gradle 문서는 매우 잘 작성되어 있습니다. 특히 다음 두 가지가 필수적입니다:

Gradle 사용자 가이드는 Gradle의 모든 기능을 주제별로 설명하는 일반적인 사용자 가이드입니다.
Gradle DSL 가이드는 Gradle의 특정 측면에 대해 빠르게 익숙해질 수 있는 독특하고 훌륭한 가이드입니다.

Gradle Wrapper 사용하기

Gradle을 사용하지 않고 설치하고 싶지 않은 기여자를 위해 Gradle은 wrapper라는 매우 멋진 기능을 제공합니다. 이를 통해 이전에 Gradle 배포판을 설치하지 않고도 제로 구성 방식으로 Gradle 빌드를 실행할 수 있습니다. Hibernate는 여러분을 위해 Gradle wrapper를 구성합니다. wrapper를 사용하고 Gradle을 설치하지 않으려면(또는 이전 빌드에 의도된 Gradle 버전을 사용하려면) 다음 논의에서 gradle(또는 gradle.bat) 대신 gradlew(또는 gradlew.bat) 명령을 사용하면 됩니다. gradlew는 프로젝트 루트 디렉토리에서만 사용할 수 있으므로 작업 디렉토리에 따라 gradlew 경로를 조정해야 할 수도 있습니다.

예제에서는 gradle 구문을 사용하지만, wrapper를 사용하려면 gradle 대신 gradlew(적절히 상대 경로)로 바꾸면 됩니다.

gradlew를 사용하는 또 다른 이유는 빌드가 정의된 정확한 Gradle 버전을 사용하기 때문입니다.

작업 실행하기

Gradle은 빌드 작업(Ant 대상 또는 Maven 단계/목표와 동일)의 개념을 사용합니다. 사용 가능한 작업 목록은 다음을 통해 확인할 수 있습니다.

gradle tasks

모든 모듈에서 작업을 실행하려면 루트 디렉토리에서 해당 작업을 수행하면 됩니다. Gradle은 각 하위 프로젝트를 방문하여 하위 프로젝트가 정의한 경우 해당 작업을 실행합니다. 특정 모듈에서 작업을 실행하려면 다음 중 하나를 수행할 수 있습니다.

해당 모듈 디렉토리로 cd하여 작업을 실행합니다.
"작업 경로"를 지정합니다. 예를 들어, 루트 디렉토리에서 hibernate-core 모듈의 테스트를 실행하려면 gradle hibernate-core:test라고 입력할 수 있습니다.

일반적인 Java 관련 작업

build - 이 프로젝트를 어셈블(jar)하고 테스트합니다.
buildDependents - 이 프로젝트와 이에 의존하는 모든 프로젝트를 어셈블하고 테스트합니다. 즉, hibernate-core에서 실행하면 Gradle이 hibernate-core뿐만 아니라 hibernate-envers도 어셈블하고 테스트합니다(envers가 core에 의존하기 때문).
classes - 메인 클래스를 컴파일합니다.
testClasses - 테스트 클래스를 컴파일합니다.
compile (Hibernate 추가) - 메인 및 테스트의 리소스 스테이징을 포함한 모든 컴파일 작업을 수행합니다.
jar - 컴파일된 모든 클래스로 jar 아카이브를 생성합니다.
test - 테스트를 실행합니다.
publish - Maven deploy와 유사합니다.
publishToMavenLocal - 프로젝트 jar를 로컬 Maven 캐시(~/.m2/repository)에 설치합니다. Gradle은 이것을 사용하지 않지만, 다른 로컬 Maven 기반 빌드와 함께 빌드를 테스트하는 데 유용할 수 있습니다.
eclipse - Eclipse 프로젝트를 생성합니다.
idea - IntelliJ/IDEA 프로젝트를 생성합니다(권장 방법은 IntelliJ의 Gradle 가져오기를 사용하는 것입니다).
clean - 빌드 디렉토리를 정리합니다.

테스트 및 데이터베이스

특정 데이터베이스에 대한 테스트는 두 가지 방법으로 수행할 수 있습니다.

Gradle용 "Matrix Testing Plugin" 사용하기.

준비 중...

"프로파일" 사용하기

Hibernate 빌드는 databases.gradle에 여러 데이터베이스 테스트 "프로파일"을 정의합니다. 이러한 프로파일은 db 빌드 속성을 사용하여 이름으로 활성화할 수 있으며, 이 속성은 JVM 시스템 속성(-D) 또는 Gradle 프로젝트 속성(-P)으로 전달할 수 있습니다. 아래 예제에서는 Gradle 프로젝트 속성 방식을 사용합니다.

gradle clean build -Pdb=pgsql

IDE에서 테스트를 실행하려면 속성 확장이 발생하도록 해야 합니다. 다음 명령을 사용하세요.

gradle clean compile -Pdb=pgsql

참고: Maven 중앙 저장소에서 사용할 수 없는 JDBC 드라이버에 대해 테스트를 실행하는 경우, 해당 드라이버를 로컬 Maven 저장소 캐시(~/.m2/repository)에 추가하거나 (더 좋은 방법) 개인 Maven 저장소 서버에 추가하세요.

IDE에서 "프로파일"을 사용하여 데이터베이스별 테스트 실행하기

databases.gradle 프로파일에 구성된 특정 데이터베이스에서 어떤 테스트든 실행할 수 있습니다.

다음 명령을 실행하기만 하면 됩니다.

gradlew setDataBase -Pdb=pgsql

또는 단축 버전을 사용할 수 있습니다:

gradlew sDB -Pdb=pgsql

테스트하려는 모듈에서 또는 hibernate-orm 루트 폴더에서 이 작업을 수행할 수 있습니다.

그런 다음 IDE에서 아무 테스트나 선택하여 평소처럼 실행하면 됩니다. Hibernate는 setDataBase Gradle 작업이 설정한 hibernate.properties 파일에서 데이터베이스 구성을 가져옵니다.

hibernate-orm

인기