From d3c38f2a8e8c96ecf92a07244d6fc8ad29cd82c4 Mon Sep 17 00:00:00 2001 From: Gavin King Date: Thu, 27 Jan 2022 01:05:45 +0100 Subject: [PATCH] javadoc revision to CommonQueryContract and fix the package info for org.hibernate.persister.walking.spi --- .../entity/AbstractEntityPersister.java | 1 - .../persister/walking/spi/package-info.java | 9 +- .../hibernate/query/CommonQueryContract.java | 300 ++++++++++-------- 3 files changed, 171 insertions(+), 139 deletions(-) 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 ee203e01e0..dfaccca725 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 @@ -19,7 +19,6 @@ import java.util.Comparator; import java.util.HashMap; import java.util.HashSet; import java.util.IdentityHashMap; -import java.util.Iterator; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; diff --git a/hibernate-core/src/main/java/org/hibernate/persister/walking/spi/package-info.java b/hibernate-core/src/main/java/org/hibernate/persister/walking/spi/package-info.java index ca884ee1cf..0c1c587029 100644 --- a/hibernate-core/src/main/java/org/hibernate/persister/walking/spi/package-info.java +++ b/hibernate-core/src/main/java/org/hibernate/persister/walking/spi/package-info.java @@ -4,9 +4,12 @@ * License: GNU Lesser General Public License (LGPL), version 2.1 or later. * See the lgpl.txt file in the root directory or . */ -package org.hibernate.persister.walking.spi; /** - * Package for "walking" associations through metadata definition. Ultimately want {@link org.hibernate.persister.walking.spi.AttributeDefinition} and - * {@link AttributeSource} etc to become part of the persister model. + * Package for "walking" associations through metadata definition. Ultimately + * want {@link org.hibernate.persister.walking.spi.AttributeDefinition} and + * {@link org.hibernate.persister.walking.spi.AttributeSource} etc to become + * part of the persister model. */ +package org.hibernate.persister.walking.spi; + diff --git a/hibernate-core/src/main/java/org/hibernate/query/CommonQueryContract.java b/hibernate-core/src/main/java/org/hibernate/query/CommonQueryContract.java index 833c5e4d1f..900c29f01f 100644 --- a/hibernate-core/src/main/java/org/hibernate/query/CommonQueryContract.java +++ b/hibernate-core/src/main/java/org/hibernate/query/CommonQueryContract.java @@ -20,8 +20,10 @@ import jakarta.persistence.Parameter; import jakarta.persistence.TemporalType; /** - * Defines the aspects of query definition that apply to all forms of - * querying - HQL, Criteria and ProcedureCall + * Defines the aspects of query execution and parameter binding that apply to all + * forms of querying - HQL, {@linkplain jakarta.persistence.criteria.CriteriaBuilder + * criteria queries} and {@link org.hibernate.procedure.ProcedureCall stored + * procedure calls}. * * @author Steve Ebersole * @author Gavin King @@ -29,8 +31,9 @@ import jakarta.persistence.TemporalType; public interface CommonQueryContract { /** - * The FlushModeType in effect for this query. By default, the query - * inherits the FlushMode of the Session from which it originates. + * The JPA {@link FlushModeType} in effect for this query. By default, the + * query inherits the {@link FlushMode} of the {@link Session} from which + * it originates. * * @see #getHibernateFlushMode * @see Session#getHibernateFlushMode @@ -38,7 +41,7 @@ public interface CommonQueryContract { FlushModeType getFlushMode(); /** - * Set the FlushMode in to use for this query. + * Set the {@link FlushMode} in to use for this query. * * @implNote Setting to {@code null} ultimately indicates to use the * FlushMode of the Session. Use {@link #setHibernateFlushMode} passing @@ -51,19 +54,20 @@ public interface CommonQueryContract { CommonQueryContract setFlushMode(FlushModeType flushMode); /** - * The FlushMode in effect for this query. By default, the query - * inherits the FlushMode of the Session from which it originates. + * The {@link FlushMode} in effect for this query. By default, the query + * inherits the {@code FlushMode} of the {@link Session} from which it + * originates. * * @see Session#getHibernateFlushMode */ FlushMode getHibernateFlushMode(); /** - * Set the current FlushMode in effect for this query. + * Set the current {@link FlushMode} in effect for this query. * * @implNote Setting to {@code null} ultimately indicates to use the - * FlushMode of the Session. Use {@link FlushMode#MANUAL} instead to - * indicate that no automatic flushing should occur + * {@link FlushMode} of the Session. Use {@link FlushMode#MANUAL} + * instead to indicate that no automatic flushing should occur. * * @see #getHibernateFlushMode() * @see Session#getHibernateFlushMode() @@ -71,8 +75,12 @@ public interface CommonQueryContract { CommonQueryContract setHibernateFlushMode(FlushMode flushMode); /** - * Obtain the query timeout in seconds. This value is eventually passed along to the JDBC query via - * {@link java.sql.Statement#setQueryTimeout(int)}. Zero indicates no timeout. + * Obtain the query timeout in seconds. + *

+ * This value is eventually passed along to the JDBC statement via + * {@link java.sql.Statement#setQueryTimeout(int)}. + *

+ * A value of zero indicates no timeout. * * @see java.sql.Statement#getQueryTimeout() * @see java.sql.Statement#setQueryTimeout(int) @@ -80,12 +88,16 @@ public interface CommonQueryContract { Integer getTimeout(); /** - * Set the query timeout in seconds. + * Set the query timeout in seconds. + *

+ * Any value set here is eventually passed directly along to the + * {@linkplain java.sql.Statement#setQueryTimeout(int) JDBC + * statement}, which expressly disallows negative values. So + * negative values should be avoided as a general rule. + *

+ * A value of zero indicates no timeout. * - * NOTE it is important to understand that any value set here is eventually passed directly through to the JDBC - * Statement which expressly disallows negative values. So negative values should be avoided as a general rule. - * - * @param timeout the timeout in seconds + * @param timeout the timeout in seconds * * @return {@code this}, for method chaining * @@ -93,36 +105,44 @@ public interface CommonQueryContract { */ CommonQueryContract setTimeout(int timeout); + /** + * Get the comment that has been set for this query, if any. + */ String getComment(); + /** + * Set a comment for this query. + * + * @see Query#setComment(String) + */ CommonQueryContract setComment(String comment); /** - * Apply hints to the query + * Apply hints to the query. */ CommonQueryContract setHint(String hintName, Object value); /** - * Bind the given argument to a named query parameter + * Bind the given argument to a named query parameter. *

- * If the type of the parameter cannot be inferred from the context in which - * it occurs, use one of the forms accept a "type". + * If the type of the parameter cannot be inferred from the context in + * which it occurs, use one of the forms which accepts a "type". * * @see #setParameter(String, Object, Class) * @see #setParameter(String, Object, BindableType) */ - CommonQueryContract setParameter(String name, Object value); + CommonQueryContract setParameter(String parameter, Object value); /** * Bind the given argument to a named query parameter using the given - * Class reference to attempt to determine the {@link BindableType} - * to use. If unable to determine an appropriate {@link BindableType}, - * {@link #setParameter(String, Object)} is used + * {@link Class} reference to attempt to infer the {@link BindableType}. + * If unable to infer an appropriate {@link BindableType}, fall back to + * {@link #setParameter(String, Object)}. * * @see BindableType#parameterType(Class) * @see #setParameter(String, Object, BindableType) */ -

