Add Redis Search API surface (FT.CREATE, FT.DROPINDEX, FT.SEARCH)

Signed-off-by: viktoriya.kutsarova <viktoriya.kutsarova@redis.com>

Author: viktoriya-kutsarova

src/main/java/org/springframework/data/redis/connection/RedisSearchCommands.java

@@ -0,0 +1,108 @@
+/*
+ * Copyright 2026-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.redis.connection;
+
+import org.jspecify.annotations.NullUnmarked;
+
+import org.springframework.data.redis.search.DropIndexOptions;
+import org.springframework.data.redis.search.IndexDefinition;
+import org.springframework.data.redis.search.Schema;
+import org.springframework.data.redis.search.SearchOptions;
+import org.springframework.data.redis.search.SearchQuery;
+import org.springframework.data.redis.search.SearchResult;
+
+/**
+ * Redis Search commands ({@code FT.*}) operating on a single connection.
+ * <p>
+ * These commands are not available in pipeline or transaction mode and will throw an exception if invoked in that context.
+ *
+ * @author Viktoriya Kutsarova
+ * @see <a href="https://redis.io/docs/latest/develop/interact/search-and-query/">Redis Search</a>
+ */
+@NullUnmarked
+public interface RedisSearchCommands {
+
+	/**
+	 * Create a new Redis Search index with default options.
+	 *
+	 * @param name index name; must not be {@literal null}.
+	 * @param schema field definitions for the index; must not be {@literal null}.
+	 * @return {@code "OK"} on success.
+	 * @see <a href="https://redis.io/commands/ft.create/">FT.CREATE</a>
+	 */
+	default String createIndex(String name, Schema schema) {
+		return createIndex(name, schema, IndexDefinition.create());
+	}
+
+	/**
+	 * Create a new Redis Search index with the given definition.
+	 *
+	 * @param name index name; must not be {@literal null}.
+	 * @param schema field definitions for the index; must not be {@literal null}.
+	 * @param definition index-level options (data type, prefixes, language, etc.); must not be {@literal null}.
+	 * @return {@code "OK"} on success.
+	 * @see <a href="https://redis.io/commands/ft.create/">FT.CREATE</a>
+	 */
+	String createIndex(String name, Schema schema, IndexDefinition definition);
+
+	/**
+	 * Drop an existing index without deleting the underlying documents.
+	 *
+	 * @param name index name; must not be {@literal null}.
+	 * @see <a href="https://redis.io/commands/ft.dropindex/">FT.DROPINDEX</a>
+	 */
+	default void dropIndex(String name) {
+		dropIndex(name, DropIndexOptions.create());
+	}
+
+	/**
+	 * Drop an existing index with the given options.
+	 *
+	 * @param name index name; must not be {@literal null}.
+	 * @param options drop options; must not be {@literal null}.
+	 * @see DropIndexOptions#deleteDocuments()
+	 * @see <a href="https://redis.io/commands/ft.dropindex/">FT.DROPINDEX</a>
+	 */
+	void dropIndex(String name, DropIndexOptions options);
+
+	/**
+	 * Execute a full-text / field-range search against an index using default options.
+	 *
+	 * @param index index name; must not be {@literal null}.
+	 * @param query search query; must not be {@literal null}.
+	 * @return the search result; never {@literal null}.
+	 * @see SearchQuery#of(String)
+	 * @see SearchQuery#all()
+	 * @see <a href="https://redis.io/commands/ft.search/">FT.SEARCH</a>
+	 */
+	default SearchResult search(String index, SearchQuery query) {
+		return search(index, query, SearchOptions.create());
+	}
+
+	/**
+	 * Execute a full-text / field-range search against an index with the given options.
+	 *
+	 * @param index index name; must not be {@literal null}.
+	 * @param query search query; must not be {@literal null}.
+	 * @param options search options (LIMIT, SORTBY, RETURN, etc.); must not be {@literal null}.
+	 * @return the search result; never {@literal null}.
+	 * @see SearchQuery#of(String)
+	 * @see SearchQuery#all()
+	 * @see <a href="https://redis.io/commands/ft.search/">FT.SEARCH</a>
+	 */
+	SearchResult search(String index, SearchQuery query, SearchOptions options);
+}
+

