improve some JDBC related Javadocs

nathan.xu · nathan.xu · commit 762a1bff630f · 2024-11-03T20:33:32.000-05:00
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/AbstractLobCreator.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/AbstractLobCreator.java
@@ -8,7 +8,7 @@
 import java.sql.NClob;
 
 /**
- * Convenient base class for proxy-based LobCreator for handling wrapping.
+ * Convenient base class for proxy-based {@link LobCreator} for handling wrapping.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/BlobImplementer.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/BlobImplementer.java
@@ -7,7 +7,7 @@
 import java.sql.SQLException;
 
 /**
- * Marker interface for non-contextually created {@link java.sql.Blob} instances..
+ * Marker interface for non-contextually created {@link java.sql.Blob} instances.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/ClobImplementer.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/ClobImplementer.java
@@ -5,7 +5,7 @@
 package org.hibernate.engine.jdbc;
 
 /**
- * Marker interface for non-contextually created {@link java.sql.Clob} instances..
+ * Marker interface for non-contextually created {@link java.sql.Clob} instances.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/NClobImplementer.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/NClobImplementer.java
@@ -5,9 +5,9 @@
 package org.hibernate.engine.jdbc;
 
 /**
- * Marker interface for non-contextually created java.sql.NClob instances..
+ * Marker interface for non-contextually created {@link java.sql.NClob} instances.
  * <p>
- * java.sql.NClob is a new type introduced in JDK 1.6 (JDBC 4)
+ * {@link java.sql.NClob} is a new type introduced in JDK 1.6 (JDBC 4)
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/NonContextualLobCreator.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/NonContextualLobCreator.java
@@ -12,7 +12,7 @@
 
 /**
  * {@link LobCreator} implementation using non-contextual or local creation, meaning that we generate the LOB
- * references ourselves as opposed to delegating to the JDBC {@link java.sql.Connection}.
+ * references ourselves as opposed to delegating to the {@linkplain java.sql.Connection JDBC connection}.
  *
  * @author Steve Ebersole
  * @author Gail Badner
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/SerializableNClobProxy.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/SerializableNClobProxy.java
@@ -9,7 +9,7 @@
 import java.sql.NClob;
 
 /**
- * Manages aspects of proxying java.sql.NClobs to add serializability.
+ * Manages aspects of proxying {@link NClob}s to add serializability.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/Size.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/Size.java
@@ -9,11 +9,11 @@
 import java.io.Serializable;
 
 /**
- * Models size restrictions/requirements on a column's datatype.
+ * Models size restrictions/requirements on a column's data type.
  *
- * @implNote Since we do not necessarily know the datatype up front, and therefore do not necessarily know
+ * @implNote Since we do not necessarily know the data type up front, and therefore do not necessarily know
  * whether length or precision/scale sizing is needed, we simply account for both here. Additionally, LOB
- * sizes, by standard, are allowed a "multiplier", {@code K} (Kb), {@code M} (Mb) or {@code G} (Gb).
+ * sizes, by standard, are allowed a "multiplier", i.e., {@code K} (Kb), {@code M} (Mb) or {@code G} (Gb).
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/internal/BasicBatchKey.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/internal/BasicBatchKey.java
@@ -8,7 +8,7 @@
 import org.hibernate.jdbc.Expectations;
 
 /**
- * Normal implementation of BatchKey
+ * Normal implementation of {@link BatchKey}
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/DatabaseConnectionInfoImpl.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/internal/DatabaseConnectionInfoImpl.java
@@ -20,7 +20,7 @@
 import static org.hibernate.internal.util.StringHelper.nullIfEmpty;
 
 /**
- * Standard implementation of DatabaseConnectionInfo
+ * Standard implementation of {@link DatabaseConnectionInfo}
  *
  * @author Jan Schatteman
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/spi/AbstractDataSourceBasedMultiTenantConnectionProviderImpl.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/spi/AbstractDataSourceBasedMultiTenantConnectionProviderImpl.java
@@ -11,7 +11,8 @@
 import org.hibernate.service.UnknownUnwrapTypeException;
 
 /**
- * Basic support for implementations of {@link MultiTenantConnectionProvider} based on DataSources.
+ * Basic support for implementations of {@link MultiTenantConnectionProvider} based on {@link DataSource}s.
+ *
  * @author Steve Ebersole
  */
 public abstract class AbstractDataSourceBasedMultiTenantConnectionProviderImpl<T> implements MultiTenantConnectionProvider<T> {
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/spi/AbstractMultiTenantConnectionProvider.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/spi/AbstractMultiTenantConnectionProvider.java
@@ -11,7 +11,7 @@
 
 /**
  * Basic support for {@link MultiTenantConnectionProvider} implementations using
- * individual {@link ConnectionProvider} instances per tenant behind the scenes.
+ * individual {@link ConnectionProvider} instance per tenant behind the scenes.
  * <p>
  * This class is meant to be subclassed to implement application-specific
  * requirements.
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/spi/ConnectionProvider.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/connections/spi/ConnectionProvider.java
@@ -19,7 +19,7 @@
  * A {@code ConnectionProvider} may be selected using the configuration property
  * {@value org.hibernate.cfg.AvailableSettings#CONNECTION_PROVIDER}.
  * <p>
- * It's not usual for an applications to implement its on {@code ConnectionProvider}.
+ * It's not usual for an application to implement its own {@code ConnectionProvider}.
  * Instead, the Hibernate project provides pre-built implementations for a variety of
  * connection pools as add-on modules.
  * <p>
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/cursor/internal/RefCursorSupportInitiator.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/cursor/internal/RefCursorSupportInitiator.java
@@ -12,7 +12,7 @@
 import org.hibernate.service.spi.ServiceRegistryImplementor;
 
 /**
- * Service initiator for RefCursorSupport service
+ * Service initiator for {@link RefCursorSupport} service
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/cursor/internal/StandardRefCursorSupport.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/cursor/internal/StandardRefCursorSupport.java
@@ -17,7 +17,7 @@
 import org.jboss.logging.Logger;
 
 /**
- * Standard implementation of RefCursorSupport
+ * Standard implementation of {@link RefCursorSupport}
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/internal/StandardDialectResolver.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/internal/StandardDialectResolver.java
@@ -10,7 +10,7 @@
 import org.hibernate.engine.jdbc.dialect.spi.DialectResolver;
 
 /**
- * The standard DialectResolver implementation
+ * The standard {@link DialectResolver} implementation
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/spi/DatabaseMetaDataDialectResolutionInfoAdapter.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/spi/DatabaseMetaDataDialectResolutionInfoAdapter.java
@@ -8,9 +8,9 @@
 import java.sql.SQLException;
 
 /**
- * An implementation of DialectResolutionInfo that delegates calls to a wrapped {@link DatabaseMetaData}.
+ * An implementation of {@link DialectResolutionInfo} that delegates calls to a wrapped {@link DatabaseMetaData}.
  * <p>
- * All {@link SQLException}s resulting from calls on the DatabaseMetaData are converted to the Hibernate
+ * All {@link SQLException}s resulting from calls on the {@link DatabaseMetaData} are converted to the Hibernate
  * {@link org.hibernate.JDBCException} hierarchy.
  *
  * @author Steve Ebersole
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/spi/DialectFactory.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/spi/DialectFactory.java
@@ -11,7 +11,7 @@
 import org.hibernate.service.Service;
 
 /**
- * A factory for generating Dialect instances.
+ * A factory for generating {@link Dialect} instances.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/spi/DialectResolutionInfoSource.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/dialect/spi/DialectResolutionInfoSource.java
@@ -5,7 +5,7 @@
 package org.hibernate.engine.jdbc.dialect.spi;
 
 /**
- * Contract for the source of DialectResolutionInfo.
+ * Contract for the source of {@link DialectResolutionInfo}.
  */
 @FunctionalInterface
 public interface DialectResolutionInfoSource {
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/internal/BlobAndClobCreator.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/internal/BlobAndClobCreator.java
@@ -23,9 +23,9 @@
  * LobCreator which can use {@link Connection#createBlob} and {@link Connection#createClob},
  * but {@link java.sql.NClob} references are created locally.
  *
- * @see NClobProxy
- *
  * @author Steve Ebersole
+ *
+ * @see NClobProxy
  */
 public class BlobAndClobCreator extends AbstractLobCreator implements LobCreator {
 
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/internal/ExtractedDatabaseMetaDataImpl.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/internal/ExtractedDatabaseMetaDataImpl.java
@@ -24,7 +24,7 @@
 import static java.util.stream.StreamSupport.stream;
 
 /**
- * Standard implementation of ExtractedDatabaseMetaData
+ * Standard implementation of {@link ExtractedDatabaseMetaData}
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/internal/QualifiedObjectNameFormatterStandardImpl.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/internal/QualifiedObjectNameFormatterStandardImpl.java
@@ -16,7 +16,7 @@
 import org.hibernate.engine.jdbc.env.spi.QualifiedObjectNameFormatter;
 
 /**
- * Standard implementation of QualifiedObjectNameFormatter which uses information reported
+ * Standard implementation of {@link QualifiedObjectNameFormatter} which uses information reported
  * by {@link DatabaseMetaData} to render qualified names.
  *
  * @author Steve Ebersole
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/spi/IdentifierCaseStrategy.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/spi/IdentifierCaseStrategy.java
@@ -5,7 +5,7 @@
 package org.hibernate.engine.jdbc.env.spi;
 
 /**
- * An enumeration of the way DatabaseMetaData might store and return identifiers
+ * An enumeration of the way {@link java.sql.DatabaseMetaData} might store and return identifiers
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/spi/IdentifierHelperBuilder.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/env/spi/IdentifierHelperBuilder.java
@@ -20,8 +20,8 @@
 import static org.hibernate.internal.util.StringHelper.splitAtCommas;
 
 /**
- * Builder for IdentifierHelper instances.  Mainly here to allow progressive
- * building of the immutable (after instantiation) IdentifierHelper.
+ * Builder for {@link IdentifierHelper} instances.  Mainly here to allow progressive
+ * building of the immutable (after instantiation) {@link IdentifierHelper}.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/internal/ResultSetReturnImpl.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/internal/ResultSetReturnImpl.java
@@ -20,7 +20,7 @@
 import org.hibernate.resource.jdbc.spi.JdbcSessionContext;
 
 /**
- * Standard implementation of the ResultSetReturn contract
+ * Standard implementation of the {@link ResultSetReturn} contract
  *
  * @author Brett Meyer
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/AbstractMutationExecutor.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/AbstractMutationExecutor.java
@@ -24,7 +24,7 @@
 import static org.hibernate.sql.model.ModelMutationLogging.MODEL_MUTATION_LOGGER;
 
 /**
- * Base support for MutationExecutor implementations
+ * Base support for {@link MutationExecutor} implementations
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/JdbcValueDescriptorImpl.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/JdbcValueDescriptorImpl.java
@@ -11,7 +11,7 @@
 import org.hibernate.sql.model.jdbc.JdbcValueDescriptor;
 
 /**
- * Standard JdbcValueDescriptor implementation
+ * Standard {@link JdbcValueDescriptor} implementation
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/MutationExecutorStandard.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/MutationExecutorStandard.java
@@ -13,6 +13,7 @@
 import org.hibernate.engine.jdbc.batch.spi.Batch;
 import org.hibernate.engine.jdbc.batch.spi.BatchKey;
 import org.hibernate.engine.jdbc.mutation.JdbcValueBindings;
+import org.hibernate.engine.jdbc.mutation.MutationExecutor;
 import org.hibernate.engine.jdbc.mutation.OperationResultChecker;
 import org.hibernate.engine.jdbc.mutation.ParameterUsage;
 import org.hibernate.engine.jdbc.mutation.TableInclusionChecker;
@@ -36,7 +37,7 @@
 import static org.hibernate.internal.util.collections.CollectionHelper.isNotEmpty;
 
 /**
- * Standard MutationExecutor implementation
+ * Standard {@link MutationExecutor} implementation
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/NoBatchKeyAccess.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/NoBatchKeyAccess.java
@@ -8,8 +8,8 @@
 import org.hibernate.engine.jdbc.mutation.spi.BatchKeyAccess;
 
 /**
- * A form of BatchKeyAccess for cases where batching is not wanted, which is
- * signified by a BatchKey of {@code null}
+ * A form of {@link BatchKeyAccess} for cases where batching is not wanted, which is
+ * signified by a {@link BatchKey} of {@code null}
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/PreparedStatementDetailsStandard.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/PreparedStatementDetailsStandard.java
@@ -17,7 +17,7 @@
 import org.hibernate.sql.model.TableMapping;
 
 /**
- * Describes a particular PreparedStatement within a {@linkplain PreparedStatementGroup group}
+ * Describes a particular {@link PreparedStatement} within a {@linkplain PreparedStatementGroup group}
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/PreparedStatementGroupSingleTable.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/PreparedStatementGroupSingleTable.java
@@ -15,7 +15,7 @@
 import org.hibernate.sql.model.TableMapping;
 
 /**
- * PreparedStatementGroup implementation for cases where we
+ * {@link PreparedStatementGroup} implementation for cases where we
  * have just a single operation
  *
  * @author Steve Ebersole
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/StandardMutationExecutorService.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/internal/StandardMutationExecutorService.java
@@ -19,7 +19,7 @@
 import org.hibernate.sql.model.SelfExecutingUpdateOperation;
 
 /**
- * Standard MutationExecutorService implementation
+ * Standard {@link MutationExecutorService} implementation
  *
  * @see MutationExecutorServiceInitiator
  *
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/spi/BatchKeyAccess.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/spi/BatchKeyAccess.java
@@ -7,7 +7,8 @@
 import org.hibernate.engine.jdbc.batch.spi.BatchKey;
 
 /**
- * Provides access to a BatchKey as part of creating an {@linkplain MutationExecutorService#createExecutor executor}.
+ * Provides access to a {@link BatchKey} as part of creating an
+ * {@linkplain MutationExecutorService#createExecutor executor}.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/spi/SqlExceptionHelper.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/spi/SqlExceptionHelper.java
@@ -24,7 +24,7 @@
 import org.jboss.logging.Logger.Level;
 
 /**
- * Helper for handling SQLExceptions in various manners.
+ * Helper for handling {@link SQLException}s in various manners.
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/jdbc/TooManyRowsAffectedException.java b/hibernate-core/src/main/java/org/hibernate/jdbc/TooManyRowsAffectedException.java
@@ -6,7 +6,7 @@
 import org.hibernate.HibernateException;
 
 /**
- * Indicates that more rows were affected then we were expecting to be.
+ * Indicates that more rows were affected than we were expecting to be.
  * Typically indicates presence of duplicate "PK" values in the
  * given table.
  *
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/jdbc/internal/AbstractLogicalConnectionImplementor.java b/hibernate-core/src/main/java/org/hibernate/resource/jdbc/internal/AbstractLogicalConnectionImplementor.java
@@ -8,6 +8,7 @@
 import java.sql.SQLException;
 
 import org.hibernate.TransactionException;
+import org.hibernate.resource.jdbc.LogicalConnection;
 import org.hibernate.resource.jdbc.ResourceRegistry;
 import org.hibernate.resource.jdbc.spi.LogicalConnectionImplementor;
 import org.hibernate.resource.jdbc.spi.PhysicalJdbcTransaction;
@@ -16,7 +17,7 @@
 import org.jboss.logging.Logger;
 
 /**
- * Base support for LogicalConnection implementations
+ * Base support for {@link LogicalConnection} implementations
  *
  * @author Steve Ebersole
  */
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/jdbc/internal/LogicalConnectionManagedImpl.java b/hibernate-core/src/main/java/org/hibernate/resource/jdbc/internal/LogicalConnectionManagedImpl.java
@@ -14,6 +14,7 @@
 import org.hibernate.engine.jdbc.connections.spi.JdbcConnectionAccess;
 import org.hibernate.engine.jdbc.spi.JdbcServices;
 import org.hibernate.engine.jdbc.spi.SqlExceptionHelper;
+import org.hibernate.resource.jdbc.LogicalConnection;
 import org.hibernate.resource.jdbc.ResourceRegistry;
 import org.hibernate.resource.jdbc.spi.JdbcEventHandler;
 import org.hibernate.resource.jdbc.spi.JdbcSessionContext;
@@ -28,9 +29,9 @@
 import static org.hibernate.resource.jdbc.spi.PhysicalConnectionHandlingMode.DELAYED_ACQUISITION_AND_RELEASE_AFTER_TRANSACTION;
 
 /**
- * Represents a LogicalConnection where we manage obtaining and releasing the Connection as needed.
+ * Represents a {@link LogicalConnection} where we manage obtaining and releasing the {@link Connection} as needed.
  * This implementation does not claim to be thread-safe and is not designed to be used by multiple
- * threads, yet we do apply a limited amount of care to be able to void obscure exceptions when
+ * threads, yet we do apply a limited amount of care to be able to avoid obscure exceptions when
  * this class is used in the wrong way.
  *
  * @author Steve Ebersole
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/jdbc/internal/ResourceRegistryStandardImpl.java b/hibernate-core/src/main/java/org/hibernate/resource/jdbc/internal/ResourceRegistryStandardImpl.java
@@ -21,16 +21,16 @@
 import org.hibernate.resource.jdbc.spi.JdbcEventHandler;
 
 /**
- * Helps to track statements and resultsets which need being closed.
+ * Helps to track {@link Statement}s and {@link ResultSet}s which need being closed.
  * This class is not threadsafe.
  * <p>
- * Note regarding performance: we had evidence that allocating Iterators
+ * Note regarding performance: we had evidence that allocating {@code Iterator}s
  * to implement the cleanup on each element recursively was the dominant
  * resource cost, so we decided using "forEach" and lambdas in this case.
  * However the forEach/lambda combination is able to dodge allocating
- * Iterators on HashMap and ArrayList, but not on HashSet (at least on JDK8 and 11).
- * Therefore some types which should ideally be modelled as a Set have
- * been implemented using HashMap.
+ * {@code Iterator}s on {@code HashMap} and {@code ArrayList}, but not on {@code HashSet} (at least on JDK8 and 11).
+ * Therefore some types which should ideally be modelled as a {@code Set} have
+ * been implemented using {@code HashMap}.
  *
  * @author Steve Ebersole
  * @author Sanne Grinovero
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jdbc/internal/JdbcResourceLocalTransactionCoordinatorImpl.java b/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jdbc/internal/JdbcResourceLocalTransactionCoordinatorImpl.java
diff --git a/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jdbc/package-info.java b/hibernate-core/src/main/java/org/hibernate/resource/transaction/backend/jdbc/package-info.java
diff --git a/hibernate-core/src/main/java/org/hibernate/sql/model/jdbc/JdbcMutationOperation.java b/hibernate-core/src/main/java/org/hibernate/sql/model/jdbc/JdbcMutationOperation.java
diff --git a/hibernate-core/src/main/java/org/hibernate/sql/model/jdbc/MergeOperation.java b/hibernate-core/src/main/java/org/hibernate/sql/model/jdbc/MergeOperation.java
diff --git a/hibernate-core/src/main/java/org/hibernate/sql/model/jdbc/UpsertOperation.java b/hibernate-core/src/main/java/org/hibernate/sql/model/jdbc/UpsertOperation.java
diff --git a/hibernate-core/src/main/java/org/hibernate/sql/results/jdbc/internal/JdbcValuesMappingProducerProviderStandard.java b/hibernate-core/src/main/java/org/hibernate/sql/results/jdbc/internal/JdbcValuesMappingProducerProviderStandard.java
diff --git a/hibernate-core/src/main/java/org/hibernate/sql/results/jdbc/internal/ResultSetAccess.java b/hibernate-core/src/main/java/org/hibernate/sql/results/jdbc/internal/ResultSetAccess.java

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`import java.sql.NClob;`
`9`	`9`
`10`	`10`	`/**`
`11`		`- * Convenient base class for proxy-based LobCreator for handling wrapping.`
	`11`	`+ * Convenient base class for proxy-based {@link LobCreator} for handling wrapping.`
`12`	`12`	`*`
`13`	`13`	`* @author Steve Ebersole`
`14`	`14`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@`
`7`	`7`	`import java.sql.SQLException;`
`8`	`8`
`9`	`9`	`/**`
`10`		`- * Marker interface for non-contextually created {@link java.sql.Blob} instances..`
	`10`	`+ * Marker interface for non-contextually created {@link java.sql.Blob} instances.`
`11`	`11`	`*`
`12`	`12`	`* @author Steve Ebersole`
`13`	`13`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`	`package org.hibernate.engine.jdbc;`
`6`	`6`
`7`	`7`	`/**`
`8`		`- * Marker interface for non-contextually created {@link java.sql.Clob} instances..`
	`8`	`+ * Marker interface for non-contextually created {@link java.sql.Clob} instances.`
`9`	`9`	`*`
`10`	`10`	`* @author Steve Ebersole`
`11`	`11`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`
`13`	`13`	`/**`
`14`	`14`	`* {@link LobCreator} implementation using non-contextual or local creation, meaning that we generate the LOB`
`15`		`- * references ourselves as opposed to delegating to the JDBC {@link java.sql.Connection}.`
	`15`	`+ * references ourselves as opposed to delegating to the {@linkplain java.sql.Connection JDBC connection}.`
`16`	`16`	`*`
`17`	`17`	`* @author Steve Ebersole`
`18`	`18`	`* @author Gail Badner`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@`
`9`	`9`	`import java.sql.NClob;`
`10`	`10`
`11`	`11`	`/**`
`12`		`- * Manages aspects of proxying java.sql.NClobs to add serializability.`
	`12`	`+ * Manages aspects of proxying {@link NClob}s to add serializability.`
`13`	`13`	`*`
`14`	`14`	`* @author Steve Ebersole`
`15`	`15`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -9,11 +9,11 @@`
`9`	`9`	`import java.io.Serializable;`
`10`	`10`
`11`	`11`	`/**`
`12`		`- * Models size restrictions/requirements on a column's datatype.`
	`12`	`+ * Models size restrictions/requirements on a column's data type.`
`13`	`13`	`*`
`14`		`- * @implNote Since we do not necessarily know the datatype up front, and therefore do not necessarily know`
	`14`	`+ * @implNote Since we do not necessarily know the data type up front, and therefore do not necessarily know`
`15`	`15`	`* whether length or precision/scale sizing is needed, we simply account for both here. Additionally, LOB`
`16`		`- * sizes, by standard, are allowed a "multiplier", {@code K} (Kb), {@code M} (Mb) or {@code G} (Gb).`
	`16`	`+ * sizes, by standard, are allowed a "multiplier", i.e., {@code K} (Kb), {@code M} (Mb) or {@code G} (Gb).`
`17`	`17`	`*`
`18`	`18`	`* @author Steve Ebersole`
`19`	`19`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`import org.hibernate.jdbc.Expectations;`
`9`	`9`
`10`	`10`	`/**`
`11`		`- * Normal implementation of BatchKey`
	`11`	`+ * Normal implementation of {@link BatchKey}`
`12`	`12`	`*`
`13`	`13`	`* @author Steve Ebersole`
`14`	`14`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@`
`20`	`20`	`import static org.hibernate.internal.util.StringHelper.nullIfEmpty;`
`21`	`21`
`22`	`22`	`/**`
`23`		`- * Standard implementation of DatabaseConnectionInfo`
	`23`	`+ * Standard implementation of {@link DatabaseConnectionInfo}`
`24`	`24`	`*`
`25`	`25`	`* @author Jan Schatteman`
`26`	`26`	`*/`