QueryOptions (ibm-watson 7.0.0 API)

java.lang.Object
- com.ibm.cloud.sdk.core.service.model.GenericModel
- - com.ibm.watson.discovery.v1.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.

Nested Classes
Modifier and Type	Class and Description
`static class`	`QueryOptions.Builder` Builder.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.String`	`aggregation()` Gets the aggregation.
`java.lang.String`	`bias()` Gets the bias.
`java.lang.String`	`collectionId()` Gets the collectionId.
`java.lang.String`	`collectionIds()` Gets the collectionIds.
`java.lang.Long`	`count()` Gets the count.
`java.lang.Boolean`	`deduplicate()` Gets the deduplicate.
`java.lang.String`	`deduplicateField()` Gets the deduplicateField.
`java.lang.String`	`environmentId()` Gets the environmentId.
`java.lang.String`	`filter()` Gets the filter.
`java.lang.Boolean`	`highlight()` Gets the highlight.
`java.lang.Boolean`	`loggingOptOut()` Gets the loggingOptOut.
`java.lang.String`	`naturalLanguageQuery()` Gets the naturalLanguageQuery.
`QueryOptions.Builder`	`newBuilder()` New builder.
`java.lang.Long`	`offset()` Gets the offset.
`java.lang.Boolean`	`passages()` Gets the passages.
`java.lang.Long`	`passagesCharacters()` Gets the passagesCharacters.
`java.lang.Long`	`passagesCount()` Gets the passagesCount.
`java.lang.String`	`passagesFields()` Gets the passagesFields.
`java.lang.String`	`query()` Gets the query.
`java.lang.String`	`returnFields()` Gets the returnFields.
`java.lang.Boolean`	`similar()` Gets the similar.
`java.lang.String`	`similarDocumentIds()` Gets the similarDocumentIds.
`java.lang.String`	`similarFields()` Gets the similarFields.
`java.lang.String`	`sort()` Gets the sort.

Methods inherited from class com.ibm.cloud.sdk.core.service.model.GenericModel
equals, hashCode, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - newBuilder
```
public QueryOptions.Builder newBuilder()
```
    New builder.
    
    Returns:
    
    a QueryOptions builder
  - environmentId
```
public java.lang.String environmentId()
```
    Gets the environmentId. The ID of the environment.
    
    Returns:
    
    the environmentId
  - collectionId
```
public java.lang.String collectionId()
```
    Gets the collectionId. The ID of the collection.
    
    Returns:
    
    the collectionId
  - filter
```
public java.lang.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 java.lang.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. You cannot use **natural_language_query** and **query** at the same time.
    
    Returns:
    
    the query
  - naturalLanguageQuery
```
public java.lang.String naturalLanguageQuery()
```
    Gets the naturalLanguageQuery. A natural language query that returns relevant documents by utilizing training data and natural language understanding. You cannot use **natural_language_query** and **query** at the same time.
    
    Returns:
    
    the naturalLanguageQuery
  - passages
```
public java.lang.Boolean passages()
```
    Gets the passages. A passages query that returns the most relevant passages from the results.
    
    Returns:
    
    the passages
  - aggregation
```
public java.lang.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 java.lang.Long count()
```
    Gets the count. Number of results to return.
    
    Returns:
    
    the count
  - returnFields
```
public java.lang.String returnFields()
```
    Gets the returnFields. A comma-separated list of the portion of the document hierarchy to return.
    
    Returns:
    
    the returnFields
  - offset
```
public java.lang.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 java.lang.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. This parameter cannot be used in the same query as the **bias** parameter.
    
    Returns:
    
    the sort
  - highlight
```
public java.lang.Boolean highlight()
```
    Gets the highlight. When true, a highlight field is returned for each result which contains the fields which match the query with `` tags around the matching query terms.
    
    Returns:
    
    the highlight
  - passagesFields
```
public java.lang.String passagesFields()
```
    Gets the passagesFields. A comma-separated list of fields that passages are drawn from. If this parameter not specified, then all top-level fields are included.
    
    Returns:
    
    the passagesFields
  - passagesCount
```
public java.lang.Long passagesCount()
```
    Gets the passagesCount. The maximum number of passages to return. The search returns fewer passages if the requested total is not found. The default is `10`. The maximum is `100`.
    
    Returns:
    
    the passagesCount
  - passagesCharacters
```
public java.lang.Long passagesCharacters()
```
    Gets the passagesCharacters. The approximate number of characters that any one passage will have.
    
    Returns:
    
    the passagesCharacters
  - deduplicate
```
public java.lang.Boolean deduplicate()
```
    Gets the deduplicate. When `true`, and used with a Watson Discovery News collection, duplicate results (based on the contents of the **title** field) are removed. Duplicate comparison is limited to the current query only; **offset** is not considered. This parameter is currently Beta functionality.
    
    Returns:
    
    the deduplicate
  - deduplicateField
```
public java.lang.String deduplicateField()
```
    Gets the deduplicateField. When specified, duplicate results based on the field specified are removed from the returned results. Duplicate comparison is limited to the current query only, **offset** is not considered. This parameter is currently Beta functionality.
    
    Returns:
    
    the deduplicateField
  - collectionIds
```
public java.lang.String collectionIds()
```
    Gets the collectionIds. A comma-separated list of collection IDs to be queried against. Required when querying multiple collections, invalid when performing a single collection query.
    
    Returns:
    
    the collectionIds
  - similar
```
public java.lang.Boolean similar()
```
    Gets the similar. When `true`, results are returned based on their similarity to the document IDs specified in the **similar.document_ids** parameter.
    
    Returns:
    
    the similar
  - similarDocumentIds
```
public java.lang.String similarDocumentIds()
```
    Gets the similarDocumentIds. A comma-separated list of document IDs to find similar documents. **Tip:** Include the **natural_language_query** parameter to expand the scope of the document similarity search with the natural language query. Other query parameters, such as **filter** and **query**, are subsequently applied and reduce the scope.
    
    Returns:
    
    the similarDocumentIds
  - similarFields
```
public java.lang.String similarFields()
```
    Gets the similarFields. A comma-separated list of field names that are used as a basis for comparison to identify similar documents. If not specified, the entire document is used for comparison.
    
    Returns:
    
    the similarFields
  - bias
```
public java.lang.String bias()
```
    Gets the bias. Field which the returned results will be biased against. The specified field must be either a **date** or **number** format. When a **date** type field is specified returned results are biased towards field values closer to the current date. When a **number** type field is specified, returned results are biased towards higher field values. This parameter cannot be used in the same query as the **sort** parameter.
    
    Returns:
    
    the bias
  - loggingOptOut
```
public java.lang.Boolean loggingOptOut()
```
    Gets the loggingOptOut. If `true`, queries are not stored in the Discovery **Logs** endpoint.
    
    Returns:
    
    the loggingOptOut

Class QueryOptions

Nested Class Summary

Method Summary

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

Methods inherited from class java.lang.Object

Method Detail

newBuilder

environmentId

collectionId

filter

query

naturalLanguageQuery

passages

aggregation

count

returnFields

offset

sort

highlight

passagesFields

passagesCount

passagesCharacters

deduplicate

deduplicateField

collectionIds

similar

similarDocumentIds

similarFields

bias

loggingOptOut