HHH-19035 add UserType.isComparable()

 To allow a UserType to override the determination made by the JdbcType.

Author: gavinking

hibernate-core/src/main/java/org/hibernate/query/sqm/produce/function/ArgumentTypesValidator.java

@@ -203,7 +203,10 @@ private int validateArgument(int paramNumber, JdbcMappingContainer expressionTyp
 		final int jdbcTypeCount = expressionType.getJdbcTypeCount();
 		for ( int i = 0; i < jdbcTypeCount; i++ ) {
 			final JdbcMapping mapping = expressionType.getJdbcMapping( i );
-			FunctionParameterType type = paramNumber < types.length ? types[paramNumber++] : types[types.length - 1];
+			final FunctionParameterType type =
+					paramNumber < types.length
+							? types[paramNumber++]
+							: types[types.length - 1];
 			if ( type != null ) {
 				checkArgumentType(
 						paramNumber,

hibernate-core/src/main/java/org/hibernate/type/internal/UserTypeSqlTypeAdapter.java renamed to hibernate-core/src/main/java/org/hibernate/type/internal/UserTypeJdbcTypeAdapter.java

@@ -53,6 +53,12 @@ public int getJdbcTypeCode() {
 		return userType.getSqlType();
 	}
 
+	@Override
+	public boolean isComparable() {
+		final Boolean comparable = userType.isComparable();
+		return comparable == null ? JdbcType.super.isComparable() : comparable;
+	}
+
 	@Override
 	@SuppressWarnings("unchecked")
 	public <X> ValueBinder<X> getBinder(JavaType<X> javaType) {

hibernate-core/src/main/java/org/hibernate/usertype/UserType.java

@@ -524,4 +524,19 @@ default JdbcType getJdbcType(TypeConfiguration typeConfiguration) {
 	default BasicValueConverter<J, Object> getValueConverter() {
 		return null;
 	}
+
+	/**
+	 * Is this a comparable type in HQL? A type is comparable if it may be
+	 * used with comparison operators like {@code >=}, and with {@code max()}
+	 * and {@code min()}.
+	 *
+	 * @return {@code null} by default to indicate that the assigned
+	 *         {@code JdbcType} should decide
+	 *
+	 * @since 7.0
+	 */
+	@Incubating
+	default Boolean isComparable() {
+		return null;
+	}
 }