From 569b0263f446a5ac91c90130a34ca32d8167cb81 Mon Sep 17 00:00:00 2001 From: Gavin King Date: Sun, 23 Mar 2025 17:52:14 +0100 Subject: [PATCH] add more links to the Short Guide --- .../src/main/asciidoc/introduction/Introduction.adoc | 8 ++++++-- documentation/src/main/asciidoc/introduction/Preface.adoc | 8 +++++--- .../src/main/asciidoc/introduction/Processor.adoc | 4 ++-- 3 files changed, 13 insertions(+), 7 deletions(-) diff --git a/documentation/src/main/asciidoc/introduction/Introduction.adoc b/documentation/src/main/asciidoc/introduction/Introduction.adoc index 220bc62be97d..b555ae1ca232 100644 --- a/documentation/src/main/asciidoc/introduction/Introduction.adoc +++ b/documentation/src/main/asciidoc/introduction/Introduction.adoc @@ -1,6 +1,10 @@ [[introduction]] == Introduction +:persistence: https://jakarta.ee/specifications/persistence/3.2/jakarta-persistence-spec-3.2 +:data: https://jakarta.ee/specifications/data/1.0/jakarta-data-1.0 + + Hibernate is usually described as a library that makes it easy to map Java classes to relational database tables. But this formulation does no justice to the central role played by the relational data itself. So a better description might be: @@ -35,7 +39,7 @@ Developers often ask about the relationship between Hibernate and JPA, so let's [[hibernate-and-jpa]] === Hibernate and JPA -Hibernate was the inspiration behind the _Java_ (now _Jakarta_) _Persistence API_, or JPA, and includes a complete implementation of the latest revision of this specification. +Hibernate was the inspiration behind the _Java_ (now _Jakarta_) _Persistence API_, or JPA, and includes a complete implementation of the latest revision of link:{persistence}[this specification]. .The early history of Hibernate and JPA **** @@ -669,7 +673,7 @@ Alternatively, if CDI isn't available, we may directly instantiate the generated [TIP] ==== -The Jakarta Data specification now formalizes this approach using standard annotations, and our implementation of this specification, Hibernate Data Repositories, is built into <>. +The link:{data}[Jakarta Data specification] now formalizes this approach using standard annotations, and our implementation of this specification, Hibernate Data Repositories, is built into <>. You probably already have it available in your program. Unlike other repository frameworks, Hibernate Data Repositories offers something that plain JPA simply doesn’t have: full compile-time type safety for your queries. To learn more, please refer to link:{doc-data-repositories-url}[Introducing Hibernate Data Repositories]. diff --git a/documentation/src/main/asciidoc/introduction/Preface.adoc b/documentation/src/main/asciidoc/introduction/Preface.adoc index 18733ed83e16..b10cd7287555 100644 --- a/documentation/src/main/asciidoc/introduction/Preface.adoc +++ b/documentation/src/main/asciidoc/introduction/Preface.adoc @@ -1,19 +1,21 @@ [[preface]] == Preface +:persistence: https://jakarta.ee/specifications/persistence/3.2/jakarta-persistence-spec-3.2 +:data: https://jakarta.ee/specifications/data/1.0/jakarta-data-1.0 + Hibernate 6 was a major redesign of the world's most popular and feature-rich ORM solution. The redesign touched almost every subsystem of Hibernate, including the APIs, mapping annotations, and the query language. This new Hibernate was suddenly more powerful, more robust, more portable, and more type safe. -Hibernate 7 builds on this foundation, adds support for JPA 3.2, and introduces Hibernate Data Repositories, an implementation of the Jakarta Data specification. +Hibernate 7 builds on this foundation, adds support for link:{persistence}[JPA 3.2], and introduces https://hibernate.org/repositories/[Hibernate Data Repositories], an implementation of the link:{data}[Jakarta Data specification]. Taken together, these enhancements yield a level of compile-time type safety--and resulting developer productivity--which was previously impossible. Hibernate Data Repositories offers truly seamless integration of the ORM solution with the persistence layer, obsoleting older add-on repository frameworks. -Hibernate and Hibernate Reactive are core components of Quarkus 3, the most exciting new environment for cloud-native development in Java, and Hibernate remains the persistence solution of choice for almost every major Java framework or server. +Hibernate ORM and https://hibernate.org/reactive/[Hibernate Reactive] are core components of https://quarkus.io[Quarkus 3], the most exciting new environment for cloud-native development in Java, and Hibernate remains the persistence solution of choice for almost every major Java framework or server. Unfortunately, the changes in Hibernate 6 also obsoleted much of the information about Hibernate that's available in books, in blog posts, and on stackoverflow. - This guide is an up-to-date, high-level discussion of the current feature set and recommended usage. It does not attempt to cover every feature and should be used in conjunction with other documentation: diff --git a/documentation/src/main/asciidoc/introduction/Processor.adoc b/documentation/src/main/asciidoc/introduction/Processor.adoc index 21f85a465a4f..fd2c0f9a3fc4 100644 --- a/documentation/src/main/asciidoc/introduction/Processor.adoc +++ b/documentation/src/main/asciidoc/introduction/Processor.adoc @@ -9,10 +9,10 @@ We've actually already seen its handiwork in the code examples <> and <> in a completely type-safe way.