make it clear that @fetch(JOIN) always takes precedence over fetch=LAZY

gavinking · gavinking · commit 2b39aaeafdb1 · 2025-10-21T09:39:46.000+02:00
diff --git a/hibernate-core/src/main/java/org/hibernate/annotations/Fetch.java b/hibernate-core/src/main/java/org/hibernate/annotations/Fetch.java
@@ -27,7 +27,8 @@
  * overridden in a given {@linkplain FetchProfile fetch profile}.
  * <p>
  * Note that join fetching is incompatible with lazy fetching, and so
- * {@code @Fetch(JOIN)} implies {@code fetch=EAGER}.
+ * {@code @Fetch(JOIN)} implies {@code fetch=EAGER}, overriding any
+ * explicitly-specified {@code fetch=LAZY} setting.
  *
  * @author Emmanuel Bernard
  *

Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,8 @@`
`27`	`27`	`* overridden in a given {@linkplain FetchProfile fetch profile}.`
`28`	`28`	`* <p>`
`29`	`29`	`* Note that join fetching is incompatible with lazy fetching, and so`
`30`		`- * {@code @Fetch(JOIN)} implies {@code fetch=EAGER}.`
	`30`	`+ * {@code @Fetch(JOIN)} implies {@code fetch=EAGER}, overriding any`
	`31`	`+ * explicitly-specified {@code fetch=LAZY} setting.`
`31`	`32`	`*`
`32`	`33`	`* @author Emmanuel Bernard`
`33`	`34`	`*`