diff --git a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/Cache71Dialect.java b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/Cache71Dialect.java index a41c156e5b..ac27b7f32f 100644 --- a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/Cache71Dialect.java +++ b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/Cache71Dialect.java @@ -61,6 +61,7 @@ package org.hibernate.community.dialect; * "name=value" pairs: *

* + * * * * diff --git a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java index 6c711fba6d..a61cb25558 100644 --- a/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java +++ b/hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java @@ -610,7 +610,7 @@ public class PostgreSQLLegacyDialect extends Dialect { * stype = uuid, * combinefunc = min, * parallel = safe, - * sortop = operator (<) + * sortop = operator (<) * ); * * create or replace function max(uuid, uuid) @@ -628,7 +628,7 @@ public class PostgreSQLLegacyDialect extends Dialect { * stype = uuid, * combinefunc = max, * parallel = safe, - * sortop = operator (>) + * sortop = operator (>) * ); * */ diff --git a/hibernate-core/src/main/java/org/hibernate/annotations/package-info.java b/hibernate-core/src/main/java/org/hibernate/annotations/package-info.java index 79aeb9ac33..0aa471eae1 100644 --- a/hibernate-core/src/main/java/org/hibernate/annotations/package-info.java +++ b/hibernate-core/src/main/java/org/hibernate/annotations/package-info.java @@ -8,7 +8,7 @@ /** * A set of mapping annotations which extend the O/R mapping annotations defined by JPA. * - *

Basic value mapping

+ *

Basic value mapping

* * Hibernate supports 2 approaches to defining a mapping strategy for basic values: *
Properties
Property NameProperty Value
+ * * * * @@ -74,6 +75,7 @@ import static org.hibernate.internal.log.DeprecationLogger.DEPRECATION_LOGGER; * {@link java.sql.DriverManager}) * * + * * *
Configuration properties
PropertyInterpretation
{@value #DIALECT}
{@value #POOL_SIZE}the maximum size of the connection pool (only when using * {@link java.sql.DriverManager}) diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/Dialect.java b/hibernate-core/src/main/java/org/hibernate/dialect/Dialect.java index ed22486be3..7eb33534df 100644 --- a/hibernate-core/src/main/java/org/hibernate/dialect/Dialect.java +++ b/hibernate-core/src/main/java/org/hibernate/dialect/Dialect.java @@ -4418,7 +4418,7 @@ public abstract class Dialect implements ConversionContext { /** * The SchemaManagementTool to use if none explicitly specified. - *

+ *

* Allows Dialects to override how schema tooling works by default */ @Incubating diff --git a/hibernate-core/src/main/java/org/hibernate/dialect/PostgreSQLDialect.java b/hibernate-core/src/main/java/org/hibernate/dialect/PostgreSQLDialect.java index 528af7311a..7b5adb6c25 100644 --- a/hibernate-core/src/main/java/org/hibernate/dialect/PostgreSQLDialect.java +++ b/hibernate-core/src/main/java/org/hibernate/dialect/PostgreSQLDialect.java @@ -596,7 +596,7 @@ public class PostgreSQLDialect extends Dialect { * stype = uuid, * combinefunc = min, * parallel = safe, - * sortop = operator (<) + * sortop = operator (<) * ); * * create or replace function max(uuid, uuid) @@ -614,7 +614,7 @@ public class PostgreSQLDialect extends Dialect { * stype = uuid, * combinefunc = max, * parallel = safe, - * sortop = operator (>) + * sortop = operator (>) * ); * */ diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/spi/Batch.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/spi/Batch.java index fc1106c4f4..9388bf2c81 100644 --- a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/spi/Batch.java +++ b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/batch/spi/Batch.java @@ -15,7 +15,7 @@ import org.hibernate.engine.jdbc.mutation.group.PreparedStatementGroup; /** * Conceptually models a batch. - *

+ *

* Unlike in JDBC, here we add the ability to batch together multiple statements at a time. In the underlying * JDBC this correlates to multiple {@link PreparedStatement} objects (one for each DML string) maintained within the * batch. diff --git a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/group/PreparedStatementDetails.java b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/group/PreparedStatementDetails.java index 6e7b80ee71..897baa25aa 100644 --- a/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/group/PreparedStatementDetails.java +++ b/hibernate-core/src/main/java/org/hibernate/engine/jdbc/mutation/group/PreparedStatementDetails.java @@ -40,7 +40,7 @@ public interface PreparedStatementDetails { /** * The {@link PreparedStatement} generated from the SQL. - *

+ *

* Unlike {@link #getStatement()}, this method will attempt to create the PreparedStatement */ PreparedStatement resolveStatement(); diff --git a/hibernate-core/src/main/java/org/hibernate/id/enhanced/SequenceStyleGenerator.java b/hibernate-core/src/main/java/org/hibernate/id/enhanced/SequenceStyleGenerator.java index c23438e75c..2b8bccc288 100644 --- a/hibernate-core/src/main/java/org/hibernate/id/enhanced/SequenceStyleGenerator.java +++ b/hibernate-core/src/main/java/org/hibernate/id/enhanced/SequenceStyleGenerator.java @@ -45,8 +45,8 @@ import static org.hibernate.internal.util.NullnessHelper.coalesceSuppliedValues; * a sequence. These variations are encapsulated by the {@link DatabaseStructure} * interface internally. *

