diff --git a/documentation/src/main/asciidoc/introduction/Advanced.adoc b/documentation/src/main/asciidoc/introduction/Advanced.adoc index 3ac74b440228..40226bd92a7f 100644 --- a/documentation/src/main/asciidoc/introduction/Advanced.adoc +++ b/documentation/src/main/asciidoc/introduction/Advanced.adoc @@ -711,7 +711,9 @@ sessionFactory.inTransaction(session -> { Java lists and maps don't map very naturally to foreign key relationships between tables, and so we tend to avoid using them to represent associations between our entity classes. But if you feel like you _really_ need a collection with a fancier structure than `Set`, Hibernate does have options. -The first three options let us map the index of a `List` or key of a `Map` to a column, and are usually used with a `@ElementCollection`, or on the owning side of an association: +TIP: For more detail about the use of these annotations, please refer to https://in.relation.to/2024/11/12/-what-collection/[this post on the Hibernate blog]. + +The first three options let us map the index of a `List` or key of a `Map` to a column, and are usually used with `@ElementCollection`, or on the owning side of an association: .Annotations for mapping lists and maps [%breakable,cols="22,~,^13"] diff --git a/documentation/src/main/asciidoc/introduction/Mapping.adoc b/documentation/src/main/asciidoc/introduction/Mapping.adoc index 8d254a393b08..8c22064230a3 100644 --- a/documentation/src/main/asciidoc/introduction/Mapping.adoc +++ b/documentation/src/main/asciidoc/introduction/Mapping.adoc @@ -351,6 +351,8 @@ These annotations specify how elements of the domain model map to columns of tab | `@MapKeyColumn` | Specified a column that should be used to persist the keys of a `Map`. |=== +We'll come back to the last two annotations much later, in <>. + We use the `@Column` annotation to map basic attributes. [[regular-column-mappings]]