Interface SearchService (2.0.0)

public interface SearchService

The SearchService is used to get available indexes, which can be queried about their metadata or have index/delete/search operations performed on them. For example:


 SearchService searchService = SearchServiceFactory.getSearchService();
 GetResponse<Index> response = searchService.getIndexes(
     GetIndexesRequest.newBuilder());
 for (Index index : response) {
   index.getName();
   index.getNamespace();
   index.search("query");
 }
 

SearchService is also responsible for creating new indexes. For example:


 SearchService searchService = SearchServiceFactory.getSearchService();
 Index index = searchService.getIndex(IndexSpec.newBuilder().setName("myindex"));
 

Methods

getIndex(IndexSpec spec)

public abstract Index getIndex(IndexSpec spec)

Returns an instance of Index corresponding to the provided specification.

Parameter
Name Description
spec IndexSpec
Returns
Type Description
Index

an instance of Index corresponding to the given spec

getIndex(IndexSpec.Builder builder)

public abstract Index getIndex(IndexSpec.Builder builder)

Returns an instance of Index corresponding to the specification built from the given builder.

Parameter
Name Description
builder IndexSpec.Builder
Returns
Type Description
Index

an instance of Index corresponding to the given spec

getIndexes(GetIndexesRequest request)

public abstract GetResponse<Index> getIndexes(GetIndexesRequest request)

Gets the indexes specified. The following code fragment shows how to get the schemas of each available Index.


   // Get the SearchService for the default namespace
   SearchService searchService = SearchServiceFactory.newSearchService();

   // Get the first page of indexes available and retrieve schemas
   GetResponse<Index> response = searchService.getIndexes(
       GetIndexesRequest.newBuilder().setSchemaFetched(true).build());

   // List out elements of Schema
   for (Index index : response) {
     String name = index.getName();
     Schema schema = index.getSchema();
     for (String fieldName : schema.getFieldNames()) {
        List<FieldType> typesForField = schema.getFieldTypes(fieldName);
     }
   }
 
Parameter
Name Description
request GetIndexesRequest

a request specifying which indexes to get

Returns
Type Description
GetResponse<Index>

a GetResponse<Index> containing a list of existing indexes

getIndexes(GetIndexesRequest.Builder builder)

public abstract GetResponse<Index> getIndexes(GetIndexesRequest.Builder builder)

Gets the indexes specified in the request built from the builder.

Parameter
Name Description
builder GetIndexesRequest.Builder

a builder to be used to construct a GetIndexesRequest specifying which indexes to get

Returns
Type Description
GetResponse<Index>

a GetResponse<Index> containing a list of existing indexes

getIndexesAsync(GetIndexesRequest request)

public abstract Future<GetResponse<Index>> getIndexesAsync(GetIndexesRequest request)

Gets the indexes requested asynchronously.

Parameter
Name Description
request GetIndexesRequest

a request specifying which indexes to get

Returns
Type Description
Future<GetResponse<Index>>

a Future that will allow getting a GetResponse<Index> containing a list of existing indexes

getIndexesAsync(GetIndexesRequest.Builder builder)

public abstract Future<GetResponse<Index>> getIndexesAsync(GetIndexesRequest.Builder builder)

Gets the indexes asynchronously for those specified in the request built from the builder.

Parameter
Name Description
builder GetIndexesRequest.Builder

a builder to be used to construct a GetIndexesRequest specifying which indexes to get

Returns
Type Description
Future<GetResponse<Index>>

a Future that will allow getting a GetResponse<Index> containing a list of existing indexes

getNamespace()

public abstract String getNamespace()

Returns the namespace associated with this search service. Each service instance is assigned one namespace and all operations, such as listing documents, indexes inherit it. Also, when you get an index, the namespace of this service is passed to the returned index.

Returns
Type Description
String

the namespace associated with this search service.