HSEARCH-4203 Fix javadoc of PojoLoader.castToExactTypeOrNull

mapper/orm/src/main/java/org/hibernate/search/mapper/orm/loading/impl/HibernateOrmEntityIdEntityLoadingStrategy.java

@@ -64,7 +64,7 @@ public <E2> PojoLoader<E2> createLoader(Set<LoadingIndexedTypeContext<? extends
 					targetEntityTypeContexts.iterator().next();
 			/*
 			 * This cast is safe: the loader will only return instances of E2.
-			 * See hasExpectedType() and its callers for more information,
+			 * See PojoLoader.castToExactTypeOrNull() and its callers for more information,
 			 * in particular runtime checks handling edge cases.
 			 */
 			@SuppressWarnings("unchecked")
@@ -88,7 +88,7 @@ public <E2> PojoLoader<E2> createLoader(Set<LoadingIndexedTypeContext<? extends
 		 *
 		 * However, we perform some runtime checks that make this cast safe.
 		 *
-		 * See hasExpectedType() and its callers for more information.
+		 * See PojoLoader.castToExactTypeOrNull() and its callers for more information.
 		 */
 		@SuppressWarnings("unchecked")
 		PojoLoader<E2> result = (PojoLoader<E2>) doCreate( commonSuperType, sessionContext, cacheLookupStrategy,

mapper/pojo-base/src/main/java/org/hibernate/search/mapper/pojo/loading/spi/PojoLoader.java

@@ -71,7 +71,8 @@ public interface PojoLoader<E> {
 	 * when creating this loader.
 	 * @param loadedObject A loaded object, i.e. an element retrieved from the list
 	 * returned by {@link #loadBlocking(List, Deadline)}.
-	 * @return {@code true} if the loaded object is an instance of the expected type or a subtype.
+	 * @return The given {@code loadedObject} if is an instance of {@code expectedType} exactly (not an instance of a subtype).
+	 * {@code null} otherwise.
 	 */
 	<E2 extends E> E2 castToExactTypeOrNull(PojoRawTypeIdentifier<E2> expectedType, Object loadedObject);