Skip to content

migration-guide.adoc

Latest commit

 

History

History
78 lines (53 loc) · 3 KB

migration-guide.adoc

File metadata and controls

78 lines (53 loc) · 3 KB

7.2 Migration Guide

Table of Contents

This guide discusses migration to Hibernate ORM version 7.2. For migration from earlier versions, see any other pertinent migration guides as well.

Requirements

See the website for the list of requirements for the 7.2 series.

New Features

See the website for the list of new features in the 7.2 series.

Changes to API

This section describes changes to contracts (classes, interfaces, methods, etc.) which are considered API.

  • Code underlying the session builder APIs was reengineered, and the behavior of noInterceptor() for SharedSessionBuilder and SharedStatelessSessionBuilder was aligned with the preexisting semantics of this method on SessionBuilder and StatelessSessionBuilder. The previous behavior may be recovered by calling noSessionInterceptorCreation().

  • org.hibernate.dialect.AzureSQLServerDialect was deprecated. Use org.hibernate.dialect.SQLServerDialect instead. If you set hibernate.boot.allow_jdbc_metadata_access=false for offline startup, remember to also set the targeted database version through jakarta.persistence.database-product-version; this would be 16.0 for SQL Server 2022 or 17.0 for SQL Server 2025.

Changes to SPI

This section describes changes to contracts (classes, interfaces, methods, etc.) which are considered SPI.

  • Some operations of TypeConfiguration, JavaTypeRegistry, and BasicTypeRegistry used unbound type parameters in the return type. The generic signatures of these methods have been changed for improved type safety.

Changes to DDL generation

This section describes changes to DDL generated by the schema export tooling. Such changes typically do not impact programs using a relational schema managed externally to Hibernate.

Changes in Dependencies

This section describes changes to dependencies used by Hibernate ORM.