CommonQueryContract setParameter(String name, P value, Class

type); +

CommonQueryContract setParameter(String parameter, P value, Class

type); /** * Bind the given argument to a named query parameter using the given @@ -130,76 +150,76 @@ public interface CommonQueryContract { * * @see BindableType#parameterType */ -

CommonQueryContract setParameter(String name, P value, BindableType

type); +

CommonQueryContract setParameter(String parameter, P value, BindableType

type); /** - * Bind an {@link Instant} value to the named query parameter using just the portion - * indicated by the given {@link TemporalType}. + * Bind an {@link Instant} to the named query parameter using just the + * portion indicated by the given {@link TemporalType}. */ - CommonQueryContract setParameter(String name, Instant value, TemporalType temporalType); + CommonQueryContract setParameter(String parameter, Instant value, TemporalType temporalType); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(String, Calendar, TemporalType) */ - CommonQueryContract setParameter(String name, Calendar value, TemporalType temporalType); + CommonQueryContract setParameter(String parameter, Calendar value, TemporalType temporalType); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(String, Date, TemporalType) */ - CommonQueryContract setParameter(String name, Date value, TemporalType temporalType); + CommonQueryContract setParameter(String parameter, Date value, TemporalType temporalType); /** - * Bind the given argument to a positional query parameter. + * Bind the given argument to an ordinal query parameter. *

* If the type of the parameter cannot be inferred from the context in which - * it occurs, use one of the forms accept a "type". + * it occurs, use one of the forms which accepts a "type". * * @see #setParameter(int, Object, Class) * @see #setParameter(int, Object, BindableType) */ - CommonQueryContract setParameter(int position, Object value); + CommonQueryContract setParameter(int parameter, Object value); /** - * Bind the given argument to a positional query parameter using the given - * Class reference to attempt to determine the {@link BindableType} - * to use. If unable to determine an appropriate {@link BindableType}, - * {@link #setParameter(int, Object)} is used + * Bind the given argument to an ordinal query parameter using the given + * {@link Class} reference to attempt to infer the {@link BindableType}. + * If unable to infer an appropriate {@link BindableType}, fall back to + * {@link #setParameter(int, Object)}. * * @see BindableType#parameterType(Class) * @see #setParameter(int, Object, BindableType) */ -

