Package io.quarkus.redis.datasource.json

Interface ReactiveJsonCommands<K>

Type Parameters:
K - the type of the key
All Superinterfaces:
ReactiveRedisCommands
All Known Implementing Classes:
ReactiveJsonCommandsImpl
public interface ReactiveJsonCommands<K> extends ReactiveRedisCommands
Allows executing commands from the json group (requires the Redis stack). See the json command list for further information about these commands.

Redis JSON lets you store, update, and retrieve JSON values in a Redis database, similar to any other Redis data type.

Ths API is based on the JsonObject and JsonArray types. Some methods also allows direct mapping from and to objects. In the case of deserialization, the Class must be passed.

  • Method Details

    • jsonSet

      <T> io.smallrye.mutiny.Uni<Void> jsonSet(K key, String path, T value)
      Execute the command JSON.SET. Summary: Sets the JSON value at path in key. Group: json
      Type Parameters:
      T - the type for the value
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      value - the value, encoded to JSON
      Returns:
      A uni emitting null when the operation completes

    • jsonSet

      io.smallrye.mutiny.Uni<Void> jsonSet(K key, String path, io.vertx.core.json.JsonObject json)
      Execute the command JSON.SET. Summary: Sets the JSON value at path in key. Group: json
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      json - the JSON object to store, must not be null
      Returns:
      A uni emitting null when the operation completes

    • jsonSet

      io.smallrye.mutiny.Uni<Void> jsonSet(K key, String path, io.vertx.core.json.JsonObject json, JsonSetArgs args)
      Execute the command JSON.SET. Summary: Sets the JSON value at path in key. Group: json
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      json - the JSON object to store, must not be null
      args - the extra arguments
      Returns:
      A uni emitting null when the operation completes

    • jsonSet

      io.smallrye.mutiny.Uni<Void> jsonSet(K key, String path, io.vertx.core.json.JsonArray json)
      Execute the command JSON.SET. Summary: Sets the JSON value at path in key. Group: json
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      json - the JSON array to store, must not be null
      Returns:
      A uni emitting null when the operation completes

    • jsonSet

      io.smallrye.mutiny.Uni<Void> jsonSet(K key, String path, io.vertx.core.json.JsonArray json, JsonSetArgs args)
      Execute the command JSON.SET. Summary: Sets the JSON value at path in key. Group: json
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      json - the JSON array to store, must not be null
      args - the extra arguments
      Returns:
      A uni emitting null when the operation completes

    • jsonSet

      <T> io.smallrye.mutiny.Uni<Void> jsonSet(K key, String path, T value, JsonSetArgs args)
      Execute the command JSON.SET. Summary: Sets the JSON value at path in key. Group: json
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      value - the value to store, encoded to JSON.
      args - the extra arguments
      Returns:
      A uni emitting null when the operation completes

    • jsonGet

      <T> io.smallrye.mutiny.Uni<T> jsonGet(K key, Class<T> clazz)
      Execute the command JSON.GET. Summary: Returns the value at path in JSON serialized form. Group: json

      This method uses the root path ($). It map the retrieve JSON document to an object of type <T>.

      Parameters:
      key - the key, must not be null
      clazz - the type of object to recreate from the JSON content
      Returns:
      a uni emitting the object, null if it does not exist

    • jsonGetObject

      io.smallrye.mutiny.Uni<io.vertx.core.json.JsonObject> jsonGetObject(K key)
      Execute the command JSON.GET. Summary: Returns the value at path in JSON serialized form. Group: json

      This method uses the root path ($). Unlike jsonGet(Object, Class), it returns a JsonObject.

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting the stored JSON object, null if it does not exist

    • jsonGetArray

      io.smallrye.mutiny.Uni<io.vertx.core.json.JsonArray> jsonGetArray(K key)
      Execute the command JSON.GET. Summary: Returns the value at path in JSON serialized form. Group: json

      This method uses the root path ($). Unlike jsonGet(Object, Class), it returns a JsonArray.

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting the stored JSON array, null if it does not exist

    • jsonGet

      io.smallrye.mutiny.Uni<io.vertx.core.json.JsonArray> jsonGet(K key, String path)
      Execute the command JSON.GET. Summary: Returns the value at path in JSON serialized form. Group: json

      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      Returns:
      a uni emitting the JSON array containing the different results, null if it does not exist.

    • jsonGet

      io.smallrye.mutiny.Uni<io.vertx.core.json.JsonObject> jsonGet(K key, String... paths)
      Execute the command JSON.GET. Summary: Returns the value at path in JSON serialized form. Group: json

      Parameters:
      key - the key, must not be null
      paths - the paths, must not be null. If no path are passed, this is equivalent to jsonGetObject(Object), if multiple paths are passed, the produced JSON object contains the result (as a json array) for each path.
      Returns:
      a uni emitting the stored JSON object, null if it does not exist. If no path are passed, this is equivalent to jsonGetObject(Object). If multiple paths are passed, the produced JSON object contains the result for each pass as a JSON array.

    • jsonArrAppend

      <T> io.smallrye.mutiny.Uni<List<Integer>> jsonArrAppend(K key, String path, T... values)
      Execute the command JSON.ARRAPPEND. Summary: Append the json values into the array at path after the last element in it. Group: json

      Type Parameters:
      T - the type of value
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      values - the values to append, encoded to JSON
      Returns:
      a uni emitting a list with the new sizes of each modified array (in order) or null (instead of the size) if the point object was not an array.

    • jsonArrIndex

      <T> io.smallrye.mutiny.Uni<List<Integer>> jsonArrIndex(K key, String path, T value, int start, int end)
      Execute the command JSON.ARRINDEX. Summary: Searches for the first occurrence of a scalar JSON value in an array. Group: json

      Type Parameters:
      T - the type of value
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      value - the value to be searched, encoded to JSON
      start - the start index
      end - the end index
      Returns:
      a uni emitting a list with the first position in the array of each JSON value that matches the path, -1 if not found in the array, or null if the matching JSON value is not an array.

    • jsonArrIndex

      default <T> io.smallrye.mutiny.Uni<List<Integer>> jsonArrIndex(K key, String path, T value)
      Execute the command JSON.ARRINDEX. Summary: Searches for the first occurrence of a scalar JSON value in an array. Group: json

      Type Parameters:
      T - the type of value
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      value - the value to be searched, encoded to JSON
      Returns:
      a uni emitting a list with the first position in the array of each JSON value that matches the path, -1 if not found in the array, or null if the matching JSON value is not an array.

    • jsonArrInsert

      <T> io.smallrye.mutiny.Uni<List<Integer>> jsonArrInsert(K key, String path, int index, T... values)
      Execute the command JSON.ARRINSERT. Summary: Inserts the json values into the array at path before the index (shifts to the right). Group: json

      Type Parameters:
      T - the type of value
      Parameters:
      key - the key, must not be null
      path - the path, must not be null
      index - the index. The index must be in the array's range. Inserting at index 0 prepends to the array. Negative index values start from the end of the array.
      values - the values to insert, encoded to JSON
      Returns:
      a uni emitting a list of integer containing for each path, the array's new size or null if the matching JSON value is not an array.

    • jsonArrLen

      io.smallrye.mutiny.Uni<List<Integer>> jsonArrLen(K key, String path)
      Execute the command JSON.ARRLEN. Summary: Reports the length of the JSON Array at path in key. Group: json

      Parameters:
      key - the key, must not be null
      path - the path, null means $
      Returns:
      a uni emitting a list of integer containing for each path, the array's length, or @{code null} if the matching JSON value is not an array.

    • jsonArrLen

      default io.smallrye.mutiny.Uni<Integer> jsonArrLen(K key)
      Execute the command JSON.ARRLEN. Summary: Reports the length of the JSON Array at path in key. Group: json

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting the array's length, or @{code null} if the matching JSON value is not an array.

    • jsonArrPop

      <T> io.smallrye.mutiny.Uni<List<T>> jsonArrPop(K key, Class<T> clazz, String path, int index)
      Execute the command JSON.ARRPOP. Summary: Removes and returns an element from the index in the array. Group: json

      Parameters:
      key - the key, must not be null
      clazz - the type of the popped object
      path - path the path, defaults to root if not provided.
      index - is the position in the array to start popping from (defaults to -1, meaning the last element). Out-of-range indexes round to their respective array ends.
      Returns:
      a uni emitting a list of T including for each path, an instance of T rebuilt from the JSON value, or null if the matching JSON value is not an array. Popping an empty array produces null.

    • jsonArrPop

      default <T> io.smallrye.mutiny.Uni<T> jsonArrPop(K key, Class<T> clazz)
      Execute the command JSON.ARRPOP. Summary: Removes and returns an element from the index in the array. Group: json

      This variant popped from the root object (must be a JSON array), and returns a single item.

      Parameters:
      key - the key, must not be null
      clazz - the type of the popped object
      Returns:
      a uni emitting an instance of T.

    • jsonArrTrim

      io.smallrye.mutiny.Uni<List<Integer>> jsonArrTrim(K key, String path, int start, int stop)
      Execute the command JSON.ARRTRIM. Summary: Trims an array so that it contains only the specified inclusive range of elements. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, must not be null
      start - the start index
      stop - the stop index
      Returns:
      a uni emitting a list of integer containing, for each path, the array's new size, or null if the matching JSON value is not an array.

    • jsonClear

      io.smallrye.mutiny.Uni<Integer> jsonClear(K key, String path)
      Execute the command JSON.CLEAR. Summary: Clears container values (Arrays/Objects), and sets numeric values to 0. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided. Non-existing paths are ignored.
      Returns:
      a uni emitting the number of value cleared

    • jsonClear

      default io.smallrye.mutiny.Uni<Integer> jsonClear(K key)
      Execute the command JSON.CLEAR. Summary: Clears container values (Arrays/Objects), and sets numeric values to 0. Group: json

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting the number of value cleared

    • jsonDel

      io.smallrye.mutiny.Uni<Integer> jsonDel(K key, String path)
      Execute the command JSON.DEL. Summary: Deletes a value. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided. Non-existing paths are ignored.
      Returns:
      a uni emitting the number of path deleted

    • jsonDel

      default io.smallrye.mutiny.Uni<Integer> jsonDel(K key)
      Execute the command JSON.DEL. Summary: Deletes a value. Group: json

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting the number of path deleted (0 or more)

    • jsonMget

      io.smallrye.mutiny.Uni<List<io.vertx.core.json.JsonArray>> jsonMget(String path, K... keys)
      Execute the command JSON.MGET. Summary: Returns the values at path from multiple key arguments. Returns null for nonexistent keys and nonexistent paths. Group: json

      Parameters:
      path - path the path
      keys - the keys, must not be null, must not contain null
      Returns:
      a uni emitting a list of JsonArray containing each retrieved value

    • jsonNumincrby

      io.smallrye.mutiny.Uni<Void> jsonNumincrby(K key, String path, double value)
      Execute the command JSON.NUMINCRBY. Summary: Increments the number value stored at path by number. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided. Non-existing paths are ignored.
      value - the value to add
      Returns:
      a uni emitting null when the operation completes

    • jsonObjKeys

      io.smallrye.mutiny.Uni<List<List<String>>> jsonObjKeys(K key, String path)
      Execute the command JSON.OBJKEYS. Summary: Returns the keys in the object that's referenced by path. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided.
      Returns:
      a uni emitting a list containing, for each matching path, the list of keys, or null if the matching JSON value is not an object.

    • jsonObjKeys

      default io.smallrye.mutiny.Uni<List<String>> jsonObjKeys(K key)
      Execute the command JSON.OBJKEYS. Summary: Returns the keys in the object that's referenced by path. Group: json

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting a list containing the list of keys, or null if the stored value is not a JSON object.

    • jsonObjLen

      io.smallrye.mutiny.Uni<List<Integer>> jsonObjLen(K key, String path)
      Execute the command JSON.OBJLEN. Summary: Reports the number of keys in the JSON Object at path in key. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided.
      Returns:
      a uni emitting a list containing, for each path, the length of the object, null if the matching JSON value is not an object

    • jsonObjLen

      default io.smallrye.mutiny.Uni<Integer> jsonObjLen(K key)
      Execute the command JSON.OBJLEN. Summary: Reports the number of keys in the JSON Object at path in key. Group: json

      Parameters:
      key - the key, must not be null
      Returns:
      a uni emitting the length of the JSON object, null if the matching JSON value is not an object

    • jsonStrAppend

      io.smallrye.mutiny.Uni<List<Integer>> jsonStrAppend(K key, String path, String value)
      Execute the command JSON.STRAPPEND. Summary: Appends the json-string values to the string at path. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided.
      value - the string to append, must not be null
      Returns:
      a uni emitting a list containing, for each path, the new string length, null if the matching JSON value is not a string.

    • jsonStrLen

      io.smallrye.mutiny.Uni<List<Integer>> jsonStrLen(K key, String path)
      Execute the command JSON.STRLEN. Summary: Reports the length of the JSON String at path in key. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided.
      Returns:
      a uni emitting a list containing, for each path, the length of the string, null if the matching JSON value is not a string. Returns null if the key or path do not exist.

    • jsonToggle

      io.smallrye.mutiny.Uni<List<Boolean>> jsonToggle(K key, String path)
      Execute the command JSON.TOGGLE. Summary: Toggle a boolean value stored at path. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, must not be null
      Returns:
      a uni emitting a list containing, for each path, the new boolean value, null if the matching JSON value is not a boolean.

    • jsonType

      io.smallrye.mutiny.Uni<List<String>> jsonType(K key, String path)
      Execute the command JSON.TYPE. Summary: Reports the type of JSON value at path. Group: json

      Parameters:
      key - the key, must not be null
      path - path the path, path defaults to $ if not provided.
      Returns:
      a uni emitting a list containing, for each path, the json type as String (string, integer, number, boolean, object, array), empty if no match.