HHH-18604 Add json_insert and json_replace function

Author: beikov

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

@@ -2047,6 +2047,42 @@ include::{json-example-dir-hql}/JsonRemoveTest.java[tags=hql-json-remove-example
 
 WARNING: SAP HANA, DB2, H2 and HSQLDB do not support this function.
 
+[[hql-json-replace-function]]
+===== `json_replace()`
+
+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.
+A value will not be inserted if the key is missing, only the values of existing keys are replaced.
+
+[[hql-json-replace-example]]
+====
+[source, java, indent=0]
+----
+include::{json-example-dir-hql}/JsonReplaceTest.java[tags=hql-json-replace-example]
+----
+====
+
+WARNING: SAP HANA, DB2, H2 and HSQLDB do not support this function.
+
+[[hql-json-insert-function]]
+===== `json_insert()`
+
+Inserts a value by JSON path in a JSON document.
+The function takes 3 arguments, the json document, the json path and the value to insert.
+When the JSON document contains a value for a JSON path, no insertion happens,
+unless the value is an array, in which case the value will be appended to that array.
+If no value exists for a JSON path, the value will be inserted under the key as specified through the JSON path.
+
+[[hql-json-insert-example]]
+====
+[source, java, indent=0]
+----
+include::{json-example-dir-hql}/JsonInsertTest.java[tags=hql-json-insert-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

@@ -509,7 +509,9 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonArrayAgg_postgresql( false );
 		functionFactory.jsonObjectAgg_postgresql( false );
 		functionFactory.jsonSet_postgresql();
-		functionFactory.jsonRemove_postgresql();
+		functionFactory.jsonRemove_cockroachdb();
+		functionFactory.jsonReplace_postgresql();
+		functionFactory.jsonInsert_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

@@ -662,6 +662,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 			functionFactory.jsonObjectAgg_mysql();
 			functionFactory.jsonSet_mysql();
 			functionFactory.jsonRemove_mysql();
+			functionFactory.jsonReplace_mysql();
+			functionFactory.jsonInsert_mysql();
 		}
 	}
 

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

@@ -319,6 +319,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 			functionFactory.jsonObjectAgg_oracle();
 			functionFactory.jsonSet_oracle();
 			functionFactory.jsonRemove_oracle();
+			functionFactory.jsonReplace_oracle();
+			functionFactory.jsonInsert_oracle();
 		}
 	}
 

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

@@ -660,6 +660,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		}
 		functionFactory.jsonSet_postgresql();
 		functionFactory.jsonRemove_postgresql();
+		functionFactory.jsonReplace_postgresql();
+		functionFactory.jsonInsert_postgresql();
 
 		if ( getVersion().isSameOrAfter( 9, 4 ) ) {
 			functionFactory.makeDateTimeTimestamp();

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

@@ -408,6 +408,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 			functionFactory.jsonArray_sqlserver();
 			functionFactory.jsonSet_sqlserver();
 			functionFactory.jsonRemove_sqlserver();
+			functionFactory.jsonReplace_sqlserver();
+			functionFactory.jsonInsert_sqlserver();
 		}
 		if ( getVersion().isSameOrAfter( 14 ) ) {
 			functionFactory.listagg_stringAggWithinGroup( "varchar(max)" );

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

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

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

@@ -647,6 +647,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonObjectAgg_mysql();
 		functionFactory.jsonSet_mysql();
 		functionFactory.jsonRemove_mysql();
+		functionFactory.jsonReplace_mysql();
+		functionFactory.jsonInsert_mysql();
 	}
 
 	@Override

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

@@ -410,6 +410,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		functionFactory.jsonObjectAgg_oracle();
 		functionFactory.jsonSet_oracle();
 		functionFactory.jsonRemove_oracle();
+		functionFactory.jsonReplace_oracle();
+		functionFactory.jsonInsert_oracle();
 	}
 
 	@Override

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

@@ -621,6 +621,8 @@ public void initializeFunctionRegistry(FunctionContributions functionContributio
 		}
 		functionFactory.jsonSet_postgresql();
 		functionFactory.jsonRemove_postgresql();
+		functionFactory.jsonReplace_postgresql();
+		functionFactory.jsonInsert_postgresql();
 
 		functionFactory.makeDateTimeTimestamp();
 		// Note that PostgreSQL doesn't support the OVER clause for ordered set-aggregate functions