hibernate-orm/release_notes.md at eeba7edf322bab8cc2ef44605bed1b6ee81e494d

4.6 KiB

Raw Blame History

Jakarta Persistence 3.2

7.0 migrates to Jakarta Persistence 3.2 which can be fairly disruptive. See the Migration Guide for details.

See this blog post for a summary of the changes in 3.2

TCK Results with Java 17
TCK Results with Java 21

Java 17

Version 3.2 of Jakarta Persistence requires Java 17.
Hibernate 7.0 therefore baselines on Java 17 whereas previous versions baseline on Java 11.

Domain Model Validations

7.0 does much more validation of an application's domain model and especially its mapping details, e.g.

illegal combinations such as @Basic and @ManyToOne on the same attribute
misplaced annotations such as an annotated getter method with FIELD access
stricter following of JavaBean conventions

See the Migration Guide for details.

mapping.xsd

Hibernate 7.0 provides a new XSD that represents an "extension" of the Jakarta Persistence orm.xsd weaving in Hibernate-specific mapping features.
The namespace for this extended mapping is http://www.hibernate.org/xsd/orm/mapping

For applications using Hibernate's legacy hbm.xml format, we provide a tool to help with the transformation. See the Migration Guide for details.

Hibernate Models

7.0 migrates from Hibernate Commons Annotations (HCANN) to the new Hibernate Models project for low-level processing of an application domain model, reading annotations and weaving in XML mapping documents. See the Migration Guide for details.

JSON and XML functions

Support for most of the JSON and XML functions that the SQL standard specifies was added to HQL/Criteria. The implementations retain the SQL standard semantics and will throw an error if emulation on a database is impossible.

New functions include:

construction functions like json_array(), json_object(), xmlelement() and xmlforest()
query functions like json_value(), json_query() and xmlquery()
aggregation functions like json_agg(), json_object_agg() and xmlagg()
manipulation functions like json_set(), json_mergepatch()
any many more

The functions are incubating/tech-preview - to use them in HQL it is necessary to enable the hibernate.query.hql.json_functions_enabled and hibernate.query.hql.xml_functions_enabled configuration settings.

Set-returning Functions

A set-returning function is a new type of function that can return rows and is exclusive to the from clause. The concept is known in many different database SQL dialects and is sometimes referred to as table valued function or table function.

Custom set-returning functions can be registered via a FunctionContributor. Out-of-the-box, some common set-returning functions are already supported or emulated

unnest() - allows to turn an array into rows
generate_series() - can be used to create a series of values as rows
json_table() - turns a JSON document into rows
xmltable() - turns an XML document into rows

@AnyDiscriminatorImplicitValues

The new @AnyDiscriminatorImplicitValues offers 2 related improvements for the mapping of discriminator values for @Any and ManyToAny associations.

First, it allows control over how Hibernate determines the discriminator value to store in the database for implicit discriminator mappings. Historically, Hibernate would always use the full name of the associated entity.

Second, it allows mixing of explicit and implicit value strategies.