com.ibm.watson.discovery.v2.model

Class QueryOptions

java.lang.Object

com.ibm.cloud.sdk.core.service.model.GenericModel

com.ibm.watson.discovery.v2.model.QueryOptions

All Implemented Interfaces:

com.ibm.cloud.sdk.core.service.model.ObjectModel

public class QueryOptions
extends com.ibm.cloud.sdk.core.service.model.GenericModel

The query options.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	QueryOptions.Builder Builder.

Method Summary

Modifier and Type	Method and Description
String	aggregation() Gets the aggregation.
List<String>	collectionIds() Gets the collectionIds.
Long	count() Gets the count.
String	filter() Gets the filter.
Boolean	highlight() Gets the highlight.
String	naturalLanguageQuery() Gets the naturalLanguageQuery.
QueryOptions.Builder	newBuilder() New builder.
Long	offset() Gets the offset.
QueryLargePassages	passages() Gets the passages.
String	projectId() Gets the projectId.
String	query() Gets the query.
String	sort() Gets the sort.
Boolean	spellingSuggestions() Gets the spellingSuggestions.
QueryLargeSuggestedRefinements	suggestedRefinements() Gets the suggestedRefinements.
QueryLargeTableResults	tableResults() Gets the tableResults.
List<String>	xReturn() Gets the xReturn.

Methods inherited from class com.ibm.cloud.sdk.core.service.model.GenericModel

equals, hashCode, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

newBuilder

public QueryOptions.Builder newBuilder()

New builder.

Returns:

a QueryOptions builder

projectId

public String projectId()

Gets the projectId.

The ID of the project. This information can be found from the *Integrate and Deploy* page in Discovery.

Returns:

the projectId

collectionIds

public List<String> collectionIds()

Gets the collectionIds.

A comma-separated list of collection IDs to be queried against.

Returns:

the collectionIds

filter

public String filter()

Gets the filter.

A cacheable query that excludes documents that don't mention the query content. Filter searches are better for metadata-type searches and for assessing the concepts in the data set.

Returns:

the filter

query

public String query()

Gets the query.

A query search returns all documents in your data set with full enrichments and full text, but with the most relevant documents listed first. Use a query search when you want to find the most relevant search results.

Returns:

the query

naturalLanguageQuery

public String naturalLanguageQuery()

Gets the naturalLanguageQuery.

A natural language query that returns relevant documents by utilizing training data and natural language understanding.

Returns:

the naturalLanguageQuery

aggregation

public String aggregation()

Gets the aggregation.

An aggregation search that returns an exact answer by combining query search with filters. Useful for applications to build lists, tables, and time series. For a full list of possible aggregations, see the Query reference.

Returns:

the aggregation

count

public Long count()

Gets the count.

Number of results to return.

Returns:

the count

xReturn

public List<String> xReturn()

Gets the xReturn.

A list of the fields in the document hierarchy to return. If this parameter is an empty list, then all fields are returned.

Returns:

the xReturn

offset

public Long offset()

Gets the offset.

The number of query results to skip at the beginning. For example, if the total number of results that are returned is 10 and the offset is 8, it returns the last two results.

Returns:

the offset

sort

public String sort()

Gets the sort.

A comma-separated list of fields in the document to sort on. You can optionally specify a sort direction by prefixing the field with `-` for descending or `+` for ascending. Ascending is the default sort direction if no prefix is specified.

Returns:

the sort

highlight

public Boolean highlight()

Gets the highlight.

When `true`, a highlight field is returned for each result which contains the fields which match the query with `<em></em>` tags around the matching query terms.

Returns:

the highlight

spellingSuggestions

public Boolean spellingSuggestions()

Gets the spellingSuggestions.

When `true` and the **natural_language_query** parameter is used, the **natural_language_query** parameter is spell checked. The most likely correction is returned in the **suggested_query** field of the response (if one exists).

Returns:

the spellingSuggestions

tableResults

public QueryLargeTableResults tableResults()

Gets the tableResults.

Configuration for table retrieval.

Returns:

the tableResults

suggestedRefinements

public QueryLargeSuggestedRefinements suggestedRefinements()

Gets the suggestedRefinements.

Configuration for suggested refinements. Available with Premium plans only.

Returns:

the suggestedRefinements

passages

public QueryLargePassages passages()

Gets the passages.

Configuration for passage retrieval.

Returns:

the passages