Hibernate
/
hibernate-orm
mirror of https://github.com/hibernate/hibernate-orm
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

HHH-14640 : Fix checkstyle errors

This commit is contained in:
Andrea Boriero 2021-05-26 15:25:51 +02:00 committed by gbadner
parent cc6fe84f30
commit b3ae29406a
67 changed files with 144 additions and 140 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
hibernate-core/src/main/java/org/hibernate/action/internal/AbstractEntityInsertAction.java
View File

@ -67,7 +67,7 @@ public abstract class AbstractEntityInsertAction extends EntityAction {
* entity state. * entity state.
* @return the entity state. * @return the entity state.
* *
* @see {@link #nullifyTransientReferencesIfNotAlready} * @see #nullifyTransientReferencesIfNotAlready
*/ */
public Object[] getState() { public Object[] getState() {
return state; return state;
@ -106,7 +106,7 @@ public abstract class AbstractEntityInsertAction extends EntityAction {
* called for a this object, so it can safely be called both when * called for a this object, so it can safely be called both when
* the entity is made "managed" and when this action is executed. * the entity is made "managed" and when this action is executed.
* *
* @see {@link #makeEntityManaged() } * @see #makeEntityManaged()
*/ */
protected final void nullifyTransientReferencesIfNotAlready() { protected final void nullifyTransientReferencesIfNotAlready() {
if ( ! areTransientReferencesNullified ) { if ( ! areTransientReferencesNullified ) {

24
hibernate-core/src/main/java/org/hibernate/annotations/BatchSize.java
View File

@ -16,20 +16,20 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
/** /**
* Defines size for batch loading of collections or lazy entities. For example... * Defines size for batch loading of collections or lazy entities. For example...
* <blockquote><pre> * <blockquote><pre>{@code
* &#064;Entity * @Entity
* &#064;BatchSize(size=100) * @BatchSize(size=100)
* class Product { * class Product {
* ... * ...
* } * }
* </pre></blockquote> * }</pre></blockquote>
* will initialize up to 100 lazy Product entity proxies at a time. * will initialize up to 100 lazy Product entity proxies at a time.
* *
* <blockquote><pre> * <blockquote><pre>{@code
* &#064;OneToMany * @OneToMany
* &#064;BatchSize(size = 5) / * @BatchSize(size = 5) /
* Set<Product> getProducts() { ... }; * Set<Product> getProducts() { ... };
* </pre></blockquote> * }</pre></blockquote>
* will initialize up to 5 lazy collections of products at a time * will initialize up to 5 lazy collections of products at a time
* *
* @author Emmanuel Bernard * @author Emmanuel Bernard

2
hibernate-core/src/main/java/org/hibernate/annotations/Sort.java
View File

@ -34,7 +34,7 @@ public @interface Sort {
/** /**
* Specifies the comparator to use. Only valid when {@link #type} specifies {@link SortType#COMPARATOR}. * Specifies the comparator to use. Only valid when {@link #type} specifies {@link SortType#COMPARATOR}.
* *
* TODO find a way to use Class<Comparator> -> see HHH-8164 * TODO find a way to use {@code Class<Comparator>} -> see HHH-8164
*/ */
Class comparator() default void.class; Class comparator() default void.class;
} }

2
hibernate-core/src/main/java/org/hibernate/boot/internal/InFlightMetadataCollectorImpl.java
View File

@ -1780,7 +1780,7 @@ public class InFlightMetadataCollectorImpl implements InFlightMetadataCollector
* <p/> * <p/>
* See <tt>ANN-722</tt> and <tt>ANN-730</tt> * See <tt>ANN-722</tt> and <tt>ANN-730</tt>
* *
* @param orderedFkSecondPasses The list containing the <code>FkSecondPass<code> instances ready * @param orderedFkSecondPasses The list containing the <code>FkSecondPass</code> instances ready
* for processing. * for processing.
* @param isADependencyOf Our lookup data structure to determine dependencies between tables * @param isADependencyOf Our lookup data structure to determine dependencies between tables
* @param startTable Table name to start recursive algorithm. * @param startTable Table name to start recursive algorithm.

6
hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/FilterSource.java
View File

@ -9,7 +9,7 @@ package org.hibernate.boot.model.source.spi;
import java.util.Map; import java.util.Map;
/** /**
* Defines the source of filter information. May have an associated {@link FilterDefinitionSource}. * Defines the source of filter information. May have an associated {@link org.hibernate.engine.spi.FilterDefinition}.
* Relates to both {@code <filter/>} and {@link org.hibernate.annotations.Filter @Filter} * Relates to both {@code <filter/>} and {@link org.hibernate.annotations.Filter @Filter}
* *
* @author Steve Ebersole * @author Steve Ebersole
@ -28,12 +28,12 @@ public interface FilterSource {
* *
* @return The condition defined on the filter. * @return The condition defined on the filter.
* *
* @see {@link FilterDefinitionSource#getCondition()} * @see org.hibernate.boot.model.source.internal.hbm.FilterSourceImpl#getCondition()
*/ */
public String getCondition(); public String getCondition();
/** /**
* Should Hibernate perform automatic alias injection into the supplied condition string? The default it to * Should Hibernate perform automatic alias injection into the supplied condition string? The default is to
* perform auto injection *unless* explicit alias(es) are supplied. * perform auto injection *unless* explicit alias(es) are supplied.
* *
* @return {@code true} indicates auto injection should occur; {@code false} that it should not * @return {@code true} indicates auto injection should occur; {@code false} that it should not

2
hibernate-core/src/main/java/org/hibernate/boot/model/source/spi/SingularAttributeSourceAny.java
View File

@ -7,7 +7,7 @@
package org.hibernate.boot.model.source.spi; package org.hibernate.boot.model.source.spi;
/** /**
* Describes an {@link <any/>} mapping * Describes an {@code <any/>} mapping
* *
* @author Steve Ebersole * @author Steve Ebersole
*/ */

2
hibernate-core/src/main/java/org/hibernate/bytecode/enhance/spi/CollectionTracker.java
View File

@ -7,7 +7,7 @@
package org.hibernate.bytecode.enhance.spi; package org.hibernate.bytecode.enhance.spi;
/** /**
* Interface to be implemented by collection trackers that hold the expected size od collections, a simplified Map<String, int>. * Interface to be implemented by collection trackers that hold the expected size od collections, a simplified {@code Map<String, int>}.
* *
* @author <a href="mailto:lbarreiro@redhat.com">Luis Barreiro</a> * @author <a href="mailto:lbarreiro@redhat.com">Luis Barreiro</a>
*/ */

14
hibernate-core/src/main/java/org/hibernate/cache/spi/access/NaturalIdDataAccess.java vendored
View File

@ -16,10 +16,10 @@ import org.hibernate.persister.entity.EntityPersister;
* <li><b>INSERTS</b> : {@link #insert} -> {@link #afterInsert}</li> * <li><b>INSERTS</b> : {@link #insert} -> {@link #afterInsert}</li>
* <li><b>UPDATES</b> : {@link #lockItem} -> {@link #remove} -> {@link #update} -> {@link #afterUpdate}</li> * <li><b>UPDATES</b> : {@link #lockItem} -> {@link #remove} -> {@link #update} -> {@link #afterUpdate}</li>
* <li><b>DELETES</b> : {@link #lockItem} -> {@link #remove} -> {@link #unlockItem}</li> * <li><b>DELETES</b> : {@link #lockItem} -> {@link #remove} -> {@link #unlockItem}</li>
* <li><b>LOADS</b> : {@link @putFromLoad}</li> * <li><b>LOADS</b> : {@link #putFromLoad}</li>
* </ul> * </ul>
* Note the special case of <b>UPDATES</b> above. Because the cache key itself has changed here we need to remove the * Note the special case of <b>UPDATES</b> above. Because the cache key itself has changed here we need to remove the
* old entry as well as * old entry as well
* <p/> * <p/>
* There is another usage pattern that is used to invalidate entries * There is another usage pattern that is used to invalidate entries
* afterQuery performing "bulk" HQL/SQL operations: * afterQuery performing "bulk" HQL/SQL operations:
@ -44,7 +44,7 @@ public interface NaturalIdDataAccess extends CachedDomainDataAccess {
* @param naturalIdValues the sequence of values which unequivocally identifies a cached element on this region * @param naturalIdValues the sequence of values which unequivocally identifies a cached element on this region
* @param rootEntityDescriptor the persister of the element being cached * @param rootEntityDescriptor the persister of the element being cached
* *
* @return a key which can be used to identify this an element unequivocally on this same region * @return a key which can be used to identify an element unequivocally on this same region
*/ */
Object generateCacheKey( Object generateCacheKey(
Object[] naturalIdValues, Object[] naturalIdValues,
@ -69,7 +69,7 @@ public interface NaturalIdDataAccess extends CachedDomainDataAccess {
* @param key The item key * @param key The item key
* @param value The item * @param value The item
* *
* @return Were the contents of the cache actual changed by this operation? * @return Were the contents of the cache actually changed by this operation?
* *
* @throws CacheException Propagated from underlying cache provider * @throws CacheException Propagated from underlying cache provider
*/ */
@ -84,7 +84,7 @@ public interface NaturalIdDataAccess extends CachedDomainDataAccess {
* @param key The item key * @param key The item key
* @param value The item * @param value The item
* *
* @return Were the contents of the cache actual changed by this operation? * @return Were the contents of the cache actually changed by this operation?
* *
* @throws CacheException Propagated from underlying cache provider * @throws CacheException Propagated from underlying cache provider
*/ */
@ -99,7 +99,7 @@ public interface NaturalIdDataAccess extends CachedDomainDataAccess {
* @param key The item key * @param key The item key
* @param value The item * @param value The item
* *
* @return Were the contents of the cache actual changed by this operation? * @return Were the contents of the cache actually changed by this operation?
* *
* @throws CacheException Propagated from underlying cache provider * @throws CacheException Propagated from underlying cache provider
*/ */
@ -115,7 +115,7 @@ public interface NaturalIdDataAccess extends CachedDomainDataAccess {
* @param value The item * @param value The item
* @param lock The lock previously obtained from {@link #lockItem} * @param lock The lock previously obtained from {@link #lockItem}
* *
* @return Were the contents of the cache actual changed by this operation? * @return Were the contents of the cache actually changed by this operation?
* *
* @throws CacheException Propagated from underlying cache provider * @throws CacheException Propagated from underlying cache provider
*/ */

2
hibernate-core/src/main/java/org/hibernate/collection/internal/AbstractPersistentCollection.java
View File

@ -88,7 +88,7 @@ public abstract class AbstractPersistentCollection implements Serializable, Pers
} }
/** /**
* * @deprecated {@link #AbstractPersistentCollection(SharedSessionContractImplementor)} should be used instead. * @deprecated {@link #AbstractPersistentCollection(SharedSessionContractImplementor)} should be used instead.
*/ */
@Deprecated @Deprecated
protected AbstractPersistentCollection(SessionImplementor session) { protected AbstractPersistentCollection(SessionImplementor session) {

4
hibernate-core/src/main/java/org/hibernate/dialect/AbstractHANADialect.java
View File

@ -112,8 +112,8 @@ import org.hibernate.type.descriptor.sql.VarcharTypeDescriptor;
* <p> * <p>
* Note: This dialect is configured to create foreign keys with {@code on update cascade}. * Note: This dialect is configured to create foreign keys with {@code on update cascade}.
* *
* @author Andrew Clemons <andrew.clemons@sap.com> * @author <a href="mailto:andrew.clemons@sap.com">Andrew Clemons</a>
* @author Jonathan Bregler <jonathan.bregler@sap.com> * @author <a href="mailto:jonathan.bregler@sap.com">Jonathan Bregler</a>
*/ */
public abstract class AbstractHANADialect extends Dialect { public abstract class AbstractHANADialect extends Dialect {

4
hibernate-core/src/main/java/org/hibernate/dialect/Cache71Dialect.java
View File

@ -49,7 +49,7 @@ import org.hibernate.type.StandardBasicTypes;
/** /**
* Cach&eacute; 2007.1 dialect. * Cach&eacute; 2007.1 dialect.
* *
* This class is required in order to use Hibernate with Intersystems Cach&eacute; SQL. Compatible with * This class is required in order to use Hibernate with InterSystems Cach&eacute; SQL. Compatible with
* Cach&eacute; 2007.1. * Cach&eacute; 2007.1.
* *
* <h2>PREREQUISITES</h2> * <h2>PREREQUISITES</h2>
@ -102,7 +102,7 @@ import org.hibernate.type.StandardBasicTypes;
* For example, in Hibernate 3.2, typical entries in hibernate.properties would have the following * For example, in Hibernate 3.2, typical entries in hibernate.properties would have the following
* "name=value" pairs: * "name=value" pairs:
* <p/> * <p/>
* <table cols=3 border cellpadding=5 cellspacing=0> * <table cols=3 border="" cellpadding=5 cellspacing=0>
* <tr> * <tr>
* <th>Property Name</th> * <th>Property Name</th>
* <th>Property Value</th> * <th>Property Value</th>

6
hibernate-core/src/main/java/org/hibernate/dialect/Dialect.java
View File

@ -336,7 +336,7 @@ public abstract class Dialect implements ConversionContext {
/** /**
* Get the name of the database type associated with the given * Get the name of the database type associated with the given
* {@link java.sql.Types} typecode with the given storage specification * {@link Types} typecode with the given storage specification
* parameters. * parameters.
* *
* @param code The {@link java.sql.Types} typecode * @param code The {@link java.sql.Types} typecode
@ -1655,7 +1655,7 @@ public abstract class Dialect implements ConversionContext {
* @return The Dialect's preferred SQLExceptionConverter, or null to * @return The Dialect's preferred SQLExceptionConverter, or null to
* indicate that the default {@link SQLExceptionConverter} should be used. * indicate that the default {@link SQLExceptionConverter} should be used.
* *
* @see {@link #buildSQLExceptionConversionDelegate()} * @see #buildSQLExceptionConversionDelegate()
* @deprecated {@link #buildSQLExceptionConversionDelegate()} should be * @deprecated {@link #buildSQLExceptionConversionDelegate()} should be
* overridden instead. * overridden instead.
*/ */
@ -2510,7 +2510,7 @@ public abstract class Dialect implements ConversionContext {
* Are subselects supported as the left-hand-side (LHS) of * Are subselects supported as the left-hand-side (LHS) of
* IN-predicates. * IN-predicates.
* <p/> * <p/>
* In other words, is syntax like "... <subquery> IN (1, 2, 3) ..." supported? * In other words, is syntax like {@code ... <subquery> IN (1, 2, 3) ...} supported?
* *
* @return True if subselects can appear as the LHS of an in-predicate; * @return True if subselects can appear as the LHS of an in-predicate;
* false otherwise. * false otherwise.

4
hibernate-core/src/main/java/org/hibernate/dialect/HANAColumnStoreDialect.java
View File

@ -22,8 +22,8 @@ import org.hibernate.hql.spi.id.local.AfterUseAction;
* <p> * <p>
* Column tables are created by this dialect when using the auto-ddl feature. * Column tables are created by this dialect when using the auto-ddl feature.
* *
* @author Andrew Clemons <andrew.clemons@sap.com> * @author <a href="mailto:andrew.clemons@sap.com">Andrew Clemons</a>
* @author Jonathan Bregler <jonathan.bregler@sap.com> * @author <a href="mailto:jonathan.bregler@sap.com">Jonathan Bregler</a>
*/ */
public class HANAColumnStoreDialect extends AbstractHANADialect { public class HANAColumnStoreDialect extends AbstractHANADialect {

4
hibernate-core/src/main/java/org/hibernate/dialect/HANARowStoreDialect.java
View File

@ -22,8 +22,8 @@ import org.hibernate.hql.spi.id.local.AfterUseAction;
* <p> * <p>
* Row tables are created by this dialect when using the auto-ddl feature. * Row tables are created by this dialect when using the auto-ddl feature.
* *
* @author Andrew Clemons <andrew.clemons@sap.com> * @author <a href="mailto:andrew.clemons@sap.com">Andrew Clemons</a>
* @author Jonathan Bregler <jonathan.bregler@sap.com> * @author <a href="mailto:jonathan.bregler@sap.com">Jonathan Bregler</a>
*/ */
public class HANARowStoreDialect extends AbstractHANADialect { public class HANARowStoreDialect extends AbstractHANADialect {

6
hibernate-core/src/main/java/org/hibernate/dialect/MimerSQLDialect.java
View File

@ -18,7 +18,7 @@ import org.hibernate.type.StandardBasicTypes;
* An Hibernate 3 SQL dialect for Mimer SQL. This dialect requires Mimer SQL 9.2.1 or later * An Hibernate 3 SQL dialect for Mimer SQL. This dialect requires Mimer SQL 9.2.1 or later
* because of the mappings to NCLOB, BINARY, and BINARY VARYING. * because of the mappings to NCLOB, BINARY, and BINARY VARYING.
* *
* @author Fredrik lund <fredrik.alund@mimer.se> * @author <a href="mailto:fredrik.alund@mimer.se">Fredrik lund</a>
*/ */
@SuppressWarnings("deprecation") @SuppressWarnings("deprecation")
public class MimerSQLDialect extends Dialect { public class MimerSQLDialect extends Dialect {
@ -27,8 +27,8 @@ public class MimerSQLDialect extends Dialect {
private static final int BINARY_MAX_LENGTH = 2000; private static final int BINARY_MAX_LENGTH = 2000;
/** /**
* Even thoug Mimer SQL supports character and binary columns up to 15 000 in lenght, * Even though Mimer SQL supports character and binary columns up to 15 000 in length,
* this is also the maximum width of the table (exluding LOBs). To avoid breaking the limit all the * this is also the maximum width of the table (excluding LOBs). To avoid breaking the limit all the
* time we limit the length of the character columns to CHAR_MAX_LENTH, NATIONAL_CHAR_LENGTH for national * time we limit the length of the character columns to CHAR_MAX_LENTH, NATIONAL_CHAR_LENGTH for national
* characters, and BINARY_MAX_LENGTH for binary types. * characters, and BINARY_MAX_LENGTH for binary types.
*/ */

4
hibernate-core/src/main/java/org/hibernate/dialect/TeradataDialect.java
View File

@ -65,7 +65,7 @@ public class TeradataDialect extends Dialect implements IdTableSupport {
// bit_length feels a bit broken to me. We have to cast to char in order to // bit_length feels a bit broken to me. We have to cast to char in order to
// pass when a numeric value is supplied. But of course the answers given will // pass when a numeric value is supplied. But of course the answers given will
// be wildly different for these two datatypes. 1234.5678 will be 9 bytes as // be wildly different for these two data types. 1234.5678 will be 9 bytes as
// a char string but will be 8 or 16 bytes as a true numeric. // a char string but will be 8 or 16 bytes as a true numeric.
// Jay Nance 2006-09-22 // Jay Nance 2006-09-22
registerFunction( registerFunction(
@ -103,7 +103,7 @@ public class TeradataDialect extends Dialect implements IdTableSupport {
/** /**
* Does this dialect support the <tt>FOR UPDATE</tt> syntax? * Does this dialect support the <tt>FOR UPDATE</tt> syntax?
* *
* @return empty string ... Teradata does not support <tt>FOR UPDATE<tt> syntax * @return empty string ... Teradata does not support <tt>FOR UPDATE</tt> syntax
*/ */
@Override @Override
public String getForUpdateString() { public String getForUpdateString() {

4
hibernate-core/src/main/java/org/hibernate/engine/internal/AbstractEntityEntry.java
View File

@ -37,9 +37,9 @@ import org.hibernate.pretty.MessageHelper;
* A base implementation of EntityEntry * A base implementation of EntityEntry
* *
* @author Gavin King * @author Gavin King
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
* @author Gunnar Morling * @author Gunnar Morling
* @author Sanne Grinovero <sanne@hibernate.org> * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero </a>
*/ */
public abstract class AbstractEntityEntry implements Serializable, EntityEntry { public abstract class AbstractEntityEntry implements Serializable, EntityEntry {
protected final Serializable id; protected final Serializable id;

2
hibernate-core/src/main/java/org/hibernate/engine/internal/EntityEntryExtraStateHolder.java
View File

@ -11,7 +11,7 @@ import org.hibernate.engine.spi.EntityEntryExtraState;
/** /**
* Contains optional state from {@link org.hibernate.engine.spi.EntityEntry}. * Contains optional state from {@link org.hibernate.engine.spi.EntityEntry}.
* *
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
*/ */
public class EntityEntryExtraStateHolder implements EntityEntryExtraState { public class EntityEntryExtraStateHolder implements EntityEntryExtraState {
private EntityEntryExtraState next; private EntityEntryExtraState next;

6
hibernate-core/src/main/java/org/hibernate/engine/internal/ImmutableEntityEntry.java
View File

@ -22,12 +22,12 @@ import org.hibernate.persister.entity.EntityPersister;
/** /**
* An EntityEntry implementation for immutable entities. Note that this implementation is not completely * An EntityEntry implementation for immutable entities. Note that this implementation is not completely
* immutable in terms of its internal state; the term immutable here refers to the entity is describes. * immutable in terms of its internal state; the term immutable here refers to the entity it describes.
* *
* @author Gavin King * @author Gavin King
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
* @author Gunnar Morling * @author Gunnar Morling
* @author Sanne Grinovero <sanne@hibernate.org> * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero </a>
* *
* @see org.hibernate.annotations.Immutable * @see org.hibernate.annotations.Immutable
*/ */

4
hibernate-core/src/main/java/org/hibernate/engine/internal/MutableEntityEntry.java
View File

@ -22,9 +22,9 @@ import org.hibernate.persister.entity.EntityPersister;
* An EntityEntry implementation for mutable entities. * An EntityEntry implementation for mutable entities.
* *
* @author Gavin King * @author Gavin King
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
* @author Gunnar Morling * @author Gunnar Morling
* @author Sanne Grinovero <sanne@hibernate.org> * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero </a>
*/ */
public final class MutableEntityEntry extends AbstractEntityEntry { public final class MutableEntityEntry extends AbstractEntityEntry {
/** /**

2
hibernate-core/src/main/java/org/hibernate/engine/jdbc/SerializableBlobProxy.java
View File

@ -31,7 +31,7 @@ public class SerializableBlobProxy implements InvocationHandler, Serializable {
* Builds a serializable {@link Blob} wrapper around the given {@link Blob}. * Builds a serializable {@link Blob} wrapper around the given {@link Blob}.
* *
* @param blob The {@link Blob} to be wrapped. * @param blob The {@link Blob} to be wrapped.
* @see * @see #generateProxy(java.sql.Blob)
*/ */
private SerializableBlobProxy(Blob blob) { private SerializableBlobProxy(Blob blob) {
this.blob = blob; this.blob = blob;

6
hibernate-core/src/main/java/org/hibernate/engine/spi/ActionQueue.java
View File

@ -1101,12 +1101,12 @@ public class ActionQueue {
} }
/** /**
* Check if the this {@link BatchIdentifier} has a parent or grand parent * Check if this {@link BatchIdentifier} has a parent or grand parent
* matching the given {@link BatchIdentifier reference. * matching the given {@link BatchIdentifier} reference.
* *
* @param batchIdentifier {@link BatchIdentifier} reference * @param batchIdentifier {@link BatchIdentifier} reference
* *
* @return This {@link BatchIdentifier} has a parent matching the given {@link BatchIdentifier reference * @return This {@link BatchIdentifier} has a parent matching the given {@link BatchIdentifier} reference
*/ */
boolean hasParent(BatchIdentifier batchIdentifier) { boolean hasParent(BatchIdentifier batchIdentifier) {
return ( return (

4
hibernate-core/src/main/java/org/hibernate/engine/spi/BatchFetchQueue.java
View File

@ -40,7 +40,7 @@ public class BatchFetchQueue {
/** /**
* A map of {@link SubselectFetch subselect-fetch descriptors} keyed by the * A map of {@link SubselectFetch subselect-fetch descriptors} keyed by the
* {@link EntityKey) against which the descriptor is registered. * {@link EntityKey} against which the descriptor is registered.
*/ */
private Map<EntityKey, SubselectFetch> subselectsByEntityKey; private Map<EntityKey, SubselectFetch> subselectsByEntityKey;
@ -97,7 +97,7 @@ public class BatchFetchQueue {
} }
/** /**
* Adds a subselect fetch decriptor for the given entity key. * Adds a subselect fetch descriptor for the given entity key.
* *
* @param key The entity for which to register the subselect fetch. * @param key The entity for which to register the subselect fetch.
* @param subquery The fetch descriptor. * @param subquery The fetch descriptor.

4
hibernate-core/src/main/java/org/hibernate/engine/spi/EntityEntry.java
View File

@ -21,9 +21,9 @@ import org.hibernate.persister.entity.EntityPersister;
* therefore we need to take care of its impact on memory consumption. * therefore we need to take care of its impact on memory consumption.
* *
* @author Gavin King * @author Gavin King
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
* @author Gunnar Morling * @author Gunnar Morling
* @author Sanne Grinovero <sanne@hibernate.org> * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero </a>
*/ */
public interface EntityEntry { public interface EntityEntry {
LockMode getLockMode(); LockMode getLockMode();

2
hibernate-core/src/main/java/org/hibernate/engine/spi/EntityEntryExtraState.java
View File

@ -10,7 +10,7 @@ package org.hibernate.engine.spi;
/** /**
* Navigation methods for extra state objects attached to {@link org.hibernate.engine.spi.EntityEntry}. * Navigation methods for extra state objects attached to {@link org.hibernate.engine.spi.EntityEntry}.
* *
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
*/ */
public interface EntityEntryExtraState { public interface EntityEntryExtraState {

4
hibernate-core/src/main/java/org/hibernate/engine/spi/SessionDelegatorBaseImpl.java
View File

@ -76,7 +76,7 @@ import org.hibernate.type.descriptor.sql.SqlTypeDescriptor;
* API so that only some methods need to be overridden * API so that only some methods need to be overridden
* (Used by Hibernate Search). * (Used by Hibernate Search).
* *
* @author Sanne Grinovero <sanne@hibernate.org> (C) 2012 Red Hat Inc. * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero</a> (C) 2012 Red Hat Inc.
*/ */
@SuppressWarnings("deprecation") @SuppressWarnings("deprecation")
public class SessionDelegatorBaseImpl implements SessionImplementor { public class SessionDelegatorBaseImpl implements SessionImplementor {
@ -107,7 +107,7 @@ public class SessionDelegatorBaseImpl implements SessionImplementor {
} }
/** /**
* Returns the underlying delegate. Be careful that is has a different behavior from the {@link #getDelegate()} * Returns the underlying delegate. Be careful that it has a different behavior from the {@link #getDelegate()}
* method coming from the EntityManager interface which returns the current session. * method coming from the EntityManager interface which returns the current session.
* *
* @see SessionDelegatorBaseImpl#getDelegate() * @see SessionDelegatorBaseImpl#getDelegate()

4
hibernate-core/src/main/java/org/hibernate/engine/spi/SharedSessionContractImplementor.java
View File

@ -113,7 +113,7 @@ public interface SharedSessionContractImplementor
/** /**
* Checks whether the session is closed. Provided separately from * Checks whether the session is closed. Provided separately from
* {@link #isOpen()} as this method does not attempt any JTA synchronization * {@link #isOpen()} as this method does not attempt any JTA synchronization
* registration, where as {@link #isOpen()} does; which makes this one * registration, whereas {@link #isOpen()} does; which makes this one
* nicer to use for most internal purposes. * nicer to use for most internal purposes.
* *
* @return {@code true} if the session is closed; {@code false} otherwise. * @return {@code true} if the session is closed; {@code false} otherwise.
@ -185,7 +185,7 @@ public interface SharedSessionContractImplementor
* Check if an active Transaction is necessary for the update operation to be executed. * Check if an active Transaction is necessary for the update operation to be executed.
* If an active Transaction is necessary but it is not then a TransactionRequiredException is raised. * If an active Transaction is necessary but it is not then a TransactionRequiredException is raised.
* *
* @param exceptionMessage, the message to use for the TransactionRequiredException * @param exceptionMessage the message to use for the TransactionRequiredException
*/ */
default void checkTransactionNeededForUpdateOperation(String exceptionMessage) { default void checkTransactionNeededForUpdateOperation(String exceptionMessage) {
if ( !isTransactionInProgress() ) { if ( !isTransactionInProgress() ) {

14
hibernate-core/src/main/java/org/hibernate/event/internal/MergeContext.java
View File

@ -46,7 +46,7 @@ import org.jboss.logging.Logger;
* <ul> * <ul>
* <li>Methods that return collections (e.g., {@link #keySet()}, * <li>Methods that return collections (e.g., {@link #keySet()},
* {@link #values()}, {@link #entrySet()}) return an * {@link #values()}, {@link #entrySet()}) return an
* unnmodifiable view of the collection;</li> * unmodifiable view of the collection;</li>
* <li>If {@link #put(Object mergeEntity, Object) managedEntity} or * <li>If {@link #put(Object mergeEntity, Object) managedEntity} or
* {@link #put(Object mergeEntity, Object managedEntity, boolean isOperatedOn)} * {@link #put(Object mergeEntity, Object managedEntity, boolean isOperatedOn)}
* is executed and this MergeMap already contains a cross-reference for * is executed and this MergeMap already contains a cross-reference for
@ -73,11 +73,11 @@ import org.jboss.logging.Logger;
* The following method is intended to be used by a merge event listener (and other * The following method is intended to be used by a merge event listener (and other
* classes) in the same package to indicate whether the merge operation is being * classes) in the same package to indicate whether the merge operation is being
* performed on a merge entity already in the MergeContext: * performed on a merge entity already in the MergeContext:
* {@link MergeContext#setOperatedOn(Object mergeEntity, boolean isOperatedOn) * {@link MergeContext#setOperatedOn(Object mergeEntity, boolean isOperatedOn)}
* *
* @author Gail Badner * @author Gail Badner
*/ */
class MergeContext implements Map { public class MergeContext implements Map {
private static final Logger LOG = Logger.getLogger( MergeContext.class ); private static final Logger LOG = Logger.getLogger( MergeContext.class );
private final EventSource session; private final EventSource session;
@ -149,7 +149,7 @@ class MergeContext implements Map {
* Returns an unmodifiable set view of the merge-to-managed entity cross-references contained in this MergeContext. * Returns an unmodifiable set view of the merge-to-managed entity cross-references contained in this MergeContext.
* @return an unmodifiable set view of the merge-to-managed entity cross-references contained in this MergeContext * @return an unmodifiable set view of the merge-to-managed entity cross-references contained in this MergeContext
* *
* @see {@link Collections#unmodifiableSet(java.util.Set)} * @see Collections#unmodifiableSet(java.util.Set)
*/ */
public Set entrySet() { public Set entrySet() {
return Collections.unmodifiableSet( mergeToManagedEntityXref.entrySet() ); return Collections.unmodifiableSet( mergeToManagedEntityXref.entrySet() );
@ -180,7 +180,7 @@ class MergeContext implements Map {
* Returns an unmodifiable set view of the merge entities contained in this MergeContext * Returns an unmodifiable set view of the merge entities contained in this MergeContext
* @return an unmodifiable set view of the merge entities contained in this MergeContext * @return an unmodifiable set view of the merge entities contained in this MergeContext
* *
* @see {@link Collections#unmodifiableSet(java.util.Set)} * @see Collections#unmodifiableSet(java.util.Set)
*/ */
public Set keySet() { public Set keySet() {
return Collections.unmodifiableSet( mergeToManagedEntityXref.keySet() ); return Collections.unmodifiableSet( mergeToManagedEntityXref.keySet() );
@ -319,7 +319,7 @@ class MergeContext implements Map {
* Returns an unmodifiable Set view of managed entities contained in this MergeContext. * Returns an unmodifiable Set view of managed entities contained in this MergeContext.
* @return an unmodifiable Set view of managed entities contained in this MergeContext * @return an unmodifiable Set view of managed entities contained in this MergeContext
* *
* @see {@link Collections#unmodifiableSet(java.util.Set)} * @see Collections#unmodifiableSet(java.util.Set)
*/ */
public Collection values() { public Collection values() {
return Collections.unmodifiableSet( managedToMergeEntityXref.keySet() ); return Collections.unmodifiableSet( managedToMergeEntityXref.keySet() );
@ -367,7 +367,7 @@ class MergeContext implements Map {
* *
* @return an unmodifiable map view of the managed-to-merge entity cross-references. * @return an unmodifiable map view of the managed-to-merge entity cross-references.
* *
* @see {@link Collections#unmodifiableMap(java.util.Map)} * @see Collections#unmodifiableMap(java.util.Map)
*/ */
public Map invertMap() { public Map invertMap() {
return Collections.unmodifiableMap( managedToMergeEntityXref ); return Collections.unmodifiableMap( managedToMergeEntityXref );

4
hibernate-core/src/main/java/org/hibernate/graph/spi/AttributeNodeImplementor.java
View File

@ -10,7 +10,9 @@ import javax.persistence.AttributeNode;
import javax.persistence.metamodel.Attribute; import javax.persistence.metamodel.Attribute;
/** /**
* @author Strong Liu <stliu@hibernate.org> * Integration version of the AttributeNode contract
*
* @author <a href="mailto:stliu@hibernate.org">Strong Liu</a>
*/ */
public interface AttributeNodeImplementor<T> extends AttributeNode<T> { public interface AttributeNodeImplementor<T> extends AttributeNode<T> {
public Attribute<?,T> getAttribute(); public Attribute<?,T> getAttribute();

4
hibernate-core/src/main/java/org/hibernate/graph/spi/GraphNodeImplementor.java
View File

@ -10,7 +10,9 @@ import java.util.List;
import javax.persistence.AttributeNode; import javax.persistence.AttributeNode;
/** /**
* @author Strong Liu <stliu@hibernate.org> * Integration version of the GraphNode contract
*
* @author <a href="mailto:stliu@hibernate.org">Strong Liu</a>
*/ */
public interface GraphNodeImplementor { public interface GraphNodeImplementor {
List<AttributeNodeImplementor<?>> attributeImplementorNodes(); List<AttributeNodeImplementor<?>> attributeImplementorNodes();

2
hibernate-core/src/main/java/org/hibernate/hql/internal/ast/HqlToken.java
View File

@ -8,7 +8,7 @@ package org.hibernate.hql.internal.ast;
/** /**
* A custom token class for the HQL grammar. * A custom token class for the HQL grammar.
* <p><i>NOTE:<i> This class must be public becuase it is instantiated by the ANTLR library. Ignore any suggestions * <p><i>NOTE:</i> This class must be public because it is instantiated by the ANTLR library. Ignore any suggestions
* by various code 'analyzers' about this class being package local.</p> * by various code 'analyzers' about this class being package local.</p>
*/ */
public class HqlToken extends antlr.CommonToken { public class HqlToken extends antlr.CommonToken {

2
hibernate-core/src/main/java/org/hibernate/id/factory/internal/MutableIdentifierGeneratorFactoryInitiator.java
View File

@ -13,7 +13,7 @@ import org.hibernate.id.factory.spi.MutableIdentifierGeneratorFactory;
import org.hibernate.service.spi.ServiceRegistryImplementor; import org.hibernate.service.spi.ServiceRegistryImplementor;
/** /**
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
*/ */
public class MutableIdentifierGeneratorFactoryInitiator implements StandardServiceInitiator<MutableIdentifierGeneratorFactory> { public class MutableIdentifierGeneratorFactoryInitiator implements StandardServiceInitiator<MutableIdentifierGeneratorFactory> {
public static final MutableIdentifierGeneratorFactoryInitiator INSTANCE = new MutableIdentifierGeneratorFactoryInitiator(); public static final MutableIdentifierGeneratorFactoryInitiator INSTANCE = new MutableIdentifierGeneratorFactoryInitiator();

2
hibernate-core/src/main/java/org/hibernate/id/factory/spi/MutableIdentifierGeneratorFactory.java
View File

@ -12,7 +12,7 @@ import org.hibernate.service.Service;
/** /**
* Let people register strategies * Let people register strategies
* *
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
*/ */
public interface MutableIdentifierGeneratorFactory extends IdentifierGeneratorFactory, Service { public interface MutableIdentifierGeneratorFactory extends IdentifierGeneratorFactory, Service {
public void register(String strategy, Class generatorClass); public void register(String strategy, Class generatorClass);

2
hibernate-core/src/main/java/org/hibernate/internal/util/StringHelper.java
View File

@ -289,7 +289,7 @@ public final class StringHelper {
/** /**
* Collapses a name. Mainly intended for use with classnames, where an example might serve best to explain. * Collapses a name. Mainly intended for use with classnames, where an example might serve best to explain.
* Imagine you have a class named <samp>'org.hibernate.internal.util.StringHelper'</samp>; calling collapse on that * Imagine you have a class named <samp>'org.hibernate.internal.util.StringHelper'</samp>; calling collapse on that
* classname will result in <samp>'o.h.u.StringHelper'<samp>. * classname will result in <samp>'o.h.u.StringHelper'</samp>.
* *
* @param name The name to collapse. * @param name The name to collapse.
* *

6
hibernate-core/src/main/java/org/hibernate/jpa/AvailableSettings.java
View File

@ -236,7 +236,7 @@ public interface AvailableSettings {
* <b>enabled</b> - Do the build * <b>enabled</b> - Do the build
* </li> * </li>
* <li> * <li>
* <b>disabled</b> - Do not so the build * <b>disabled</b> - Do not do the build
* </li> * </li>
* <li> * <li>
* <b>ignoreUnsupported</b> - Do the build, but ignore any non-JPA features that would otherwise * <b>ignoreUnsupported</b> - Do the build, but ignore any non-JPA features that would otherwise
@ -283,14 +283,14 @@ public interface AvailableSettings {
/** /**
* Caching configuration should follow the following pattern * Caching configuration should follow the following pattern
* hibernate.ejb.classcache.<fully.qualified.Classname> usage[, region] * {@code hibernate.ejb.classcache.<fully.qualified.Classname> usage[, region]}
* where usage is the cache strategy used and region the cache region name * where usage is the cache strategy used and region the cache region name
*/ */
String CLASS_CACHE_PREFIX = "hibernate.ejb.classcache"; String CLASS_CACHE_PREFIX = "hibernate.ejb.classcache";
/** /**
* Caching configuration should follow the following pattern * Caching configuration should follow the following pattern
* hibernate.ejb.collectioncache.<fully.qualified.Classname>.<role> usage[, region] * {@code hibernate.ejb.collectioncache.<fully.qualified.Classname>.<role> usage[, region]}
* where usage is the cache strategy used and region the cache region name * where usage is the cache strategy used and region the cache region name
*/ */
String COLLECTION_CACHE_PREFIX = "hibernate.ejb.collectioncache"; String COLLECTION_CACHE_PREFIX = "hibernate.ejb.collectioncache";

2
hibernate-core/src/main/java/org/hibernate/jpa/spi/HibernateEntityManagerFactoryAware.java
View File

@ -11,7 +11,7 @@ import org.hibernate.jpa.HibernateEntityManagerFactory;
/** /**
* Internal contact for things that have {@link HibernateEntityManagerFactory} access. * Internal contact for things that have {@link HibernateEntityManagerFactory} access.
* *
* @author Strong Liu <stliu@hibernate.org> * @author <a href="mailto:stliu@hibernate.org">Strong Liu</a>
* *
* @deprecated (since 5.2) Why do we need an over-arching access to HibernateEntityManagerFactory across * @deprecated (since 5.2) Why do we need an over-arching access to HibernateEntityManagerFactory across
* multiple contract hierarchies? * multiple contract hierarchies?

2
hibernate-core/src/main/java/org/hibernate/jpa/spi/IdentifierGeneratorStrategyProvider.java
View File

@ -11,7 +11,7 @@ import java.util.Map;
/** /**
* Provide a set of IdentifierGenerator strategies allowing to override the Hibernate Core default ones * Provide a set of IdentifierGenerator strategies allowing to override the Hibernate Core default ones
* *
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
*/ */
public interface IdentifierGeneratorStrategyProvider { public interface IdentifierGeneratorStrategyProvider {
/** /**

2
hibernate-core/src/main/java/org/hibernate/loader/collection/BasicCollectionLoader.java
View File

@ -18,7 +18,7 @@ import org.jboss.logging.Logger;
/** /**
* Loads a collection of values or a many-to-many association. * Loads a collection of values or a many-to-many association.
* <br> * <br>
* The collection persister must implement <tt>QueryableCOllection<tt>. For * The collection persister must implement <tt>QueryableCollection</tt>. For
* other collections, create a customized subclass of <tt>Loader</tt>. * other collections, create a customized subclass of <tt>Loader</tt>.
* *
* @see OneToManyLoader * @see OneToManyLoader

2
hibernate-core/src/main/java/org/hibernate/loader/collection/OneToManyLoader.java
View File

@ -18,7 +18,7 @@ import org.jboss.logging.Logger;
/** /**
* Loads one-to-many associations<br> * Loads one-to-many associations<br>
* <br> * <br>
* The collection persister must implement <tt>QueryableCOllection<tt>. For * The collection persister must implement <tt>QueryableCollection</tt>. For
* other collections, create a customized subclass of <tt>Loader</tt>. * other collections, create a customized subclass of <tt>Loader</tt>.
* *
* @see BasicCollectionLoader * @see BasicCollectionLoader

4
hibernate-core/src/main/java/org/hibernate/loader/custom/ColumnCollectionAliases.java
View File

@ -12,8 +12,8 @@ import org.hibernate.loader.CollectionAliases;
import org.hibernate.persister.collection.SQLLoadableCollection; import org.hibernate.persister.collection.SQLLoadableCollection;
/** /**
* CollectionAliases that uses columnnames instead of generated aliases. * CollectionAliases that uses column names instead of generated aliases.
* Aliases can still be overwritten via <return-property> * Aliases can still be overwritten via {@code <return-property>}
* *
* @author Max Rydahl Andersen * @author Max Rydahl Andersen
*/ */

2
hibernate-core/src/main/java/org/hibernate/loader/plan/build/internal/AbstractEntityGraphVisitationStrategy.java
View File

@ -52,7 +52,7 @@ import org.jboss.logging.Logger;
* and we try to match the node to entity graph ( and subgraph ), if there is a match, then the attribute is fetched, * and we try to match the node to entity graph ( and subgraph ), if there is a match, then the attribute is fetched,
* it is not, then depends on which property is used to apply this entity graph. * it is not, then depends on which property is used to apply this entity graph.
* *
* @author Strong Liu <stliu@hibernate.org> * @author <a href="mailto:stliu@hibernate.org">Strong Liu</a>
* @author Brett Meyer * @author Brett Meyer
*/ */
public abstract class AbstractEntityGraphVisitationStrategy public abstract class AbstractEntityGraphVisitationStrategy

2
hibernate-core/src/main/java/org/hibernate/loader/plan/build/internal/FetchGraphLoadPlanBuildingStrategy.java
View File

@ -16,7 +16,7 @@ import org.hibernate.persister.walking.spi.AssociationAttributeDefinition;
/** /**
* Loadplan building strategy for {@link javax.persistence.EntityGraph} is applied in {@code javax.persistence.fetchgraph} mode. * Loadplan building strategy for {@link javax.persistence.EntityGraph} is applied in {@code javax.persistence.fetchgraph} mode.
* *
* @author Strong Liu <stliu@hibernate.org> * @author <a href="mailto:stliu@hibernate.org">Strong Liu</a>
*/ */
public class FetchGraphLoadPlanBuildingStrategy extends AbstractEntityGraphVisitationStrategy { public class FetchGraphLoadPlanBuildingStrategy extends AbstractEntityGraphVisitationStrategy {
private final GraphNodeImplementor rootEntityGraph; private final GraphNodeImplementor rootEntityGraph;

2
hibernate-core/src/main/java/org/hibernate/loader/plan/build/internal/LoadGraphLoadPlanBuildingStrategy.java
View File

@ -19,7 +19,7 @@ import org.hibernate.persister.walking.spi.AssociationAttributeDefinition;
/** /**
* Loadplan building strategy for {@link javax.persistence.EntityGraph} is applied in {@code javax.persistence.loadgraph} mode. * Loadplan building strategy for {@link javax.persistence.EntityGraph} is applied in {@code javax.persistence.loadgraph} mode.
* *
* @author Strong Liu <stliu@hibernate.org> * @author <a href="mailto:stliu@hibernate.org">Strong Liu</a>
*/ */
public class LoadGraphLoadPlanBuildingStrategy extends AbstractEntityGraphVisitationStrategy { public class LoadGraphLoadPlanBuildingStrategy extends AbstractEntityGraphVisitationStrategy {
private final GraphNodeImplementor rootEntityGraph; private final GraphNodeImplementor rootEntityGraph;

2
hibernate-core/src/main/java/org/hibernate/loader/plan/build/spi/ExpandingCollectionQuerySpace.java
View File

@ -29,7 +29,7 @@ public interface ExpandingCollectionQuerySpace extends CollectionQuerySpace, Exp
* @param join The element or index join to add. * @param join The element or index join to add.
* *
* @throws java.lang.IllegalArgumentException if {@code join} is an instance of * @throws java.lang.IllegalArgumentException if {@code join} is an instance of
* {@link org.hibernate.loader.plan.spi.JoinDefinedByMetadata} and {@code join.getJoinedPropertyName() * {@link org.hibernate.loader.plan.spi.JoinDefinedByMetadata} and {@code join.getJoinedPropertyName()}
* is neither {@code "elements"} and {@code "indices"}. * is neither {@code "elements"} and {@code "indices"}.
* @throws java.lang.IllegalStateException if there is already an existing join with the same joined property name. * @throws java.lang.IllegalStateException if there is already an existing join with the same joined property name.
*/ */

2
hibernate-core/src/main/java/org/hibernate/loader/plan/exec/internal/AliasResolutionContextImpl.java
View File

@ -154,7 +154,7 @@ public class AliasResolutionContextImpl implements AliasResolutionContext {
* query space UID: * query space UID:
* <ul> * <ul>
* <li> * <li>
* {@link ##resolveCollectionReferenceAliases(String)} can be used to * {@link #resolveCollectionReferenceAliases(String)} can be used to
* look up the returned collection reference aliases; * look up the returned collection reference aliases;
* </li> * </li>
* <li> * <li>

2
hibernate-core/src/main/java/org/hibernate/loader/plan/spi/BidirectionalEntityReference.java
View File

@ -35,7 +35,7 @@ public interface BidirectionalEntityReference extends EntityReference {
/** /**
* The query space UID returned using {@link #getQuerySpaceUid()} must * The query space UID returned using {@link #getQuerySpaceUid()} must
* be the same as returned by {@link #getTargetEntityReference()#getQuerySpaceUid()} * be the same as returned by {@link #getTargetEntityReference()}
* *
* @return The query space UID. * @return The query space UID.
*/ */

2
hibernate-core/src/main/java/org/hibernate/loader/plan/spi/FetchSource.java
View File

@ -55,7 +55,7 @@ public interface FetchSource {
* *
* @return the "current" EntityReference or null if none. * @return the "current" EntityReference or null if none.
* . * .
* @see org.hibernate.loader.plan.spi.Fetch#getSource(). * @see org.hibernate.loader.plan.spi.Fetch#getSource()
*/ */
public EntityReference resolveEntityReference(); public EntityReference resolveEntityReference();
} }

2
hibernate-core/src/main/java/org/hibernate/metamodel/internal/AttributeFactory.java
View File

@ -41,7 +41,7 @@ import org.hibernate.type.EntityType;
* <li>{@link #buildAttribute normal attributes}</li> * <li>{@link #buildAttribute normal attributes}</li>
* <li>{@link #buildIdAttribute id attributes}</li> * <li>{@link #buildIdAttribute id attributes}</li>
* <li>{@link #buildVersionAttribute version attributes}</li> * <li>{@link #buildVersionAttribute version attributes}</li>
* <ol> * </ol>
* *
* @author Steve Ebersole * @author Steve Ebersole
* @author Emmanuel Bernard * @author Emmanuel Bernard

2
hibernate-core/src/main/java/org/hibernate/persister/spi/PersisterClassResolver.java
View File

@ -21,7 +21,7 @@ import org.hibernate.service.Service;
* <li>the default provider as chosen by Hibernate Core (best choice most of the time)</li> * <li>the default provider as chosen by Hibernate Core (best choice most of the time)</li>
* </ol> * </ol>
* *
* @author Emmanuel Bernard <emmanuel@hibernate.org> * @author <a href="mailto:emmanuel@hibernate.org">Emmanuel Bernard</a>
* @author Steve Ebersole * @author Steve Ebersole
*/ */
public interface PersisterClassResolver extends Service { public interface PersisterClassResolver extends Service {

2
hibernate-core/src/main/java/org/hibernate/proxy/AbstractLazyInitializer.java
View File

@ -430,7 +430,7 @@ public abstract class AbstractLazyInitializer implements LazyInitializer {
* This method should only be called during deserialization, before associating * This method should only be called during deserialization, before associating
* the proxy with a session. * the proxy with a session.
* *
* @param readOnlyBeforeAttachedToSession, the read-only/modifiable setting to use when * @param readOnlyBeforeAttachedToSession the read-only/modifiable setting to use when
* associated with a session; null indicates that the default should be used. * associated with a session; null indicates that the default should be used.
* @param sessionFactoryUuid the session factory uuid, to be used if {@code allowLoadOutsideTransaction} is {@code true}. * @param sessionFactoryUuid the session factory uuid, to be used if {@code allowLoadOutsideTransaction} is {@code true}.
* @param allowLoadOutsideTransaction whether the proxy can load data even * @param allowLoadOutsideTransaction whether the proxy can load data even

2
hibernate-core/src/main/java/org/hibernate/query/criteria/internal/predicate/ExistsPredicate.java
View File

@ -15,7 +15,7 @@ import org.hibernate.query.criteria.internal.Renderable;
import org.hibernate.query.criteria.internal.compile.RenderingContext; import org.hibernate.query.criteria.internal.compile.RenderingContext;
/** /**
* Models an <tt>EXISTS(<subquery>)</tt> predicate * Models an {@code EXISTS(<subquery>)} predicate
* *
* @author Steve Ebersole * @author Steve Ebersole
*/ */

2
hibernate-core/src/main/java/org/hibernate/sql/ordering/antlr/OrderByTranslation.java
View File

@ -7,7 +7,7 @@
package org.hibernate.sql.ordering.antlr; package org.hibernate.sql.ordering.antlr;
/** /**
* Represents the result of an order-by translation by {@link @OrderByTranslator} * Represents the result of an order-by translation by {@link OrderByFragmentTranslator}
* *
* @author Steve Ebersole * @author Steve Ebersole
*/ */

2
hibernate-core/src/main/java/org/hibernate/sql/ordering/antlr/TranslationContext.java
View File

@ -31,7 +31,7 @@ public interface TranslationContext {
public Dialect getDialect(); public Dialect getDialect();
/** /**
* Retrieves the <tt>SQL function registry/tt> for this context. * Retrieves the <tt>SQL function registry</tt> for this context.
* *
* @return The SQL function registry. * @return The SQL function registry.
*/ */

30
hibernate-core/src/main/java/org/hibernate/stat/Statistics.java
View File

@ -69,7 +69,7 @@ public interface Statistics {
QueryStatistics getQueryStatistics(String queryString); QueryStatistics getQueryStatistics(String queryString);
/** /**
* Second level cache statistics per domain data (entity, collection, natural-id) region * Second-level cache statistics per domain data (entity, collection, natural-id) region
* *
* @param regionName The unqualified region name * @param regionName The unqualified region name
* *
@ -81,7 +81,7 @@ public interface Statistics {
CacheRegionStatistics getDomainDataRegionStatistics(String regionName); CacheRegionStatistics getDomainDataRegionStatistics(String regionName);
/** /**
* Second level cache statistics per query region * Second-level cache statistics per query region
* *
* @param regionName The unqualified region name * @param regionName The unqualified region name
* *
@ -125,7 +125,7 @@ public interface Statistics {
long getEntityLoadCount(); long getEntityLoadCount();
/** /**
* Get global number of entity fetchs * Get global number of entity fetches
* @return entity fetch (from DB) * @return entity fetch (from DB)
*/ */
long getEntityFetchCount(); long getEntityFetchCount();
@ -168,34 +168,34 @@ public interface Statistics {
long getQueryCachePutCount(); long getQueryCachePutCount();
/** /**
* Get the global number of naturalId queries executed against the database * Get the global number of natural id queries executed against the database
*/ */
long getNaturalIdQueryExecutionCount(); long getNaturalIdQueryExecutionCount();
/** /**
* Get the global maximum query time for naturalId queries executed against the database * Get the global maximum query time for natural id queries executed against the database
*/ */
long getNaturalIdQueryExecutionMaxTime(); long getNaturalIdQueryExecutionMaxTime();
/** /**
* Get the region for the maximum naturalId query time * Get the region for the maximum natural id query time
*/ */
String getNaturalIdQueryExecutionMaxTimeRegion(); String getNaturalIdQueryExecutionMaxTimeRegion();
String getNaturalIdQueryExecutionMaxTimeEntity(); String getNaturalIdQueryExecutionMaxTimeEntity();
/** /**
* Get the global number of cached naturalId lookups successfully retrieved from cache * Get the global number of cached natural id lookups successfully retrieved from cache
*/ */
long getNaturalIdCacheHitCount(); long getNaturalIdCacheHitCount();
/** /**
* Get the global number of cached naturalId lookups *not* found in cache * Get the global number of cached natural id lookups *not* found in cache
*/ */
long getNaturalIdCacheMissCount(); long getNaturalIdCacheMissCount();
/** /**
* Get the global number of cacheable naturalId lookups put in cache * Get the global number of cacheable natural id lookups put in cache
*/ */
long getNaturalIdCachePutCount(); long getNaturalIdCachePutCount();
@ -205,7 +205,7 @@ public interface Statistics {
long getUpdateTimestampsCacheHitCount(); long getUpdateTimestampsCacheHitCount();
/** /**
* Get the global number of tables for which no update timestamps was *not* found in cache * Get the global number of timestamp requests that were not found in the cache
*/ */
long getUpdateTimestampsCacheMissCount(); long getUpdateTimestampsCacheMissCount();
@ -278,9 +278,9 @@ public interface Statistics {
long getCollectionRecreateCount(); long getCollectionRecreateCount();
/** /**
* The milliseconds (JVM standard {@link System#currentTimeMillis()}) from * The milliseconds (JVM standard {@link System#currentTimeMillis()})
* which all statistics accessed since the initial creation of this Statistics * since the initial creation of this Statistics
* instance or the last {@link #clear()} * instance or the last time {@link #clear()} was called.
* *
* @apiNote This time(stamp) is * @apiNote This time(stamp) is
*/ */
@ -336,7 +336,7 @@ public interface Statistics {
/** /**
* Second level cache statistics per region * Second-level cache statistics per region
* *
* @param regionName qualified region name * @param regionName qualified region name
* *
@ -356,7 +356,7 @@ public interface Statistics {
* @return NaturalIdCacheStatistics * @return NaturalIdCacheStatistics
* *
* @deprecated (since 5.3) Use {@link #getNaturalIdStatistics} or * @deprecated (since 5.3) Use {@link #getNaturalIdStatistics} or
* {@link @getDomainDataRegionStatistics} instead depending on need * {@link #getDomainDataRegionStatistics} instead depending on need
*/ */
@Deprecated @Deprecated
NaturalIdCacheStatistics getNaturalIdCacheStatistics(String regionName); NaturalIdCacheStatistics getNaturalIdCacheStatistics(String regionName);

2
hibernate-core/src/main/java/org/hibernate/stat/internal/QueryStatisticsImpl.java
View File

@ -72,7 +72,7 @@ public class QueryStatisticsImpl implements QueryStatistics {
/** /**
* Number of lines returned by all the executions of this query (from DB) * Number of lines returned by all the executions of this query (from DB)
* For now, {@link org.hibernate.Query#iterate()} * For now, {@link org.hibernate.Query#iterate()}
* and {@link org.hibernate.Query#scroll()()} do not fill this statistic * and {@link org.hibernate.Query#scroll()} do not fill this statistic
* *
* @return The number of rows cumulatively returned by the given query; iterate * @return The number of rows cumulatively returned by the given query; iterate
* and scroll queries do not effect this total as their number of returned rows * and scroll queries do not effect this total as their number of returned rows

3
hibernate-core/src/main/java/org/hibernate/tool/enhance/EnhancementTask.java
View File

@ -36,7 +36,7 @@ import java.util.List;
* Code based on from: * Code based on from:
* https://github.com/hibernate/hibernate-orm/blob/159bc99a36d86988b61b88ba91eec82cac044e1c/hibernate-core/src/main/java/org/hibernate/tool/enhance/EnhancementTask.java * https://github.com/hibernate/hibernate-orm/blob/159bc99a36d86988b61b88ba91eec82cac044e1c/hibernate-core/src/main/java/org/hibernate/tool/enhance/EnhancementTask.java
* https://github.com/hibernate/hibernate-orm/blob/159bc99a36d86988b61b88ba91eec82cac044e1c/tooling/hibernate-enhance-maven-plugin/src/main/java/org/hibernate/orm/tooling/maven/MavenEnhancePlugin.java * https://github.com/hibernate/hibernate-orm/blob/159bc99a36d86988b61b88ba91eec82cac044e1c/tooling/hibernate-enhance-maven-plugin/src/main/java/org/hibernate/orm/tooling/maven/MavenEnhancePlugin.java
* * <pre>{@code
* <target name="enhance" depends="compile"> * <target name="enhance" depends="compile">
* <taskdef name="enhance" classname="org.hibernate.tool.enhance.EnhancementTask"> * <taskdef name="enhance" classname="org.hibernate.tool.enhance.EnhancementTask">
* <classpath refid="<some-ant-path-including-hibernate-core-jar>"/> * <classpath refid="<some-ant-path-including-hibernate-core-jar>"/>
@ -44,6 +44,7 @@ import java.util.List;
* </taskdef> * </taskdef>
* <enhance base="${base}" dir="${base}" failOnError="true" enableLazyInitialization="true" enableDirtyTracking="false" enableAssociationManagement="false" enableExtendedEnhancement="false" /> * <enhance base="${base}" dir="${base}" failOnError="true" enableLazyInitialization="true" enableDirtyTracking="false" enableAssociationManagement="false" enableExtendedEnhancement="false" />
* </target> * </target>
* }</pre>
* *
* @author Luis Barreiro * @author Luis Barreiro
* @author Taro App * @author Taro App

6
hibernate-core/src/main/java/org/hibernate/tool/schema/extract/spi/DatabaseInformation.java
View File

@ -54,16 +54,16 @@ public interface DatabaseInformation {
/** /**
* Obtain reference to the named TableInformation * Obtain reference to the named TableInformation
* *
* @param tableName The qualfied table name * @param tableName The qualified table name
* *
* @return The table information. May return {@code null} if not found. * @return The table information. May return {@code null} if not found.
*/ */
TableInformation getTableInformation(QualifiedTableName tableName); TableInformation getTableInformation(QualifiedTableName tableName);
/** /**
* Obtain reference to all the {@link TableInformation) for a given {@link Namespace} * Obtain reference to all the {@link TableInformation} for a given {@link Namespace}
* *
* @param namespace The {@link Namespace} which contains the {@link TableInformation) * @param namespace The {@link Namespace} which contains the {@link TableInformation}
* *
* @return a {@link NameSpaceTablesInformation} * @return a {@link NameSpaceTablesInformation}
*/ */

4
hibernate-core/src/main/java/org/hibernate/type/descriptor/sql/LobTypeMappings.java
View File

@ -31,7 +31,7 @@ public final class LobTypeMappings {
/** /**
* *
* @param jdbcTypeCode * @param jdbcTypeCode
* @return * @return true if corresponding Lob code exists; false otherwise.
* @deprecated use {@link #isMappedToKnownLobCode(int)} * @deprecated use {@link #isMappedToKnownLobCode(int)}
*/ */
@Deprecated @Deprecated
@ -42,7 +42,7 @@ public final class LobTypeMappings {
/** /**
* *
* @param jdbcTypeCode * @param jdbcTypeCode
* @return * @return corresponding Lob code
* @deprecated use {@link #getLobCodeTypeMapping(int)} * @deprecated use {@link #getLobCodeTypeMapping(int)}
*/ */
@Deprecated @Deprecated

6
hibernate-osgi/src/main/java/org/hibernate/osgi/OsgiServiceUtil.java
View File

@ -38,8 +38,7 @@ public class OsgiServiceUtil implements Stoppable {
* {@link ServiceTracker} (best practice, automatically handles a lot of boilerplate and error conditions). * {@link ServiceTracker} (best practice, automatically handles a lot of boilerplate and error conditions).
* *
* @param contract The service contract for which to locate implementors * @param contract The service contract for which to locate implementors
* @param context The OSGi bundle context * @param <T> The Java type of the service to locate
* @param T[] The Java type of the service to locate
* @return All know implementors * @return All know implementors
*/ */
public <T> T[] getServiceImpls(Class<T> contract) { public <T> T[] getServiceImpls(Class<T> contract) {
@ -63,8 +62,7 @@ public class OsgiServiceUtil implements Stoppable {
* {@link ServiceTracker#waitForService(long)} * {@link ServiceTracker#waitForService(long)}
* *
* @param contract The service contract for which to locate implementors * @param contract The service contract for which to locate implementors
* @param context The OSGi bundle context * @param <T> The Java type of the service to locate
* @param T[] The Java type of the service to locate
* @return All know implementors * @return All know implementors
*/ */
public <T> T getServiceImpl(Class<T> contract) { public <T> T getServiceImpl(Class<T> contract) {

2
hibernate-spatial/src/main/java/org/hibernate/spatial/dialect/oracle/criterion/SDOParameterMap.java
View File

@ -250,7 +250,7 @@ public class SDOParameterMap {
/** /**
* Returns all parameters contained in this instance as a quoted String containing * Returns all parameters contained in this instance as a quoted String containing
* the <parameter name>=<parameter value> pairs separated by spaces. * the {@code <parameter name>=<parameter value>} pairs separated by spaces.
* <p> * <p>
* The return format is as expected by the various SDO_GEOMETRY spatial functions. * The return format is as expected by the various SDO_GEOMETRY spatial functions.
* *

2
hibernate-testing/src/main/java/org/hibernate/testing/byteman/BytemanHelper.java
View File

@ -13,7 +13,7 @@ import org.jboss.byteman.rule.helper.Helper;
import org.jboss.logging.Logger; import org.jboss.logging.Logger;
/** /**
* @author Sanne Grinovero <sanne@hibernate.org> (C) 2011 Red Hat Inc. * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero</a> (C) 2011 Red Hat Inc.
* @author Hardy Ferentschik * @author Hardy Ferentschik
*/ */
public class BytemanHelper extends Helper { public class BytemanHelper extends Helper {

3
hibernate-testing/src/main/java/org/hibernate/testing/env/ConnectionProviderBuilder.java vendored
View File

@ -160,7 +160,8 @@ public class ConnectionProviderBuilder implements DialectCheck {
try { try {
actualConnection.close(); actualConnection.close();
} }
catch (SQLException ignore) {} catch (SQLException ignore) {
}
} }
} }

2
hibernate-testing/src/main/java/org/hibernate/testing/logger/Log4DelegatingLogger.java
View File

@ -17,7 +17,7 @@ import org.jboss.logging.Logger;
* A {@code Logger} implementation which delegates to Log4J but makes it possible * A {@code Logger} implementation which delegates to Log4J but makes it possible
* to test for events being logged (not logged). * to test for events being logged (not logged).
* *
* @author Sanne Grinovero <sanne@hibernate.org> (C) 2015 Red Hat Inc. * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero</a> (C) 2011 Red Hat Inc.
*/ */
public final class Log4DelegatingLogger extends Logger { public final class Log4DelegatingLogger extends Logger {

2
hibernate-testing/src/main/java/org/hibernate/testing/logger/LogInspectionHelper.java
View File

@ -17,7 +17,7 @@ import org.jboss.logging.DelegatingBasicLogger;
* For this to work, it requires JBoss Logging to pick up our custom * For this to work, it requires JBoss Logging to pick up our custom
* implementation {@code Log4DelegatingLogger} via ServiceLoader. * implementation {@code Log4DelegatingLogger} via ServiceLoader.
* *
* @author Sanne Grinovero <sanne@hibernate.org> (C) 2015 Red Hat Inc. * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero</a> (C) 2015 Red Hat Inc.
*/ */
final class LogInspectionHelper { final class LogInspectionHelper {

2
hibernate-testing/src/main/java/org/hibernate/testing/logger/TestableLoggerProvider.java
View File

@ -18,7 +18,7 @@ import org.jboss.logging.Logger;
* A {@code LoggerProvider} for JBoss Logger. * A {@code LoggerProvider} for JBoss Logger.
* See also META-INF/services/org.jboss.logging.LoggerProvider * See also META-INF/services/org.jboss.logging.LoggerProvider
* *
* @author Sanne Grinovero <sanne@hibernate.org> (C) 2015 Red Hat Inc. * @author <a href="mailto:sanne@hibernate.org">Sanne Grinovero</a> (C) 2015 Red Hat Inc.
*/ */
public class TestableLoggerProvider implements org.jboss.logging.LoggerProvider { public class TestableLoggerProvider implements org.jboss.logging.LoggerProvider {

4
tooling/metamodel-generator/src/main/java/org/hibernate/jpamodelgen/ImportContextImpl.java
View File

@ -53,8 +53,8 @@ public class ImportContextImpl implements ImportContext {
* Attempts to handle fqcn with array and generics references. * Attempts to handle fqcn with array and generics references.
* <p/> * <p/>
* e.g. * e.g.
* java.util.Collection<org.marvel.Hulk> imports java.util.Collection and returns Collection * {@code java.util.Collection<org.marvel.Hulk>} imports {@code java.util.Collection} and returns {@code Collection}
* org.marvel.Hulk[] imports org.marvel.Hulk and returns Hulk * {@code org.marvel.Hulk[]} imports {@code org.marvel.Hulk} and returns {@code Hulk}
* *
* @param fqcn Fully qualified class name * @param fqcn Fully qualified class name
* *

4
tooling/metamodel-generator/src/main/java/org/hibernate/jpamodelgen/model/ImportContext.java
View File

@ -18,8 +18,8 @@ public interface ImportContext {
* Attempts to handle fqcn with array and generics references. * Attempts to handle fqcn with array and generics references.
* <p/> * <p/>
* e.g. * e.g.
* java.util.Collection<org.marvel.Hulk> imports java.util.Collection and returns Collection * {@code java.util.Collection<org.marvel.Hulk>} imports {@code java.util.Collection} and returns {@code Collection}
* org.marvel.Hulk[] imports org.marvel.Hulk and returns Hulk * {@code org.marvel.Hulk[]} imports {@code org.marvel.Hulk} and returns {@code Hulk}
* *
* @param fqcn Fully qualified class name of the type to import. * @param fqcn Fully qualified class name of the type to import.
* *