CommonQueryContract setParameter(int position, P value, Class

type); +

CommonQueryContract setParameter(int parameter, P value, Class

type); /** - * Bind the given argument to a positional query parameter using the given + * Bind the given argument to an ordinal query parameter using the given * {@link BindableType}. * * @see BindableType#parameterType */ -

CommonQueryContract setParameter(int position, P value, BindableType

type); +

CommonQueryContract setParameter(int parameter, P value, BindableType

type); /** - * Bind an {@link Instant} value to the positional query parameter using just the portion - * indicated by the given {@link TemporalType}. + * Bind an {@link Instant} to an ordinal query parameter using just the + * portion indicated by the given {@link TemporalType}. */ - CommonQueryContract setParameter(int position, Instant value, TemporalType temporalType); + CommonQueryContract setParameter(int parameter, Instant value, TemporalType temporalType); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(int, Date, TemporalType) */ - CommonQueryContract setParameter(int position, Date value, TemporalType temporalType); + CommonQueryContract setParameter(int parameter, Date value, TemporalType temporalType); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(int, Calendar, TemporalType) */ - CommonQueryContract setParameter(int position, Calendar value, TemporalType temporalType); + CommonQueryContract setParameter(int parameter, Calendar value, TemporalType temporalType); /** * Bind an argument to the query parameter represented by the given * {@link QueryParameter}. *

* If the type of the parameter cannot be inferred from the context in which - * it occurs, use on of the forms accept a "type". + * it occurs, use one of the forms which accepts a "type". * * @see #setParameter(QueryParameter, Object, BindableType) * @@ -212,9 +232,9 @@ public interface CommonQueryContract { /** * Bind an argument to the query parameter represented by the given - * {@link QueryParameter} using the given Class reference to attempt to - * determine the {@link BindableType} to use. If unable to determine - * an appropriate {@link BindableType}, {@link #setParameter(QueryParameter, Object)} is used + * {@link QueryParameter}, using the given {@link Class} reference to attempt + * to infer the {@link BindableType} to use. If unable to infer an appropriate + * {@link BindableType}, fall back to {@link #setParameter(QueryParameter, Object)}. * * @param parameter the query parameter memento * @param value the argument, which might be null @@ -229,28 +249,28 @@ public interface CommonQueryContract { /** * Bind an argument to the query parameter represented by the given - * {@link QueryParameter} using the given {@link BindableType}. + * {@link QueryParameter}, using the given {@link BindableType}. * * @param parameter the query parameter memento * @param val the argument, which might be null - * @param type an {@link BindableType} representing the type of the parameter + * @param type a {@link BindableType} representing the type of the parameter * * @return {@code this}, for method chaining */

