Skip to content

Commit

Permalink
Fix reference to custom converters.
Browse files Browse the repository at this point in the history
The reference was both broken and somehow got moved to the wrong place.

Closes #1949
  • Loading branch information
schauder committed Nov 25, 2024
1 parent 66466e8 commit c77a59f
Showing 1 changed file with 2 additions and 3 deletions.
5 changes: 2 additions & 3 deletions src/main/antora/modules/ROOT/pages/jdbc/mapping.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -66,11 +66,12 @@ The table of the referenced entity is expected to have an additional column with
The table of the referenced entity is expected to have two additional columns: One named based on the referencing entity for the foreign key (see <<jdbc.entity-persistence.types.backrefs>>) and one with the same name and an additional `_key` suffix for the map key.

* `List<some entity>` is mapped as a `Map<Integer, some entity>`. The same additional columns are expected and the names used can be customized in the same way.

+
For `List`, `Set`, and `Map` naming of the back reference can be controlled by implementing `NamingStrategy.getReverseColumnName(RelationalPersistentEntity<?> owner)` and `NamingStrategy.getKeyColumn(RelationalPersistentProperty property)`, respectively.
Alternatively you may annotate the attribute with `@MappedCollection(idColumn="your_column_name", keyColumn="your_key_column_name")`.
Specifying a key column for a `Set` has no effect.

* Types for which you registered suitable xref:#mapping.explicit.converters[custom converters].


[[mapping.usage.annotations]]
Expand Down Expand Up @@ -132,8 +133,6 @@ p1.bestFriend = AggregateReference.to(p2.id);
You should not include attributes in your entities to hold the actual value of a back reference, nor of the key column of maps or lists.
If you want these value to be available in your domain model we recommend to do this in a `AfterConvertCallback` and store the values in transient values.

* Types for which you registered suitable [[jdbc.custom-converters, custom conversions]].

:mapped-collection: true
:embedded-entities: true
include::partial$mapping.adoc[]
Expand Down

0 comments on commit c77a59f

Please sign in to comment.