diff --git a/hibernate-core/src/main/java/org/hibernate/LockOptions.java b/hibernate-core/src/main/java/org/hibernate/LockOptions.java index 31bb90e4f8..98367f118e 100644 --- a/hibernate-core/src/main/java/org/hibernate/LockOptions.java +++ b/hibernate-core/src/main/java/org/hibernate/LockOptions.java @@ -153,9 +153,9 @@ public class LockOptions implements Serializable { /** * Determine the {@link LockMode} to apply to the given alias. If no - * mode was explicitly {@link #setAliasSpecificLockMode set}, the - * {@link #getLockMode overall mode} is returned. If the overall lock mode is - * {@code null} as well, {@link LockMode#NONE} is returned. + * mode was explicitly {@linkplain #setAliasSpecificLockMode set}, the + * {@linkplain #getLockMode overall mode} is returned. If the overall + * lock mode is {@code null} as well, {@link LockMode#NONE} is returned. *

* Differs from {@link #getAliasSpecificLockMode} in that here we fallback to we only return * the overall lock mode. diff --git a/hibernate-core/src/main/java/org/hibernate/Session.java b/hibernate-core/src/main/java/org/hibernate/Session.java index 8b4ae83d42..86c8db9e58 100644 --- a/hibernate-core/src/main/java/org/hibernate/Session.java +++ b/hibernate-core/src/main/java/org/hibernate/Session.java @@ -45,17 +45,17 @@ import org.hibernate.stat.SessionStatistics; * flushed to the database. This process of automatic change detection is called * dirty checking and can be expensive in some circumstances. Dirty checking * may be disabled by marking an entity as read-only using - * {@link #setReadOnly(Object, boolean)} or simply by {@link #detach(Object) evicting} + * {@link #setReadOnly(Object, boolean)} or simply by {@linkplain #detach(Object) evicting} * it from the persistence context. A session may be set to load entities as read-only - * {@link #setDefaultReadOnly(boolean) by default}, or this may be controlled at the - * {@link Query#setReadOnly(boolean) query level}. + * {@linkplain #setDefaultReadOnly(boolean) by default}, or this may be controlled at the + * {@linkplain Query#setReadOnly(boolean) query level}. *

* The state of a transient or detached instance may be made persistent by copying it to * a persistent instance using {@link #merge(Object)}. All older operations which moved a * detached instance to the persistent state are now deprecated, and clients should now * migrate to the use of {@code merge()}. *

- * From {@link FlushMode time to time}, the session performs a {@link #flush() flushing} + * From {@link FlushMode time to time}, the session performs a {@linkplain #flush() flushing} * operation, and synchronizes state held in memory with persistent state held in the * database by executing SQL {@code insert}, {@code update}, and {@code delete} statements. * Note that SQL statements are often not executed synchronously by the methods of the @@ -603,7 +603,7 @@ public interface Session extends SharedSessionContract, EntityManager { * For entities with a {@link jakarta.persistence.GeneratedValue generated id}, * {@code persist()} ultimately results in generation of an identifier for the * given instance. But this may happen asynchronously, when the session is - * {@link #flush() flushed}, depending on the identifier generation strategy. + * {@linkplain #flush() flushed}, depending on the identifier generation strategy. * * @param object a transient instance to be made persistent */ @@ -617,7 +617,7 @@ public interface Session extends SharedSessionContract, EntityManager { * For entities with a {@link jakarta.persistence.GeneratedValue generated id}, * {@code persist()} ultimately results in generation of an identifier for the * given instance. But this may happen asynchronously, when the session is - * {@link #flush() flushed}, depending on the identifier generation strategy. + * {@linkplain #flush() flushed}, depending on the identifier generation strategy. * * @param entityName the entity name * @param object a transient instance to be made persistent @@ -701,10 +701,10 @@ public interface Session extends SharedSessionContract, EntityManager { *

* Timeout and scope are ignored if the specified {@code LockMode} represents a - * form of {@link LockMode#OPTIMISTIC optimistic} locking. + * form of {@linkplain LockMode#OPTIMISTIC optimistic} locking. *

* Call {@link LockRequest#lock(Object)} to actually obtain the requested lock * on a managed entity instance. @@ -723,8 +723,8 @@ public interface Session extends SharedSessionContract, EntityManager { * from the underlying database. This may be useful: *

* This operation cascades to associated instances if the association is mapped @@ -739,8 +739,8 @@ public interface Session extends SharedSessionContract, EntityManager { * from the underlying database. This may be useful: * * This operation cascades to associated instances if the association is mapped @@ -1070,7 +1070,7 @@ public interface Session extends SharedSessionContract, EntityManager { NaturalIdMultiLoadAccess byMultipleNaturalId(String entityName); /** - * Enable the named {@link Filter filter} for this current session. + * Enable the named {@linkplain Filter filter} for this current session. * * @param filterName the name of the filter to be enabled. * @@ -1079,7 +1079,7 @@ public interface Session extends SharedSessionContract, EntityManager { Filter enableFilter(String filterName); /** - * Retrieve a currently enabled {@link Filter filter} by name. + * Retrieve a currently enabled {@linkplain Filter filter} by name. * * @param filterName the name of the filter to be retrieved. * @@ -1088,14 +1088,14 @@ public interface Session extends SharedSessionContract, EntityManager { Filter getEnabledFilter(String filterName); /** - * Disable the named {@link Filter filter} for the current session. + * Disable the named {@linkplain Filter filter} for the current session. * * @param filterName the name of the filter to be disabled. */ void disableFilter(String filterName); /** - * Get the {@link SessionStatistics statistics} for this session. + * Get the {@linkplain SessionStatistics statistics} for this session. * * @return the session statistics being collected for this session */ diff --git a/hibernate-core/src/main/java/org/hibernate/SessionFactory.java b/hibernate-core/src/main/java/org/hibernate/SessionFactory.java index 8d848a1ddb..622aa049d6 100644 --- a/hibernate-core/src/main/java/org/hibernate/SessionFactory.java +++ b/hibernate-core/src/main/java/org/hibernate/SessionFactory.java @@ -216,10 +216,10 @@ public interface SessionFactory extends EntityManagerFactory, HibernateEntityMan * connection pools, etc). *

* It is the responsibility of the application to ensure that there are no - * open {@link Session sessions} before calling this method as the impact - * on those {@link Session sessions} is indeterminate. + * open {@linkplain Session sessions} before calling this method as the impact + * on those {@linkplain Session sessions} is indeterminate. *

- * No-ops if already {@link #isClosed closed}. + * No-ops if already {@linkplain #isClosed() closed}. * * @throws HibernateException Indicates an issue closing the factory. */ diff --git a/hibernate-core/src/main/java/org/hibernate/Transaction.java b/hibernate-core/src/main/java/org/hibernate/Transaction.java index 8f984e1d17..01f6465961 100644 --- a/hibernate-core/src/main/java/org/hibernate/Transaction.java +++ b/hibernate-core/src/main/java/org/hibernate/Transaction.java @@ -39,7 +39,7 @@ import org.hibernate.resource.transaction.spi.TransactionStatus; */ public interface Transaction extends EntityTransaction { /** - * Get the current {@link TransactionStatus status} of this transaction. + * Get the current {@linkplain TransactionStatus status} of this transaction. */ TransactionStatus getStatus(); diff --git a/hibernate-core/src/main/java/org/hibernate/boot/MetadataSources.java b/hibernate-core/src/main/java/org/hibernate/boot/MetadataSources.java index a2cdfe80f1..7c4a2d2dc8 100644 --- a/hibernate-core/src/main/java/org/hibernate/boot/MetadataSources.java +++ b/hibernate-core/src/main/java/org/hibernate/boot/MetadataSources.java @@ -389,7 +389,7 @@ public class MetadataSources implements Serializable { } /** - * Add XML mapping bindings created from an arbitrary source by the {@link #getXmlMappingBinderAccess() binder}. + * Add XML mapping bindings created from an arbitrary source by the {@linkplain #getXmlMappingBinderAccess() binder}. * * @param binding The binding. * diff --git a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/EntitySource.java b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/EntitySource.java index 7b224ad08a..f9c0dfc03b 100644 --- a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/EntitySource.java +++ b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/EntitySource.java @@ -51,7 +51,7 @@ public interface EntitySource extends IdentifiableTypeSource, ToolingHintContext boolean isLazy(); /** - * For {@link #isLazy() lazy} entities, obtain the interface to use in constructing its proxies. + * For {@linkplain #isLazy() lazy} entities, obtain the interface to use in constructing its proxies. * * @return The proxy interface name */ diff --git a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceAggregatedComposite.java b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceAggregatedComposite.java index e916b783a5..458775b28c 100644 --- a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceAggregatedComposite.java +++ b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceAggregatedComposite.java @@ -10,7 +10,7 @@ import java.util.List; /** * Additional contract describing the source of an identifier mapping whose - * {@link #getNature() nature} is + * {@linkplain #getNature() nature} is * {@link org.hibernate.id.EntityIdentifierNature#AGGREGATED_COMPOSITE}. *

* This equates to an identifier which is made up of multiple values which are diff --git a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceNonAggregatedComposite.java b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceNonAggregatedComposite.java index dab1693f68..3746caab5c 100644 --- a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceNonAggregatedComposite.java +++ b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceNonAggregatedComposite.java @@ -9,8 +9,8 @@ package org.hibernate.boot.model.source.spi; import java.util.List; /** - * Additional contract describing the source of an identifier mapping whose {@link #getNature() nature} is - * {@link org.hibernate.id.EntityIdentifierNature#NON_AGGREGATED_COMPOSITE }. + * Additional contract describing the source of an identifier mapping whose {@linkplain #getNature() nature} is + * {@link org.hibernate.id.EntityIdentifierNature#NON_AGGREGATED_COMPOSITE}. *

* Think {@link jakarta.persistence.IdClass} * diff --git a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceSimple.java b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceSimple.java index 449f163645..dcb09b8edf 100644 --- a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceSimple.java +++ b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/IdentifierSourceSimple.java @@ -7,8 +7,8 @@ package org.hibernate.boot.model.source.spi; /** - * Additional contract describing the source of an identifier mapping whose {@link #getNature() nature} is - * {@link org.hibernate.id.EntityIdentifierNature#SIMPLE simple}. + * Additional contract describing the source of an identifier mapping whose {@linkplain #getNature() nature} is + * {@linkplain org.hibernate.id.EntityIdentifierNature#SIMPLE simple}. * * @author Steve Ebersole */ diff --git a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/JdbcDataType.java b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/JdbcDataType.java index e66e9948c7..e556504652 100644 --- a/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/JdbcDataType.java +++ b/hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/JdbcDataType.java @@ -7,7 +7,7 @@ package org.hibernate.boot.model.source.spi; /** - * Models a JDBC {@link java.sql.Types DATATYPE}. Mainly breaks down into 3 pieces of information: