UI libraries / InstantSearch Android / Widgets

Searcher

A

About this widget # A

The component handling search requests. Objects implementing the Searcher interface manage the search sessions.

Algolia provides you with several out of the box searchers to help build your InstantSearch experience:

  • HitsSearcher: Searches a single index.
  • FacetSearcher: Searches for facet values.
  • MultiSearcher: Searches in multiple indices. This is useful for a federated search, or query suggestions search experience.
  • SearcherAnswers: Searches an index for Answers.
See code examples

Examples # A

Instantiating a HitsSearcher:

Copy 
1
2
3
4
5

val searcher = HitsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name")
)

Instantiating a FacetSearcher:

Copy 
1
2
3
4
5
6

val searcher = FacetsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    attribute = Attribute("color")
)

Instantiating a MultiSearcher:

Copy 
1
2
3
4
5
6
7
8
9

val multiSearcher = MultiSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
)
val hitsSearcher = multiSearcher.addHitsSearcher(indexName = IndexName("index_name1"))
val facetsSearcher = multiSearcher.addFacetsSearcher(
    indexName = IndexName("index_name1"),
    attribute = Attribute("facet_name")
)

Instantiate a SearcherAnswers

Copy 
1
2
3
4
5

val client = ClientSearch(ApplicationID("AJ0P3S7DWQ"),
                          APIKey("YourSearchOnlyApiKey"))
val searcher = SearcherAnswers(
    index = client.initIndex(IndexName("index_name"))
)

HitsSearcher # A

Parameter Description
indexName #
type: IndexName
Required

The index to search into.
Copy 
1
2
3
4
5
6

val indexName = IndexName("index_name")
val searcher = HitsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = indexName
)
query #
type: Query
default: Query()
Optional

A query used to perform the search.
Copy 
1
2
3
4
5
6
7

val query = Query(analytics = false)
val searcher = HitsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    query = query
)
isAutoSendingHitsViewEvents #
type: Boolean
default: true
Optional

Flag defining whether the automatic hits view Insights events sending is enabled.
Copy 
1
2
3
4
5
6

val searcher = HitsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    isAutoSendingHitsViewEvents = false,
)
userToken #
type: UserToken
Optional

User token assigned to automatically sent Insights events in the HitsSearcher component. If not explicitly set during initialization, the HitsSearcher generates and assigns a default user token.
requestOptions #
type: RequestOptions
default: RequestOptions()
Optional

RequestOptions that apply to the search.
Copy 
1
2
3
4
5
6
7
8
9

val requestOptions = RequestOptions().also {
    it.headers[KeyForwardedFor] = "1.2.3.4"
}
val searcher = HitsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    requestOptions = requestOptions
)

FacetSearcher # A

Parameter Description
indexName #
type: IndexName
Required

The index to search into.
Copy 
1
2
3
4
5
6
7

val indexName = IndexName("index_name")
val searcher = FacetsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = indexName,
    attribute = Attribute("color")
)
attribute #
type: Attribute
Required

An attribute to search facet values for.
Copy 
1
2
3
4
5
6
7

val attribute = Attribute("color")
val searcher = FacetsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    attribute = attribute
)
query #
type: Query
default: Query()
Optional

A query used to perform the search.
Copy 
1
2
3
4
5
6
7
8

val query = Query(analytics = true)
val searcher = FacetsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    attribute = Attribute("color"),
    query = query
)
requestOptions #
type: RequestOptions
default: RequestOptions()
Optional

RequestOptions that apply to the search.
Copy 
1
2
3
4
5
6
7
8
9
10

val requestOptions = RequestOptions().also {
    it.headers[KeyForwardedFor] = "1.2.3.4"
}
val searcher = FacetsSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    indexName = IndexName("index_name"),
    attribute = Attribute("facet_name"),
    requestOptions = requestOptions
)

MultiSearcher # A

Parameter Description
strategy #
type: MultipleQueriesStrategy
default: None
Optional

The strategy of the query.

Can be one of the following values:

  • None: Execute the sequence of queries until the end. This is recommended when each query is of equal importance, meaning all records of all queries need to be returned.
  • StopIfEnoughMatches: Execute queries one by one, but stop as soon as the cumulated number of hits is at least hitsPerPage. This is recommended when each query is an alternative, and where, if the first returns enough records, there is no need to perform the remaining queries.
Copy 
1
2
3
4
5

val multiSearcher = MultiSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    strategy = MultipleQueriesStrategy.None
)
requestOptions #
type: RequestOptions
default: RequestOptions()
Optional

RequestOptions that apply to the search.
Copy 
1
2
3
4
5
6
7
8

val requestOptions = RequestOptions().also {
    it.headers[KeyForwardedFor] = "1.2.3.4"
}
val multiSearcher = MultiSearcher(
    applicationID = ApplicationID("AJ0P3S7DWQ"),
    apiKey = APIKey("YourSearchOnlyApiKey"),
    requestOptions = requestOptions
)

SearcherAnswers # A

Parameter Description
index #
type: Index
Required

The index to search into for Answers.
Copy 
1
2
3
4
5

val client = ClientSearch(ApplicationID("AJ0P3S7DWQ"),
                          APIKey("YourSearchOnlyApiKey"))
val searcher = SearcherAnswers(
    index = client.initIndex(IndexName("index_name"))
)
query #
type: AnswersQuery
Optional

The query used when performing an Answers search.
Copy 
1
2
3
4
5
6
7
8
9
10
11
12

val client = ClientSearch(ApplicationID("AJ0P3S7DWQ"),
    APIKey("YourSearchOnlyApiKey"))
val query = AnswersQuery(
    query = "when do babies start learning?",
    queryLanguages = listOf(Language.English),
    nbHits = 20,
    attributesForPrediction = listOf(Attribute("description"), Attribute("title"), Attribute("transcript"))
)
val searcher = SearcherAnswers(
    index = client.initIndex(IndexName("index_name")),
    query = query
)

Methods # A

Parameter Description
search #

Triggers the search and returns a search response.
Copy 
1

searcher.search()
searchAsync #

Triggers the search. Notifies all listeners of the results.
Copy 
1

searcher.searchAsync()
cancel #

Cancels the ongoing search requests.
Copy 
1

searcher.cancel()
setQuery #

Sets the query to the string provided.
Copy 
1

searcher.setQuery("foo")

Events # A

Parameter Description
onLoadingChanged #

Triggered when the status of the search request is changed.
Copy 
1
2
3

searcher.onLoadingChanged += { loading ->
    print(if (loading) "Currently loading search response" else "Done loading")
}
onResponseChanged #

Triggered when a new response has arrived.
Copy 
1
2
3
4

searcher.onResponseChanged += { response ->
    val hits = response.hits.deserialize(MovieHit.serializer())
    // Do something with hits...
}
onErrorChanged #

Triggered when an error was encountered during a search request.
Copy 
1
2
3

searcher.onErrorChanged += {
   errorTextView.text = it.localizedMessage
}
Did you find this page helpful?
InstantSearch Android v3