add useful @sees to jdoc for some exception types

Author: gavinking

hibernate-core/src/main/java/org/hibernate/LazyInitializationException.java

@@ -19,6 +19,8 @@
  *
  * @see Hibernate#initialize(Object)
  * @see Hibernate#isInitialized(Object)
+ * @see StatelessSession#fetch(Object)
+ *
  * @author Gavin King
  */
 public class LazyInitializationException extends HibernateException {

hibernate-core/src/main/java/org/hibernate/NonUniqueResultException.java

@@ -13,6 +13,9 @@
  * this one is recoverable!
  *
  * @author Gavin King
+ *
+ * @see jakarta.persistence.Query#getSingleResult
+ * @see org.hibernate.query.SelectionQuery#getSingleResult
  */
 public class NonUniqueResultException extends HibernateException {
 

hibernate-core/src/main/java/org/hibernate/PropertySetterAccessException.java

@@ -11,6 +11,8 @@
 import org.checkerframework.checker.nullness.qual.Nullable;
 
 /**
+ * Thrown when an {@link IllegalArgumentException} occurs calling a property setter method.
+ *
  * @author Steve Ebersole
  */
 public class PropertySetterAccessException extends PropertyAccessException {

hibernate-core/src/main/java/org/hibernate/QueryTimeoutException.java

@@ -7,9 +7,13 @@
 import java.sql.SQLException;
 
 /**
- * Thrown when a database query timeout occurs.
+ * A {@link JDBCException} indicating that a database query timed
+ * out on the database.
  *
  * @author Scott Marlow
+ *
+ * @see jakarta.persistence.Query#setTimeout
+ * @see org.hibernate.query.CommonQueryContract#setTimeout
  */
 public class QueryTimeoutException extends JDBCException {
 	/**

hibernate-core/src/main/java/org/hibernate/UnknownEntityTypeException.java

@@ -6,7 +6,7 @@
 
 /**
  * Indicates an attempt was made to refer to an unknown entity name or class.
- * <p>
+ *
  * @implNote This class extends {@link MappingException} for legacy reasons.
  * Longer term I think it makes more sense to have a different hierarchy for
  * runtime-"mapping" exceptions.

hibernate-core/src/main/java/org/hibernate/exception/LockTimeoutException.java

@@ -9,10 +9,13 @@
 import java.sql.SQLException;
 
 /**
- * A {@link JDBCException} indicating that a lock request
- * timed out on the database.
+ * A {@link JDBCException} indicating that a {@linkplain org.hibernate.LockMode lock}
+ * request timed out on the database.
  *
  * @author Steve Ebersole
+ *
+ * @see org.hibernate.LockOptions#getTimeOut
+ * @see org.hibernate.LockOptions#setTimeOut
  */
 public class LockTimeoutException extends LockAcquisitionException {
 	public LockTimeoutException(String string, SQLException root) {