CommonQueryContract setParameter(QueryParameter

parameter, P val, BindableType

type); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(Parameter, Object) */ CommonQueryContract setParameter(Parameter param, T value); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(Parameter, Calendar, TemporalType) */ CommonQueryContract setParameter(Parameter param, Calendar value, TemporalType temporalType); /** - * {@link jakarta.persistence.Query} override + * @see jakarta.persistence.Query#setParameter(Parameter, Date, TemporalType) */ CommonQueryContract setParameter(Parameter param, Date value, TemporalType temporalType); @@ -258,39 +278,43 @@ public interface CommonQueryContract { * Bind multiple arguments to a named query parameter. *

* The "type mapping" for the binding is inferred from the type of - * the first collection element + * the first collection element. * * @see #setParameterList(java.lang.String, java.util.Collection, BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ - CommonQueryContract setParameterList(String name, @SuppressWarnings("rawtypes") Collection values); + CommonQueryContract setParameterList(String parameter, @SuppressWarnings("rawtypes") Collection values); /** * Bind multiple arguments to a named query parameter using the given - * Class reference to attempt to determine the {@link BindableType} - * to use. If unable to determine an appropriate {@link BindableType}, - * {@link #setParameterList(String, Collection)} is used + * {@link Class} reference to attempt to infer the {@link BindableType} + * If unable to infer an appropriate {@link BindableType}, fall back to + * {@link #setParameterList(String, Collection)}. * * @see BindableType#parameterType(Class) * @see #setParameterList(java.lang.String, java.util.Collection, BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(String name, Collection values, Class

javaType); +