- * General configuration parameters: * + * * * * @@ -81,6 +81,7 @@ import static org.hibernate.internal.util.NullnessHelper.coalesceSuppliedValues; *

* Configuration parameters used specifically when the underlying structure is a table: *

General configuration parameters
NAMEDEFAULT
+ * * * * diff --git a/hibernate-core/src/main/java/org/hibernate/id/enhanced/TableGenerator.java b/hibernate-core/src/main/java/org/hibernate/id/enhanced/TableGenerator.java index 99f70af4bd..076eb360f9 100644 --- a/hibernate-core/src/main/java/org/hibernate/id/enhanced/TableGenerator.java +++ b/hibernate-core/src/main/java/org/hibernate/id/enhanced/TableGenerator.java @@ -74,8 +74,8 @@ import static org.hibernate.internal.util.NullnessHelper.coalesceSuppliedValues; * {@link #CONFIG_PREFER_SEGMENT_PER_ENTITY} can be used to change that to * instead default to using a row for each entity name. *

- * Configuration parameters: *

Table configuration parameters
NAMEDEFAULT
+ * * * * diff --git a/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/SelectableConsumer.java b/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/SelectableConsumer.java index 44ace130bf..51d416f570 100644 --- a/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/SelectableConsumer.java +++ b/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/SelectableConsumer.java @@ -27,10 +27,10 @@ public interface SelectableConsumer { /** * Simple form of visitation over a number of columns by name, using * a separate {@link SelectableMappings} as a base for additional details. - *

+ *

* Intended for use in visiting table keys, where we know JdbcMappings, etc. * from the identifier. - *

+ *

* The expectation here is for the following details to be available:

    *
  • {@link SelectableMapping#getContainingTableExpression()}
    • *
  • {@link SelectableMapping#getSelectionExpression()} (the column name)
    • diff --git a/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/internal/EntityCollectionPart.java b/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/internal/EntityCollectionPart.java index 597caac60e..84108e8734 100644 --- a/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/internal/EntityCollectionPart.java +++ b/hibernate-core/src/main/java/org/hibernate/metamodel/mapping/internal/EntityCollectionPart.java @@ -61,12 +61,12 @@ public interface EntityCollectionPart extends CollectionPart, EntityValuedFetcha /** * Perform any delayed initialization. - *

    + *

    * The initialization is considered successful if the result is {@code true}. It is * considered unsuccessful if the result is {@code false} or an exception is thrown. * Unsuccessful initializations are generally retried "later", to allow waiting for * model-parts being available e.g. - *

    + *

    * If the exception is something that will just never succeed, consider throwing * an exception with the {@link NonTransientException} marker to allow the creation * process to stop immediately diff --git a/hibernate-core/src/main/java/org/hibernate/persister/collection/mutation/InsertRowsCoordinator.java b/hibernate-core/src/main/java/org/hibernate/persister/collection/mutation/InsertRowsCoordinator.java index f7557f293c..0f714645ee 100644 --- a/hibernate-core/src/main/java/org/hibernate/persister/collection/mutation/InsertRowsCoordinator.java +++ b/hibernate-core/src/main/java/org/hibernate/persister/collection/mutation/InsertRowsCoordinator.java @@ -13,10 +13,10 @@ import org.hibernate.persister.collection.CollectionPersister; /** * Coordinates the logical insertion of collection entries which are not yet persistent. - *

    + *

    * Insertions are determined by {@linkplain EntryFilter filtering} the entries obtained * from {@link PersistentCollection#entries(CollectionPersister)}. - *

    + *

    * A "logical" insertion because the actual SQL used may be an UPDATE in the case of * one-to-many mappings to set the foreign-key * diff --git a/hibernate-core/src/main/java/org/hibernate/persister/entity/AbstractEntityPersister.java b/hibernate-core/src/main/java/org/hibernate/persister/entity/AbstractEntityPersister.java index 54a80db44c..70974a24ab 100644 --- a/hibernate-core/src/main/java/org/hibernate/persister/entity/AbstractEntityPersister.java +++ b/hibernate-core/src/main/java/org/hibernate/persister/entity/AbstractEntityPersister.java @@ -6054,7 +6054,7 @@ public abstract class AbstractEntityPersister /** * Decide which tables need to be updated. - *

    + *

    * The return here is an array of boolean values with each index corresponding * to a given table in the scope of this persister. * diff --git a/hibernate-core/src/main/java/org/hibernate/persister/entity/EntityPersister.java b/hibernate-core/src/main/java/org/hibernate/persister/entity/EntityPersister.java index 82f1731f35..e756c5afde 100644 --- a/hibernate-core/src/main/java/org/hibernate/persister/entity/EntityPersister.java +++ b/hibernate-core/src/main/java/org/hibernate/persister/entity/EntityPersister.java @@ -396,8 +396,8 @@ public interface EntityPersister * Determine whether optimistic locking by column is enabled for this * entity. * - * @return True if optimistic locking by column (i.e., or - * ) is enabled; false otherwise. + * @return True if optimistic locking by column (i.e., {@code } or + * {@code }) is enabled; false otherwise. */ boolean isVersioned(); diff --git a/hibernate-core/src/main/java/org/hibernate/persister/entity/Queryable.java b/hibernate-core/src/main/java/org/hibernate/persister/entity/Queryable.java index 2f23d33896..e3e3bcdc43 100644 --- a/hibernate-core/src/main/java/org/hibernate/persister/entity/Queryable.java +++ b/hibernate-core/src/main/java/org/hibernate/persister/entity/Queryable.java @@ -116,7 +116,7 @@ public interface Queryable extends Loadable, PropertyMapping, Joinable { /** * The alias used for any filter conditions (mapped where-fragments or * enabled-filters). - *

    + *

    * This may or may not be different from the root alias depending upon the * inheritance mapping strategy. * diff --git a/hibernate-core/src/main/java/org/hibernate/persister/entity/mutation/EntityMutationTarget.java b/hibernate-core/src/main/java/org/hibernate/persister/entity/mutation/EntityMutationTarget.java index 09f974b6f2..a218a61da3 100644 --- a/hibernate-core/src/main/java/org/hibernate/persister/entity/mutation/EntityMutationTarget.java +++ b/hibernate-core/src/main/java/org/hibernate/persister/entity/mutation/EntityMutationTarget.java @@ -35,7 +35,7 @@ public interface EntityMutationTarget extends MutationTarget /** * Whether this target defines any potentially skippable tables. - *

    + *

    * A table is considered potentially skippable if it is defined * as inverse or as optional. * diff --git a/hibernate-core/src/main/java/org/hibernate/query/results/complete/package-info.java b/hibernate-core/src/main/java/org/hibernate/query/results/complete/package-info.java index 566ab830f9..6789bc40fc 100644 --- a/hibernate-core/src/main/java/org/hibernate/query/results/complete/package-info.java +++ b/hibernate-core/src/main/java/org/hibernate/query/results/complete/package-info.java @@ -8,7 +8,7 @@ /** * Support for immutable result/fetch builder graph nodes built from static sources * such as JPA's {@link jakarta.persistence.SqlResultSetMapping} or `hbm.xml` mapping - * ``. + * {@code }. * * The differentiation from {@link org.hibernate.query.results.dynamic} is that here * we have up-front knowledge of the complete mapping graph and can perform optimized diff --git a/hibernate-core/src/main/java/org/hibernate/sql/ast/spi/AbstractSqlAstTranslator.java b/hibernate-core/src/main/java/org/hibernate/sql/ast/spi/AbstractSqlAstTranslator.java index 52653caf5d..6635c3c90b 100644 --- a/hibernate-core/src/main/java/org/hibernate/sql/ast/spi/AbstractSqlAstTranslator.java +++ b/hibernate-core/src/main/java/org/hibernate/sql/ast/spi/AbstractSqlAstTranslator.java @@ -7361,7 +7361,7 @@ public abstract class AbstractSqlAstTranslator implemen * and ≥ operators. *

    * Basically, does it support syntax like - * "... where (FIRST_NAME, LAST_NAME) < ('Steve', 'Ebersole') ...". + * "... where (FIRST_NAME, LAST_NAME) < ('Steve', 'Ebersole') ...". * * @return True if this SQL dialect is known to support "row value * constructor" syntax with relational comparison operators; false otherwise. diff --git a/hibernate-core/src/main/java/org/hibernate/sql/model/MutationOperation.java b/hibernate-core/src/main/java/org/hibernate/sql/model/MutationOperation.java index 2b06623e05..e029636132 100644 --- a/hibernate-core/src/main/java/org/hibernate/sql/model/MutationOperation.java +++ b/hibernate-core/src/main/java/org/hibernate/sql/model/MutationOperation.java @@ -30,7 +30,7 @@ import org.hibernate.sql.model.jdbc.JdbcValueDescriptor; * example #3 - insert simple entity (Person) * (1) MutationOperation(INSERT, person) * - * example #4 - insert entity (Person) w/ secondary *non-optional* table & IDENTITY id column + * example #4 - insert entity (Person) w/ secondary *non-optional* table & IDENTITY id column * (1) MutationOperation(INSERT, person) * (2) MutationOperation(INSERT, person_supp) * diff --git a/hibernate-core/src/main/java/org/hibernate/sql/model/ast/TableMutation.java b/hibernate-core/src/main/java/org/hibernate/sql/model/ast/TableMutation.java index 059da88d84..a7b72f80c5 100644 --- a/hibernate-core/src/main/java/org/hibernate/sql/model/ast/TableMutation.java +++ b/hibernate-core/src/main/java/org/hibernate/sql/model/ast/TableMutation.java @@ -19,9 +19,9 @@ import org.hibernate.sql.model.ValuesAnalysis; /** * Describes the mutation of a model table (mapped by an entity or collection) * triggered from flush. - *

    + *

    * Modeled as a SQL AST and processed via {@link org.hibernate.sql.ast.SqlAstTranslator} - *

    + *

    * Acts as a factory for {@link org.hibernate.sql.model.MutationOperation} instances, * which are the forms used to "perform" the mutation using JDBC. * diff --git a/hibernate-core/src/main/java/org/hibernate/tuple/Tuplizer.java b/hibernate-core/src/main/java/org/hibernate/tuple/Tuplizer.java index 5102676690..72c1e37643 100644 --- a/hibernate-core/src/main/java/org/hibernate/tuple/Tuplizer.java +++ b/hibernate-core/src/main/java/org/hibernate/tuple/Tuplizer.java @@ -15,20 +15,19 @@ import org.hibernate.property.access.spi.Getter; * a particular representation of a piece of data, given that * representation's {@link RepresentationMode} (the entity-mode * essentially defining which representation). - *

    + *

    * If that given piece of data is thought of as a data structure, then a tuplizer * is the thing which knows how to

      *
    • create such a data structure appropriately *
    • extract values from and inject values into such a data structure *
    - *

    + *

    * For example, a given piece of data might be represented as a POJO class. * Here, it's representation and entity-mode is POJO. Well a tuplizer for POJO * entity-modes would know how to

      *
    • create the data structure by calling the POJO's constructor *
    • extract and inject values through getters/setter, or by direct field access, etc *
    - *

    * * @author Steve Ebersole * @@ -48,10 +47,10 @@ public interface Tuplizer { /** * Return the pojo class managed by this tuplizer. - *

    + *

    * Need to determine how to best handle this for the Tuplizers for EntityModes * other than POJO. - *

    + *

    * todo : be really nice to not have this here since it is essentially pojo specific... * * @return The persistent class. diff --git a/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialFunction.java b/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialFunction.java index 5aa5941ec6..616e458659 100644 --- a/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialFunction.java +++ b/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialFunction.java @@ -172,7 +172,7 @@ public enum SpatialFunction { /** * The filter function *

    - *

    Corresponds to the Oracle Spatial's "SDO_FILTER" function, or the "&&" operator of PostGIS. + *

    Corresponds to the Oracle Spatial's "SDO_FILTER" function, or the "&&" operator of PostGIS. */ filter( "filter" ), diff --git a/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialRelation.java b/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialRelation.java index 9e85c5b10c..1467e3e62a 100644 --- a/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialRelation.java +++ b/hibernate-spatial/src/main/java/org/hibernate/spatial/SpatialRelation.java @@ -61,7 +61,7 @@ public interface SpatialRelation { /** * The bounding box of the first geometry intersects the bounding box of the second *

    - *

    This relation is not defined in OGC 99-049, it corresponds to the Postgis '&&' operator.

    + *

    This relation is not defined in OGC 99-049, it corresponds to the Postgis '&&' operator.

    */ public static int FILTER = 8; diff --git a/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaExportTask.java b/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaExportTask.java index b93793a319..a2b937a793 100644 --- a/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaExportTask.java +++ b/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaExportTask.java @@ -92,7 +92,7 @@ public class SchemaExportTask extends MatchingTask { } /** - * Set a .cfg.xml file, which will be + * Set a {@code .cfg.xml} file, which will be * loaded as a resource, from the classpath * @param configurationFile the path to the resource */ diff --git a/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaValidatorTask.java b/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaValidatorTask.java index 30ba434168..de87ae0e99 100644 --- a/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaValidatorTask.java +++ b/tooling/hibernate-ant/src/main/java/org/hibernate/tool/hbm2ddl/SchemaValidatorTask.java @@ -81,7 +81,7 @@ public class SchemaValidatorTask extends MatchingTask { } /** - * Set a .cfg.xml file + * Set a {@code .cfg.xml} file * @param configurationFile the file name */ public void setConfig(File configurationFile) {
Configuration parameters
NAMEDEFAULT