7.8. Hibernate 변경

이 섹션에서는 Hibernate ORM 버전 5.3에서 5.4로 마이그레이션할 때 필요한 변경 사항을 중점적으로 설명합니다. Hibernate ORM 5.3과 Hibernate ORM 5.4 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 5.4 마이그레이션 가이드를 참조하십시오.

알려진 변경 사항

다음은 Hibernate ORM 버전 5.3에서 5.4로 마이그레이션할 때의 몇 가지 변경 사항에 대해 설명합니다.

이 섹션에서는 Hibernate ORM 버전 5.4에서 5.5로 마이그레이션할 때 필요한 변경 사항을 중점적으로 설명합니다. Hibernate ORM 5.4와 Hibernate ORM 5.5 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 5.5 마이그레이션 가이드를 참조하십시오.

알려진 변경 사항

Hibernate ORM 5.5 버전은 5.4 유지 관리 릴리스에 적용된 모든 버그 수정을 포함하고 Jakarta 지속성 API에 대한 지원을 도입하므로 Hibernate ORM 5.4와 유사합니다.

이 섹션에서는 Hibernate ORM 버전 5.5에서 5.6로 마이그레이션할 때 필요한 변경 사항을 중점적으로 설명합니다. Hibernate ORM 5.5 및 Hibernate ORM 5.6 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 5.6 마이그레이션 가이드를 참조하십시오.

더 이상 사용되지 않는 기능

Hibernate 5.6 버전은 이전 Hibernate 5.5 버전과 매우 유사하며, 이전 Hibernate 릴리스에서 더 이상 사용되지 않는 일부 기능은 제거되지 않습니다.

이 섹션에서는 Hibernate ORM 버전 5.6에서 6.0으로 마이그레이션할 때 필요한 변경 사항을 설명합니다. Hibernate ORM 5.6과 Hibernate ORM 6.0 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 6.0 마이그레이션 가이드를 참조하십시오.

Hibernate 6.0 릴리스에는 다음과 같은 변경 사항이 포함되어 있습니다.

이러한 기능에 대한 자세한 내용은 Hibernate ORM 6.0 마이그레이션 가이드를 참조하십시오.

Hibernate 6.0 릴리스에는 다음과 같이 나열된 이전 Hibernate 릴리스에서 많은 기능 제거 기능이 포함되어 있습니다.

Hibernate 6.0에서 제거된 기능에 대한 자세한 내용은 Hibernate ORM 6.0 마이그레이션 가이드를 참조하십시오.

이 섹션에서는 Hibernate ORM 버전 6.0에서 6.1으로 마이그레이션할 때 필요한 변경 사항을 설명합니다. Hibernate ORM 6.0과 Hibernate ORM 6.1 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 6.1 마이그레이션 가이드를 참조하십시오.

Hibernate 6.1 릴리스에는 다음과 같은 변경 사항이 포함되어 있습니다.

Hibernate 6.1에 포함된 기능에 대한 자세한 내용은 Hibernate ORM 6.1 마이그레이션 가이드를 참조하십시오.

이 섹션에서는 Hibernate ORM 버전 6.1에서 6.2로 마이그레이션할 때 필요한 변경 사항을 중점적으로 설명합니다. Hibernate ORM 6.1과 Hibernate ORM 6.2 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 6.2 마이그레이션 가이드를 참조하십시오.

Hibernate 6.2 릴리스에는 다음과 같은 향상된 기능이 포함되어 있습니다.

DDL 유형 변경:

JBoss EAP 7.0에는 Hibernate ORM 5.0이 포함되어 있습니다. 이 섹션에서는 Hibernate ORM 버전 4.3에서 버전 5로 마이그레이션할 때 필요한 변경 사항을 중점적으로 설명합니다. Hibernate ORM 4와 Hibernate ORM 5 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 5.0 마이그레이션 가이드를 참조하십시오.

제거 및 더 이상 사용되지 않는 클래스

다음의 더 이상 사용되지 않는 클래스는 Hibernate ORM 5에서 제거되었습니다.

클래스 및 패키지에 대한 기타 변경 사항

유형 처리

트랜잭션 관리

기타 Hibernate ORM 5 변경

JBoss EAP 7.1에는 Hibernate ORM 5.1이 포함되어 있습니다. 이 섹션에서는 Hibernate ORM 버전 5.0에서 버전 5.1로 마이그레이션할 때 필요한 차이점과 변경 사항을 중점적으로 설명합니다.

Hibernate ORM 5.1 기능

이 Hibernate 릴리스에는 성능 개선 및 버그 수정이 포함되어 있습니다. 자세한 내용은 7.1.0용 JBoss EAP 릴리스 노트 의 Hibernate ORM 5.1 기능을 참조하십시오. Hibernate ORM 5.0과 Hibernate ORM 5.1 간에 구현된 변경 사항에 대한 자세한 내용은 Hibernate ORM 5.1 마이그레이션 가이드를 참조하십시오.