CommonQueryContract setParameterList(String parameter, Collection values, Class

javaType); /** - * Bind multiple arguments to a named query parameter using the passed type-mapping. + * Bind multiple arguments to a named query parameter using the given + * {@link BindableType}. * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(String name, Collection values, BindableType

type); +

CommonQueryContract setParameterList(String parameter, Collection values, BindableType

type); /** @@ -299,11 +323,12 @@ public interface CommonQueryContract { * The "type mapping" for the binding is inferred from the type of * the first collection element * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ - CommonQueryContract setParameterList(String name, Object[] values); + CommonQueryContract setParameterList(String parameter, Object[] values); /** * Bind multiple arguments to a named query parameter using the given @@ -314,93 +339,104 @@ public interface CommonQueryContract { * @see BindableType#parameterType(Class) * @see #setParameterList(java.lang.String, Object[], BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(String name, P[] values, Class

javaType); +

CommonQueryContract setParameterList(String parameter, P[] values, Class

javaType); /** - * Bind multiple arguments to a named query parameter using the passed type-mapping. + * Bind multiple arguments to a named query parameter using the given + * {@link BindableType}. * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(String name, P[] values, BindableType

type); +

CommonQueryContract setParameterList(String parameter, P[] values, BindableType

type); /** - * Bind multiple arguments to a positional query parameter. + * Bind multiple arguments to an ordinal query parameter. *

* The "type mapping" for the binding is inferred from the type of * the first collection element * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ - CommonQueryContract setParameterList(int position, @SuppressWarnings("rawtypes") Collection values); + CommonQueryContract setParameterList(int parameter, @SuppressWarnings("rawtypes") Collection values); /** - * Bind multiple arguments to a positional query parameter using the given - * Class reference to attempt to determine the {@link BindableType} - * to use. If unable to determine an appropriate {@link BindableType}, - * {@link #setParameterList(String, Collection)} is used + * Bind multiple arguments to an ordinal query parameter using the given + * {@link Class} reference to attempt to infer the {@link BindableType}. + * If unable to infer an appropriate {@link BindableType}, fall back to + * {@link #setParameterList(String, Collection)}. * * @see BindableType#parameterType(Class) * @see #setParameterList(int, Collection, BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(int position, Collection values, Class

javaType); +

CommonQueryContract setParameterList(int parameter, Collection values, Class

javaType); /** - * Bind multiple arguments to a positional query parameter using the passed type-mapping. + * Bind multiple arguments to an ordinal query parameter using the given + * {@link BindableType}. * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(int position, Collection values, BindableType

type); +

CommonQueryContract setParameterList(int parameter, Collection values, BindableType

type); /** - * Bind multiple arguments to a positional query parameter. + * Bind multiple arguments to an ordinal query parameter. *

* The "type mapping" for the binding is inferred from the type of * the first collection element * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ - CommonQueryContract setParameterList(int position, Object[] values); + CommonQueryContract setParameterList(int parameter, Object[] values); /** - * Bind multiple arguments to a positional query parameter using the given - * Class reference to attempt to determine the {@link BindableType} - * to use. If unable to determine an appropriate {@link BindableType}, - * {@link #setParameterList(String, Collection)} is used + * Bind multiple arguments to an ordinal query parameter using the given + * {@link Class} reference to attempt to infer the {@link BindableType}. + * If unable to infer an appropriate {@link BindableType}, fall back to + * {@link #setParameterList(String, Collection)}. * * @see BindableType#parameterType(Class) * @see #setParameterList(int, Object[], BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(int position, P[] values, Class

javaType); +

CommonQueryContract setParameterList(int parameter, P[] values, Class

javaType); /** - * Bind multiple arguments to a positional query parameter using the passed type-mapping. + * Bind multiple arguments to an ordinal query parameter using the given + * {@link BindableType}. * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ -

CommonQueryContract setParameterList(int position, P[] values, BindableType

type); +

CommonQueryContract setParameterList(int parameter, P[] values, BindableType

type); /** * Bind multiple arguments to the query parameter represented by the @@ -418,15 +454,16 @@ public interface CommonQueryContract { /** * Bind multiple arguments to the query parameter represented by the - * given {@link QueryParameter} using the given Class reference to attempt - * to determine the {@link BindableType} to use. If unable to - * determine an appropriate {@link BindableType}, - * {@link #setParameterList(String, Collection)} is used + * given {@link QueryParameter} using the given {@link Class} reference + * to attempt to infer the {@link BindableType} to use. If unable to + * infer an appropriate {@link BindableType}, fall back to using + * {@link #setParameterList(String, Collection)}. * * @see BindableType#parameterType(Class) * @see #setParameterList(QueryParameter, java.util.Collection, BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ @@ -434,14 +471,10 @@ public interface CommonQueryContract { /** * Bind multiple arguments to the query parameter represented by the - * given {@link QueryParameter}, inferring the {@link BindableType}. + * given {@link QueryParameter}, using the given {@link BindableType}. * - * Bind multiple arguments to a named query parameter. - *

- * The "type mapping" for the binding is inferred from the type of - * the first collection element - * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ @@ -449,11 +482,11 @@ public interface CommonQueryContract { /** * Bind multiple arguments to the query parameter represented by the - * given {@link QueryParameter} + * given {@link QueryParameter}. *

* The type of the parameter is inferred between the context in which it - * occurs, the type associated with the QueryParameter and the type of - * the first given argument. + * occurs, the type associated with the {@code QueryParameter} and the + * type of the first given argument. * * @param parameter the parameter memento * @param values a collection of arguments @@ -464,15 +497,16 @@ public interface CommonQueryContract { /** * Bind multiple arguments to the query parameter represented by the - * given {@link QueryParameter} using the given Class reference to attempt - * to determine the {@link BindableType} to use. If unable to - * determine an appropriate {@link BindableType}, - * {@link #setParameterList(String, Collection)} is used + * given {@link QueryParameter} using the given {@link Class} reference + * to attempt to infer the {@link BindableType} to use. If unable to + * infer an appropriate {@link BindableType}, fall back to using + * {@link #setParameterList(String, Collection)}. * * @see BindableType#parameterType(Class) * @see #setParameterList(QueryParameter, Object[], BindableType) * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */ @@ -480,23 +514,19 @@ public interface CommonQueryContract { /** * Bind multiple arguments to the query parameter represented by the - * given {@link QueryParameter}, inferring the {@link BindableType}. + * given {@link QueryParameter}, using the given the {@link BindableType}. * - * Bind multiple arguments to a named query parameter. - *

- * The "type mapping" for the binding is inferred from the type of - * the first collection element - * - * @apiNote This is used for binding a list of values to an expression such as {@code entity.field in (:values)}. + * @apiNote This is used for binding a list of values to an expression + * such as {@code entity.field in (:values)}. * * @return {@code this}, for method chaining */

CommonQueryContract setParameterList(QueryParameter

parameter, P[] values, BindableType

type); /** - * Bind the property values of the given bean to named parameters of the query, - * matching property names with parameter names and mapping property types to - * Hibernate types using heuristics. + * Bind the property values of the given bean to named parameters of + * the query, matching property names with parameter names and mapping + * property types to Hibernate types using heuristics. * * @param bean any JavaBean or POJO * @@ -505,9 +535,9 @@ public interface CommonQueryContract { CommonQueryContract setProperties(Object bean); /** - * Bind the values of the given {@code Map} to named parameters of the query, - * matching key names with parameter names and mapping value types to Hibernate - * types using heuristics. + * Bind the values of the given {@code Map} to named parameters of the + * query, matching key names with parameter names and mapping value types + * to Hibernate types using heuristics. * * @param bean a {@link Map} of names to arguments *