io.quarkus.redis.datasource.autosuggest.ReactiveAutoSuggestCommands Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of quarkus-redis-client Show documentation
Connect to Redis in either imperative or reactive style
There is a newer version: 3.17.5
package io.quarkus.redis.datasource.autosuggest;

import java.util.List;

import io.quarkus.redis.datasource.ReactiveRedisCommands;
import io.smallrye.common.annotation.Experimental;
import io.smallrye.mutiny.Uni;

/**
 * Allows executing commands from the {@code auto-suggest} group (requires the Redis Search module from Redis stack).
 * See the auto-suggest command list for further information about
 * these commands.
 *
 * @param  the type of the key
 */
@Experimental("The auto-suggest group is experimental")
public interface ReactiveAutoSuggestCommands extends ReactiveRedisCommands {

    /**
     * Execute the command FT.SUGADD.
     * Summary: Add a suggestion string to an auto-complete suggestion dictionary
     * Group: auto-suggest
     *
     * @param key the suggestion dictionary key
     * @param string the suggestion string to index
     * @param score the floating point number of the suggestion string's weight
     * @return A uni emitting the current size of the suggestion dictionary.
     **/
    default Uni ftSugAdd(K key, String string, double score) {
        return ftSugAdd(key, string, score, false);
    }

    /**
     * Execute the command FT.SUGADD.
     * Summary: Add a suggestion string to an auto-complete suggestion dictionary
     * Group: auto-suggest
     *
     * @param key the suggestion dictionary key
     * @param string the suggestion string to index
     * @param score the floating point number of the suggestion string's weight
     * @param increment increments the existing entry of the suggestion by the given score, instead of replacing the score.
     *        This is useful for updating the dictionary based on user queries in real time.
     * @return A uni emitting the current size of the suggestion dictionary.
     **/
    Uni ftSugAdd(K key, String string, double score, boolean increment);

    /**
     * Execute the command FT.SUGDEL.
     * Summary: Delete a string from a suggestion index
     * Group: auto-suggest
     *
     * @param key the suggestion dictionary key
     * @param string the suggestion string to index
     * @return A uni emitting {@code true} if the value was found, {@code false} otherwise
     **/
    Uni ftSugDel(K key, String string);

    /**
     * Execute the command FT.SUGGET.
     * Summary: Get completion suggestions for a prefix
     * Group: auto-suggest
     *
     * @param key the suggestion dictionary key
     * @param prefix is prefix to complete on.
     * @return A uni emitting a list of the top suggestions matching the prefix, optionally with score after each entry.
     **/
    Uni> ftSugGet(K key, String prefix);

    /**
     * Execute the command FT.SUGGET.
     * Summary: Get completion suggestions for a prefix
     * Group: auto-suggest
     *
     * @param key the suggestion dictionary key
     * @param prefix is prefix to complete on.
     * @param args the extra argument, must not be {@code null}
     * @return A uni emitting {@code true} if the value was found, {@code false} otherwise
     **/
    Uni> ftSugGet(K key, String prefix, GetArgs args);

    /**
     * Execute the command FT.SUGLEN.
     * Summary: Get the size of an auto-complete suggestion dictionary
     * Group: auto-suggest
     *
     * @param key the suggestion dictionary key
     * @return A uni emitting the current size of the suggestion dictionary.
     **/
    Uni ftSugLen(K key);

}