HHH-17335 Add array_prepend and array_append functions

Author: beikov

documentation/src/main/asciidoc/userguide/chapters/query/hql/QueryLanguage.adoc

@@ -1123,6 +1123,8 @@ The following functions deal with SQL array types, which are not supported on ev
 | `array_position()` | Determines the position of an element in an array
 | `array_length()` | Determines the length of an array
 | `array_concat()` | Concatenates array with each other in order
+| `array_prepend()` | Prepends element to array
+| `array_append()` | Appends element to array
 | `array_contains_all()` | Determines if one array holds all elements of another array
 | `array_contains_all_nullable()` | Determines if one array holds all elements of another array, supporting null elements
 | `array_contains_any()` | Determines if one array holds at least one element of another array
@@ -1204,6 +1206,32 @@ include::{array-example-dir-hql}/ArrayConcatTest.java[tags=hql-array-concat-exam
 ----
 ====
 
+[[hql-array-prepend-functions]]
+===== `array_prepend()`
+
+Prepends element to array. Returns `null` if the array argument is `null`.
+
+[[hql-array-prepend-example]]
+====
+[source, JAVA, indent=0]
+----
+include::{array-example-dir-hql}/ArrayPrependTest.java[tags=hql-array-prepend-example]
+----
+====
+
+[[hql-array-append-functions]]
+===== `array_append()`
+
+Appends element to array. Returns `null` if the array argument is `null`.
+
+[[hql-array-append-example]]
+====
+[source, JAVA, indent=0]
+----
+include::{array-example-dir-hql}/ArrayAppendTest.java[tags=hql-array-append-example]
+----
+====
+
 [[hql-array-contains-quantified-functions]]
 ===== `array_contains_all()` and `array_contains_any()`
 

hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/CockroachLegacyDialect.java

@@ -468,6 +468,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayPosition_postgresql();
 		functionFactory.arrayLength_cardinality();
 		functionFactory.arrayConcat_postgresql();
+		functionFactory.arrayPrepend_postgresql();
+		functionFactory.arrayAppend_postgresql();
 		functionFactory.arrayContainsAll_operator();
 		functionFactory.arrayContainsAny_operator();
 		functionFactory.arrayContainsAllNullable_operator();

hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/H2LegacyDialect.java

@@ -376,6 +376,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 				functionFactory.arrayContainsNull();
 				functionFactory.arrayLength_cardinality();
 				functionFactory.arrayConcat_operator();
+				functionFactory.arrayPrepend_operator();
+				functionFactory.arrayAppend_operator();
 				functionFactory.arrayContainsAll_h2();
 				functionFactory.arrayContainsAny_h2();
 				functionFactory.arrayContainsAllNullable_h2();

hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/HSQLLegacyDialect.java

@@ -254,6 +254,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayPosition_hsql();
 		functionFactory.arrayLength_cardinality();
 		functionFactory.arrayConcat_operator();
+		functionFactory.arrayPrepend_operator();
+		functionFactory.arrayAppend_operator();
 		functionFactory.arrayContainsAll_hsql();
 		functionFactory.arrayContainsAny_hsql();
 		functionFactory.arrayContainsAllNullable_hsql();

hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/OracleLegacyDialect.java

@@ -290,6 +290,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayPosition_oracle();
 		functionFactory.arrayLength_oracle();
 		functionFactory.arrayConcat_oracle();
+		functionFactory.arrayPrepend_oracle();
+		functionFactory.arrayAppend_oracle();
 		functionFactory.arrayContainsAll_oracle();
 		functionFactory.arrayContainsAny_oracle();
 		functionFactory.arrayContainsAllNullable_oracle();

hibernate-community-dialects/src/main/java/org/hibernate/community/dialect/PostgreSQLLegacyDialect.java

@@ -588,6 +588,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayPosition_postgresql();
 		functionFactory.arrayLength_cardinality();
 		functionFactory.arrayConcat_postgresql();
+		functionFactory.arrayPrepend_postgresql();
+		functionFactory.arrayAppend_postgresql();
 		functionFactory.arrayContainsAll_operator();
 		functionFactory.arrayContainsAny_operator();
 		functionFactory.arrayContainsAllNullable_operator();

hibernate-core/src/main/java/org/hibernate/dialect/CockroachDialect.java

@@ -455,6 +455,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayPosition_postgresql();
 		functionFactory.arrayLength_cardinality();
 		functionFactory.arrayConcat_postgresql();
+		functionFactory.arrayPrepend_postgresql();
+		functionFactory.arrayAppend_postgresql();
 		functionFactory.arrayContainsAll_operator();
 		functionFactory.arrayContainsAny_operator();
 		functionFactory.arrayContainsAllNullable_operator();

hibernate-core/src/main/java/org/hibernate/dialect/H2Dialect.java

@@ -315,6 +315,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayContainsNull();
 		functionFactory.arrayLength_cardinality();
 		functionFactory.arrayConcat_operator();
+		functionFactory.arrayPrepend_operator();
+		functionFactory.arrayAppend_operator();
 		functionFactory.arrayContainsAll_h2();
 		functionFactory.arrayContainsAny_h2();
 		functionFactory.arrayContainsAllNullable_h2();

hibernate-core/src/main/java/org/hibernate/dialect/HSQLDialect.java

@@ -194,6 +194,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.arrayPosition_hsql();
 		functionFactory.arrayLength_cardinality();
 		functionFactory.arrayConcat_operator();
+		functionFactory.arrayPrepend_operator();
+		functionFactory.arrayAppend_operator();
 		functionFactory.arrayContainsAll_hsql();
 		functionFactory.arrayContainsAny_hsql();
 		functionFactory.arrayContainsAllNullable_hsql();

hibernate-core/src/main/java/org/hibernate/dialect/MySQLSqlAstTranslator.java

@@ -46,7 +46,7 @@ public static String getSqlType(CastTarget castTarget, Dialect dialect) {
 	}
 
 	public static String getSqlType(CastTarget castTarget, SessionFactoryImplementor factory) {
-		final String sqlType = getSqlTypeName( castTarget, factory );
+		final String sqlType = getCastTypeName( castTarget, factory );
 		return getSqlType( castTarget, sqlType, factory.getJdbcServices().getDialect() );
 	}