HHH-16383 - NaturalIdClass

Author: sebersole

documentation/src/main/asciidoc/introduction/Entities.adoc

@@ -539,6 +539,7 @@ class Book {
 }
 ----
 
+See the link:{doc-user-guide-url}#naturalid[User Guide] for more details about natural ids.
 
 The payoff for doing this extra work, as we will see <<natural-id-cache,much later>>, is that we can take advantage of optimized natural id lookups that make use of the second-level cache.
 

documentation/src/main/asciidoc/introduction/Interacting.adoc

@@ -391,6 +391,8 @@ For multi-attribute natural ids, Hibernate will accept a number of forms:
 Each of the operations we've seen so far affects a single entity instance passed as an argument.
 But there's a way to set things up so that an operation will propagate to associated entities.
 
+See the link:{doc-user-guide-url}#find-by-natural-id[User Guide] for more details about loading by natural ids.
+
 [[cascade]]
 === Cascading persistence operations
 
@@ -648,6 +650,8 @@ We also have some operations for working with lookups by <<natural-identifiers,
 | `byMultipleNaturalId()` | Lets us load a _batch_ of natural ids at the same time
 |===
 
+Again, see the link:{doc-user-guide-url}#find-by-natural-id[User Guide] for more details about loading by natural ids.
+
 Here's how we can retrieve an entity by its composite natural id:
 
 [source,java]

documentation/src/main/asciidoc/userguide/chapters/domain/natural_id.adoc

@@ -123,7 +123,7 @@ Hibernate historically offered the dedicated `byNaturalId()`, `bySimpleNaturalId
 ====
 
 
-[[load-by-natural-id-example]]
+[[find-by-natural-id-example]]
 .Loading by natural id
 ====
 [source,java]

hibernate-core/src/main/java/org/hibernate/internal/find/FindByKeyOperation.java

@@ -287,7 +287,7 @@ protected Object coerceId(Object id, SessionFactoryImplementor factory) {
 		}
 
 		try {
-			return entityDescriptor.getIdentifierMapping().getJavaType().coerce( id, factory::getTypeConfiguration );
+			return entityDescriptor.getIdentifierMapping().getJavaType().coerce( id );
 		}
 		catch ( Exception e ) {
 			throw new IllegalArgumentException( "Argument '" + id