스키마 관리 툴링 변경

JBoss EAP 7의 스키마 관리 툴 변경

Hibernate ORM 5.1의 스키마 관리 툴링 변경 사항은 다음 영역에 중점을 두고 있습니다.

스키마 관리 툴링 변경은 다음 클래스를 직접 사용하는 애플리케이션의 마이그레이션 문제일 뿐입니다.

JBoss EAP 7.1의 스키마 관리 툴 변경

JBoss EAP 7.1에 포함된 Hibernate ORM 5.1.10에는 SchemaMigrator 및 SchemaValidator 성능을 개선하는 데이터베이스 테이블을 검색하는 전략이 도입되었습니다. 이 전략은 단일 java.sql.DatabaseMetaData#getTables(String, string, String, String, String[]) 호출을 실행하여 각 javax.persistence.Entity 에 매핑된 데이터베이스 테이블이 있는지 확인합니다. 이는 기본 전략이며 hibernate.hbm2ddl.jdbc_metadata_extraction_strategy=grouped 속성 설정을 사용합니다. 이 전략을 사용하려면 hibernate.default_schema 및/또는 hibernate.default_catalog 가 필요할 수 있습니다.

java.sql.DatabaseMetaData#getTables(String, String, String, String, String[]) 호출의 이전 전략을 사용하려면 hibernate . hbm2ddl.jdbc_metadata_extraction_strategy=individually 속성 설정을 사용합니다.

JBoss EAP 7.4에는 Hibernate ORM 5.3이 포함되어 있습니다. 이 섹션에서는 Hibernate ORM 5.1에서 Hibernate ORM 5.2로 마이그레이션한 다음 Hibernate ORM 5.3으로 마이그레이션할 때 필요한 몇 가지 변경 사항을 중점적으로 설명합니다.

Hibernate ORM 5.2 기능

Hibernate ORM 5.2는 Java 8 JDK를 사용하여 구축되었으며 런타임 시 Java 8 JRE가 필요합니다. 다음은 이 릴리스에서 수행된 일부 변경 사항 목록입니다.

Hibernate 5.2에서 구현된 변경 사항의 전체 목록은 Hibernate ORM 5.2 마이그레이션 가이드를 참조하십시오.

Hibernate ORM 5.3 기능

Hibernate ORM 5.3에서는 자카르타 지속성 2.2 사양에 대한 지원이 추가되었습니다. 이 릴리스에는 기타 개선 사항과 함께 이 사양을 준수하기 위한 변경 사항이 포함되어 있습니다. 다음은 이러한 변경 사항 중 일부 목록입니다.

Hibernate 5.3에서 구현된 이러한 변경 사항 및 기타 변경 사항의 전체 목록은 Hibernate ORM 5.3 마이그레이션 가이드를 참조하십시오.

Hibernate 5.1과 Hibernate 5.3 간의 변경 사항 예외 처리

Hibernate 5.2 및 5.3에서는 Hibernate의 네이티브 부트스트랩을 사용하여 구축된 SessionFactory 에 대한 예외 처리, Jakarta Persistence 사양에 따라 HibernateException 을 래핑하거나 변환합니다. 이 동작에 대한 유일한 예외는 작업이 Hibernate에 특정한 경우입니다(예: Session.save() 또는 Session.saveOrUpdate() ).

Hibernate 5.3.3에서는 hibernate.native_exception_handling_51_compliance 속성이 추가되었습니다. 이 속성은 Hibernate의 네이티브 부트스트랩을 사용하여 구축된 SessionFactory 에 대한 예외 처리가 Hibernate ORM 5.1의 기본 예외 처리와 동일하게 작동하는지 여부를 나타냅니다. true 로 설정하면HibernateException 이 Jakarta Persistence 사양에 따라 래핑되거나 변환되지 않습니다. 이 설정은 Jakarta Persistence 부트스트랩을 사용하여 빌드된 SessionFactory 에서 무시됩니다.

호환성 변환기

JBoss EAP 7.4에는 더 이상 Hibernate ORM 5.1과 호환되지 않는 Hibernate ORM 5.3 API 방법을 처리하는 호환성 변형기가 포함되어 있습니다. 변환기는 Hibernate ORM 5.1을 사용하여 빌드된 애플리케이션이 JBoss EAP 7.4의 Hibernate 5.3과 동일한 동작을 표시할 수 있도록 하는 임시 조치입니다. 임시 솔루션이므로 이러한 메서드 호출을 권장되는 Jakarta 지속성 메서드 호출로 교체해야 합니다.

다음 방법 중 하나로 변환기를 활성화할 수 있습니다.

다음 표에는 변환된 Hibernate 5.1 방법과 다음과 같은 Hibernate 5.3 방법이 나열되어 있습니다.