src/main/java/org/springframework/data/redis/search/DropIndexOptions.java

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2026-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.redis.search;
+
+/**
+ * Options for the Redis Search {@code FT.DROPINDEX} command.
+ * <p>
+ * Use the fluent factory method {@link #create()} to build an instance:
+ * <pre class="code">
+ * // Drop index only, keep documents
+ * DropIndexOptions.create()
+ *
+ * // Drop index and delete all indexed documents
+ * DropIndexOptions.create().deleteDocuments()
+ * </pre>
+ *
+ * @author Viktoriya Kutsarova
+ * @see org.springframework.data.redis.connection.RedisSearchCommands#dropIndex(String, DropIndexOptions)
+ * @see <a href="https://redis.io/commands/ft.dropindex/">FT.DROPINDEX</a>
+ */
+public class DropIndexOptions {
+
+	private boolean deleteDocuments;
+
+	private DropIndexOptions() {}
+
+	/**
+	 * Create a new {@link DropIndexOptions} instance.
+	 */
+	public static DropIndexOptions create() {
+		return new DropIndexOptions();
+	}
+
+	/**
+	 * Delete all documents indexed by this index ({@code DD} flag).
+	 * <p>
+	 * When set, all documents that were indexed by this index will be deleted
+	 * along with the index itself. Use with caution as this operation is irreversible.
+	 */
+	public DropIndexOptions deleteDocuments() {
+		this.deleteDocuments = true;
+		return this;
+	}
+
+	/**
+	 * Return whether indexed documents should be deleted along with the index.
+	 */
+	public boolean isDeleteDocuments() {
+		return deleteDocuments;
+	}
+}
+

src/main/java/org/springframework/data/redis/search/GeoField.java

@@ -0,0 +1,62 @@
+/*
+ * Copyright 2026-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.redis.search;
+
+/**
+ * A geographic {@link SchemaField} for radius-based queries on longitude/latitude pairs
+ * stored as comma-separated strings.
+ * <p>
+ * Create instances via {@link SchemaField#geo(String)}.
+ *
+ * @author Viktoriya Kutsarova
+ * @see SchemaField#geo(String)
+ * @see <a href="https://redis.io/commands/ft.create/">FT.CREATE — GEO field options</a>
+ */
+public final class GeoField extends SchemaField {
+
+	private boolean sortable;
+	private boolean unnormalized;
+
+	GeoField(String name) {
+		super(name);
+	}
+
+	/**
+	 * Enable low-latency sorting on this field ({@code SORTABLE}).
+	 */
+	public GeoField sortable() {
+		this.sortable = true;
+		return this;
+	}
+
+	/**
+	 * Enable sortable without normalization ({@code SORTABLE UNF}).
+	 * Preserves the original case and diacritics for sorting.
+	 */
+	public GeoField sortableUnnormalized() {
+		this.sortable = true;
+		this.unnormalized = true;
+		return this;
+	}
+
+	public boolean isSortable() {
+		return sortable;
+	}
+
+	public boolean isUnnormalized() {
+		return unnormalized;
+	}
+}

src/main/java/org/springframework/data/redis/search/IndexDataType.java

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2026-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.redis.search;
+
+/**
+ * The Redis data structure type that an index operates on.
+ *
+ * @author Viktoriya Kutsarova
+ */
+public enum IndexDataType {
+
+	/**
+	 * Index Redis Hash documents.
+	 */
+	HASH,
+
+	/**
+	 * Index Redis JSON documents (requires RedisJSON module).
+	 */
+	JSON
+}