CORE-16870 Support nullable parameters in queries (#1417)

Right now nullable parameters are not supported in named queries, after this change we'll support setting null parameters. This feature was requested by various teams before.

application/src/main/java/net/corda/v5/application/persistence/ParameterizedQuery.java

@@ -1,6 +1,7 @@
 package net.corda.v5.application.persistence;
 
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 import java.util.Map;
 
@@ -54,7 +55,7 @@ public interface ParameterizedQuery<R> extends PagedQuery<R> {
      * @return the same {@link ParameterizedQuery} instance.
      */
     @NotNull
-    ParameterizedQuery<R> setParameter(@NotNull String name, @NotNull Object value);
+    ParameterizedQuery<R> setParameter(@NotNull String name, @Nullable Object value);
 
     /**
      * Sets the parameters as a {@link Map}.

data/avro-schema/src/main/resources/avro/net/corda/data/persistence/FindWithNamedQuery.avsc

@@ -13,7 +13,7 @@
       "name": "parameters",
       "type": {
         "type": "map",
-        "values": "bytes"
+        "values": ["null", "bytes"]
       },
       "doc": "Parameters for the query, with each value represented as a bytes array payload serialized in AMQP format. Null values must be tested using IS NULL in the query; it is not possible to pass in a null as a parameter value. "
     },

gradle.properties

@@ -5,7 +5,7 @@ cordaProductVersion = 5.2.0
 # NOTE: update this each time this module contains a breaking change
 ## NOTE: currently this is a top level revision, so all API versions will line up, but this could be moved to
 ##   a per module property in which case module versions can change independently.
-cordaApiRevision = 21
+cordaApiRevision = 22
 
 # Main
 kotlin.stdlib.default.dependency = false

ledger/ledger-utxo/src/main/java/net/corda/v5/ledger/utxo/query/VaultNamedParameterizedQuery.java

@@ -7,6 +7,7 @@
 import net.corda.v5.ledger.utxo.StateAndRef;
 import net.corda.v5.ledger.utxo.UtxoLedgerService;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 import java.time.Instant;
 import java.util.Map;
@@ -45,7 +46,7 @@ public interface VaultNamedParameterizedQuery<R> extends ParameterizedQuery<R> {
      */
     @Override
     @NotNull
-    VaultNamedParameterizedQuery<R> setParameter(@NotNull String name, @NotNull Object value);
+    VaultNamedParameterizedQuery<R> setParameter(@NotNull String name, @Nullable Object value);
 
     /**
      * @see ParameterizedQuery#setParameters(Map)