HHH-18604 Add json_set function

Author: beikov

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

@@ -1639,6 +1639,7 @@ it is necessary to enable the `hibernate.query.hql.json_functions_enabled` confi
 | `json_query()` | Queries non-scalar values by JSON path in a JSON document
 | `json_arrayagg()` | Creates a JSON array by aggregating values
 | `json_objectagg()` | Creates a JSON object by aggregating values
+| `json_set()` | Inserts/Replaces a value by JSON path within a JSON document
 |===
 
 
@@ -2013,6 +2014,22 @@ include::{json-example-dir-hql}/JsonObjectAggregateTest.java[tags=hql-json-objec
 
 WARNING: Some databases like e.g. MySQL, SAP HANA, DB2 and SQL Server do not support raising an error on duplicate keys.
 
+[[hql-json-set-function]]
+===== `json_set()`
+
+Inserts/Replaces a value by JSON path within a JSON document.
+The function takes 3 arguments, the json document, the json path and the new value to set/insert.
+
+[[hql-json-set-example]]
+====
+[source, java, indent=0]
+----
+include::{json-example-dir-hql}/JsonSetTest.java[tags=hql-json-set-example]
+----
+====
+
+WARNING: SAP HANA, DB2, H2 and HSQLDB do not support this function.
+
 [[hql-user-defined-functions]]
 ==== Native and user-defined functions
 

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

@@ -508,6 +508,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonArray_postgresql();
 		functionFactory.jsonArrayAgg_postgresql( false );
 		functionFactory.jsonObjectAgg_postgresql( false );
+		functionFactory.jsonSet_postgresql();
 
 		// Postgres uses # instead of ^ for XOR
 		functionContributions.getFunctionRegistry().patternDescriptorBuilder( "bitxor", "(?1#?2)" )

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

@@ -660,6 +660,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 			functionFactory.jsonArray_mysql();
 			functionFactory.jsonArrayAgg_mysql();
 			functionFactory.jsonObjectAgg_mysql();
+			functionFactory.jsonSet_mysql();
 		}
 	}
 

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

@@ -316,6 +316,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 			functionFactory.jsonObject_oracle();
 			functionFactory.jsonArray_oracle();
 			functionFactory.jsonArrayAgg_oracle();
+			functionFactory.jsonSet_oracle();
 		}
 	}
 

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

@@ -658,6 +658,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 				functionFactory.jsonObjectAgg_postgresql( false );
 			}
 		}
+		functionFactory.jsonSet_postgresql();
 
 		if ( getVersion().isSameOrAfter( 9, 4 ) ) {
 			functionFactory.makeDateTimeTimestamp();

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

@@ -406,6 +406,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 			functionFactory.jsonExists_sqlserver();
 			functionFactory.jsonObject_sqlserver();
 			functionFactory.jsonArray_sqlserver();
+			functionFactory.jsonSet_sqlserver();
 		}
 		if ( getVersion().isSameOrAfter( 14 ) ) {
 			functionFactory.listagg_stringAggWithinGroup( "varchar(max)" );

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

@@ -475,6 +475,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonArray_postgresql();
 		functionFactory.jsonArrayAgg_postgresql( false );
 		functionFactory.jsonObjectAgg_postgresql( false );
+		functionFactory.jsonSet_postgresql();
 
 		// Postgres uses # instead of ^ for XOR
 		functionContributions.getFunctionRegistry().patternDescriptorBuilder( "bitxor", "(?1#?2)" )

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

@@ -645,6 +645,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonArray_mysql();
 		functionFactory.jsonArrayAgg_mysql();
 		functionFactory.jsonObjectAgg_mysql();
+		functionFactory.jsonSet_mysql();
 	}
 
 	@Override

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

@@ -407,6 +407,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonObject_oracle();
 		functionFactory.jsonArray_oracle();
 		functionFactory.jsonArrayAgg_oracle();
+		functionFactory.jsonSet_oracle();
 	}
 
 	@Override

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

@@ -619,6 +619,7 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 				functionFactory.jsonObjectAgg_postgresql( false );
 			}
 		}
+		functionFactory.jsonSet_postgresql();
 
 		functionFactory.makeDateTimeTimestamp();
 		// Note that PostgreSQL doesn't support the OVER clause for ordered set-aggregate functions