HHH-9576 - Use JDBC bind variables for handling JPA Criteria query numeric literals

Document the new setting in the Configurations chapter

Author: vladmihalcea

documentation/src/main/asciidoc/userguide/appendices/Annotations.adoc

@@ -1284,7 +1284,7 @@ See the <<chapters/query/native/Native.adoc#sql-custom-crud-secondary-table-exam
 The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/Tables.html[`@Tables`] annotation is used to group multiple <<annotations-hibernate-table>> annotations.
 
 [[annotations-hibernate-target]]
-==== `@Target`Se
+==== `@Target`
 The https://docs.jboss.org/hibernate/orm/{majorMinorVersion}/javadocs/org/hibernate/annotations/Target.html[`@Target`] annotation is used to specify an explicit target implementation when the current annotated association is using an interface type.
 
 See the <<chapters/domain/basic_types.adoc#mapping-Target,`@Target` mapping>> section for more info.

documentation/src/main/asciidoc/userguide/appendices/Configurations.adoc

@@ -398,8 +398,21 @@ Can reference a
 `StatementInspector` implementation class name (fully-qualified class name).
 
 `*hibernate.query.validate_parameters*` (e.g. `true` (default value) or `false`)::
- This configuration property can be used to disable parameters validation performed by `org.hibernate.query.Query#setParameter` when the the Session is bootstrapped via JPA
- `javax.persistence.EntityManagerFactory`
+This configuration property can be used to disable parameters validation performed by `org.hibernate.query.Query#setParameter` when the the Session is bootstrapped via JPA
+`javax.persistence.EntityManagerFactory`
+
+`*hibernate.criteria.literal_handling_mode*` (e.g. `AUTO` (default value), `BIND` or `INLINE`)::
+By default, Criteria queries uses bind parameters for any literal that is not a numeric value.
+However, to increase the likelihood of JDBC statement caching, you might want to use bind parameters for numeric values too.
++
+The `org.hibernate.query.criteria.LiteralHandlingMode#BIND` mode will use bind variables for any literal value.
+The `org.hibernate.query.criteria.LiteralHandlingMode#INLINE` mode will inline literal values as-is.
++
+To prevent SQL injection, never use `org.hibernate.query.criteria.LiteralHandlingMode#INLINE` with String variables.
+Always use constants with the `org.hibernate.query.criteria.LiteralHandlingMode#INLINE` mode.
++
+Valid options are defined by the `org.hibernate.query.criteria.LiteralHandlingMode` enum.
+The default value is `org.hibernate.query.criteria.LiteralHandlingMode#AUTO`.
 
 ==== Multi-table bulk HQL operations