com.amazonaws.services.kendra.model.QueryRequest Maven / Gradle / Ivy
Show all versions of aws-java-sdk-kendra Show documentation
/*
* Copyright 2019-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file 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 com.amazonaws.services.kendra.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.AmazonWebServiceRequest;
/**
*
* @see AWS API Documentation
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class QueryRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable {
/**
*
* The identifier of the index for the search.
*
*/
private String indexId;
/**
*
* The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex queries. For
* example, Timeoff AND October AND Category:HR is counted as 3 tokens: timeoff,
* october, hr. For more information, see Searching
* with advanced query syntax in the Amazon Kendra Developer Guide.
*
*/
private String queryText;
/**
*
* Filters search results by document fields/attributes. You can only provide one attribute filter; however, the
* AndAllFilters, NotFilter, and OrAllFilters parameters contain a list of
* other filters.
*
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document must
* satisfy to be included in the query results.
*
*/
private AttributeFilter attributeFilter;
/**
*
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field key
* specified. This helps your users narrow their search.
*
*/
private java.util.List facets;
/**
*
* An array of document fields/attributes to include in the response. You can limit the response to include certain
* document fields. By default, all document attributes are included in the response.
*
*/
private java.util.List requestedDocumentAttributes;
/**
*
* Sets the type of query result or response. Only results for the specified type are returned.
*
*/
private String queryResultTypeFilter;
/**
*
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
*
* If you use this API to override the relevance tuning configured at the index level, but there is no relevance
* tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override only some
* of these fields, then for the fields you did not override, the importance is set to 1.
*
*/
private java.util.List documentRelevanceOverrideConfigurations;
/**
*
* Query results are returned in pages the size of the PageSize parameter. By default, Amazon Kendra
* returns the first page of results. Use this parameter to get result pages after the first one.
*
*/
private Integer pageNumber;
/**
*
* Sets the number of results that are returned in each page of results. The default page size is 10. The maximum
* number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
*
*/
private Integer pageSize;
/**
*
* Provides information that determines how the results of the query are sorted. You can set the field that Amazon
* Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending
* order. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra determines
* for the result.
*
*/
private SortingConfiguration sortingConfiguration;
/**
*
* Provides configuration information to determine how the results of a query are sorted.
*
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results should
* be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by relevance.
*
*/
private java.util.List sortingConfigurations;
/**
*
* The user context token or user and group information.
*
*/
private UserContext userContext;
/**
*
* Provides an identifier for a specific user. The VisitorId should be a unique identifier, such as a
* GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
*
*/
private String visitorId;
/**
*
* Enables suggested spell corrections for queries.
*
*/
private SpellCorrectionConfiguration spellCorrectionConfiguration;
/**
*
* Provides configuration to determine how to group results by document attribute value, and how to display them
* (collapsed or expanded) under a designated primary document for each group.
*
*/
private CollapseConfiguration collapseConfiguration;
/**
*
* The identifier of the index for the search.
*
*
* @param indexId
* The identifier of the index for the search.
*/
public void setIndexId(String indexId) {
this.indexId = indexId;
}
/**
*
* The identifier of the index for the search.
*
*
* @return The identifier of the index for the search.
*/
public String getIndexId() {
return this.indexId;
}
/**
*
* The identifier of the index for the search.
*
*
* @param indexId
* The identifier of the index for the search.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withIndexId(String indexId) {
setIndexId(indexId);
return this;
}
/**
*
* The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex queries. For
* example, Timeoff AND October AND Category:HR is counted as 3 tokens: timeoff,
* october, hr. For more information, see Searching
* with advanced query syntax in the Amazon Kendra Developer Guide.
*
*
* @param queryText
* The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex queries.
* For example, Timeoff AND October AND Category:HR is counted as 3 tokens: timeoff
* , october, hr. For more information, see Searching with advanced query syntax in the Amazon Kendra Developer Guide.
*/
public void setQueryText(String queryText) {
this.queryText = queryText;
}
/**
*
* The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex queries. For
* example, Timeoff AND October AND Category:HR is counted as 3 tokens: timeoff,
* october, hr. For more information, see Searching
* with advanced query syntax in the Amazon Kendra Developer Guide.
*
*
* @return The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex
* queries. For example, Timeoff AND October AND Category:HR is counted as 3 tokens:
* timeoff, october, hr. For more information, see Searching with advanced query syntax in the Amazon Kendra Developer Guide.
*/
public String getQueryText() {
return this.queryText;
}
/**
*
* The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex queries. For
* example, Timeoff AND October AND Category:HR is counted as 3 tokens: timeoff,
* october, hr. For more information, see Searching
* with advanced query syntax in the Amazon Kendra Developer Guide.
*
*
* @param queryText
* The input query text for the search. Amazon Kendra truncates queries at 30 token words, which excludes
* punctuation and stop words. Truncation still applies if you use Boolean or more advanced, complex queries.
* For example, Timeoff AND October AND Category:HR is counted as 3 tokens: timeoff
* , october, hr. For more information, see Searching with advanced query syntax in the Amazon Kendra Developer Guide.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withQueryText(String queryText) {
setQueryText(queryText);
return this;
}
/**
*
* Filters search results by document fields/attributes. You can only provide one attribute filter; however, the
* AndAllFilters, NotFilter, and OrAllFilters parameters contain a list of
* other filters.
*
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document must
* satisfy to be included in the query results.
*
*
* @param attributeFilter
* Filters search results by document fields/attributes. You can only provide one attribute filter; however,
* the AndAllFilters, NotFilter, and OrAllFilters parameters contain a
* list of other filters.
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document
* must satisfy to be included in the query results.
*/
public void setAttributeFilter(AttributeFilter attributeFilter) {
this.attributeFilter = attributeFilter;
}
/**
*
* Filters search results by document fields/attributes. You can only provide one attribute filter; however, the
* AndAllFilters, NotFilter, and OrAllFilters parameters contain a list of
* other filters.
*
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document must
* satisfy to be included in the query results.
*
*
* @return Filters search results by document fields/attributes. You can only provide one attribute filter; however,
* the AndAllFilters, NotFilter, and OrAllFilters parameters contain
* a list of other filters.
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document
* must satisfy to be included in the query results.
*/
public AttributeFilter getAttributeFilter() {
return this.attributeFilter;
}
/**
*
* Filters search results by document fields/attributes. You can only provide one attribute filter; however, the
* AndAllFilters, NotFilter, and OrAllFilters parameters contain a list of
* other filters.
*
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document must
* satisfy to be included in the query results.
*
*
* @param attributeFilter
* Filters search results by document fields/attributes. You can only provide one attribute filter; however,
* the AndAllFilters, NotFilter, and OrAllFilters parameters contain a
* list of other filters.
*
* The AttributeFilter parameter means you can create a set of filtering rules that a document
* must satisfy to be included in the query results.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withAttributeFilter(AttributeFilter attributeFilter) {
setAttributeFilter(attributeFilter);
return this;
}
/**
*
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field key
* specified. This helps your users narrow their search.
*
*
* @return An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field
* key specified. This helps your users narrow their search.
*/
public java.util.List getFacets() {
return facets;
}
/**
*
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field key
* specified. This helps your users narrow their search.
*
*
* @param facets
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field
* key specified. This helps your users narrow their search.
*/
public void setFacets(java.util.Collection facets) {
if (facets == null) {
this.facets = null;
return;
}
this.facets = new java.util.ArrayList(facets);
}
/**
*
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field key
* specified. This helps your users narrow their search.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setFacets(java.util.Collection)} or {@link #withFacets(java.util.Collection)} if you want to override the
* existing values.
*
*
* @param facets
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field
* key specified. This helps your users narrow their search.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withFacets(Facet... facets) {
if (this.facets == null) {
setFacets(new java.util.ArrayList(facets.length));
}
for (Facet ele : facets) {
this.facets.add(ele);
}
return this;
}
/**
*
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field key
* specified. This helps your users narrow their search.
*
*
* @param facets
* An array of documents fields/attributes for faceted search. Amazon Kendra returns a count for each field
* key specified. This helps your users narrow their search.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withFacets(java.util.Collection facets) {
setFacets(facets);
return this;
}
/**
*
* An array of document fields/attributes to include in the response. You can limit the response to include certain
* document fields. By default, all document attributes are included in the response.
*
*
* @return An array of document fields/attributes to include in the response. You can limit the response to include
* certain document fields. By default, all document attributes are included in the response.
*/
public java.util.List getRequestedDocumentAttributes() {
return requestedDocumentAttributes;
}
/**
*
* An array of document fields/attributes to include in the response. You can limit the response to include certain
* document fields. By default, all document attributes are included in the response.
*
*
* @param requestedDocumentAttributes
* An array of document fields/attributes to include in the response. You can limit the response to include
* certain document fields. By default, all document attributes are included in the response.
*/
public void setRequestedDocumentAttributes(java.util.Collection requestedDocumentAttributes) {
if (requestedDocumentAttributes == null) {
this.requestedDocumentAttributes = null;
return;
}
this.requestedDocumentAttributes = new java.util.ArrayList(requestedDocumentAttributes);
}
/**
*
* An array of document fields/attributes to include in the response. You can limit the response to include certain
* document fields. By default, all document attributes are included in the response.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setRequestedDocumentAttributes(java.util.Collection)} or
* {@link #withRequestedDocumentAttributes(java.util.Collection)} if you want to override the existing values.
*
*
* @param requestedDocumentAttributes
* An array of document fields/attributes to include in the response. You can limit the response to include
* certain document fields. By default, all document attributes are included in the response.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withRequestedDocumentAttributes(String... requestedDocumentAttributes) {
if (this.requestedDocumentAttributes == null) {
setRequestedDocumentAttributes(new java.util.ArrayList(requestedDocumentAttributes.length));
}
for (String ele : requestedDocumentAttributes) {
this.requestedDocumentAttributes.add(ele);
}
return this;
}
/**
*
* An array of document fields/attributes to include in the response. You can limit the response to include certain
* document fields. By default, all document attributes are included in the response.
*
*
* @param requestedDocumentAttributes
* An array of document fields/attributes to include in the response. You can limit the response to include
* certain document fields. By default, all document attributes are included in the response.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withRequestedDocumentAttributes(java.util.Collection requestedDocumentAttributes) {
setRequestedDocumentAttributes(requestedDocumentAttributes);
return this;
}
/**
*
* Sets the type of query result or response. Only results for the specified type are returned.
*
*
* @param queryResultTypeFilter
* Sets the type of query result or response. Only results for the specified type are returned.
* @see QueryResultType
*/
public void setQueryResultTypeFilter(String queryResultTypeFilter) {
this.queryResultTypeFilter = queryResultTypeFilter;
}
/**
*
* Sets the type of query result or response. Only results for the specified type are returned.
*
*
* @return Sets the type of query result or response. Only results for the specified type are returned.
* @see QueryResultType
*/
public String getQueryResultTypeFilter() {
return this.queryResultTypeFilter;
}
/**
*
* Sets the type of query result or response. Only results for the specified type are returned.
*
*
* @param queryResultTypeFilter
* Sets the type of query result or response. Only results for the specified type are returned.
* @return Returns a reference to this object so that method calls can be chained together.
* @see QueryResultType
*/
public QueryRequest withQueryResultTypeFilter(String queryResultTypeFilter) {
setQueryResultTypeFilter(queryResultTypeFilter);
return this;
}
/**
*
* Sets the type of query result or response. Only results for the specified type are returned.
*
*
* @param queryResultTypeFilter
* Sets the type of query result or response. Only results for the specified type are returned.
* @return Returns a reference to this object so that method calls can be chained together.
* @see QueryResultType
*/
public QueryRequest withQueryResultTypeFilter(QueryResultType queryResultTypeFilter) {
this.queryResultTypeFilter = queryResultTypeFilter.toString();
return this;
}
/**
*
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
*
* If you use this API to override the relevance tuning configured at the index level, but there is no relevance
* tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override only some
* of these fields, then for the fields you did not override, the importance is set to 1.
*
*
* @return Overrides relevance tuning configurations of fields/attributes set at the index level.
*
* If you use this API to override the relevance tuning configured at the index level, but there is no
* relevance tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override
* only some of these fields, then for the fields you did not override, the importance is set to 1.
*/
public java.util.List getDocumentRelevanceOverrideConfigurations() {
return documentRelevanceOverrideConfigurations;
}
/**
*
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
*
* If you use this API to override the relevance tuning configured at the index level, but there is no relevance
* tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override only some
* of these fields, then for the fields you did not override, the importance is set to 1.
*
*
* @param documentRelevanceOverrideConfigurations
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
* If you use this API to override the relevance tuning configured at the index level, but there is no
* relevance tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override
* only some of these fields, then for the fields you did not override, the importance is set to 1.
*/
public void setDocumentRelevanceOverrideConfigurations(java.util.Collection documentRelevanceOverrideConfigurations) {
if (documentRelevanceOverrideConfigurations == null) {
this.documentRelevanceOverrideConfigurations = null;
return;
}
this.documentRelevanceOverrideConfigurations = new java.util.ArrayList(documentRelevanceOverrideConfigurations);
}
/**
*
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
*
* If you use this API to override the relevance tuning configured at the index level, but there is no relevance
* tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override only some
* of these fields, then for the fields you did not override, the importance is set to 1.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setDocumentRelevanceOverrideConfigurations(java.util.Collection)} or
* {@link #withDocumentRelevanceOverrideConfigurations(java.util.Collection)} if you want to override the existing
* values.
*
*
* @param documentRelevanceOverrideConfigurations
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
* If you use this API to override the relevance tuning configured at the index level, but there is no
* relevance tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override
* only some of these fields, then for the fields you did not override, the importance is set to 1.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withDocumentRelevanceOverrideConfigurations(DocumentRelevanceConfiguration... documentRelevanceOverrideConfigurations) {
if (this.documentRelevanceOverrideConfigurations == null) {
setDocumentRelevanceOverrideConfigurations(new java.util.ArrayList(documentRelevanceOverrideConfigurations.length));
}
for (DocumentRelevanceConfiguration ele : documentRelevanceOverrideConfigurations) {
this.documentRelevanceOverrideConfigurations.add(ele);
}
return this;
}
/**
*
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
*
* If you use this API to override the relevance tuning configured at the index level, but there is no relevance
* tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override only some
* of these fields, then for the fields you did not override, the importance is set to 1.
*
*
* @param documentRelevanceOverrideConfigurations
* Overrides relevance tuning configurations of fields/attributes set at the index level.
*
* If you use this API to override the relevance tuning configured at the index level, but there is no
* relevance tuning configured at the index level, then Amazon Kendra does not apply any relevance tuning.
*
*
* If there is relevance tuning configured for fields at the index level, and you use this API to override
* only some of these fields, then for the fields you did not override, the importance is set to 1.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withDocumentRelevanceOverrideConfigurations(java.util.Collection documentRelevanceOverrideConfigurations) {
setDocumentRelevanceOverrideConfigurations(documentRelevanceOverrideConfigurations);
return this;
}
/**
*
* Query results are returned in pages the size of the PageSize parameter. By default, Amazon Kendra
* returns the first page of results. Use this parameter to get result pages after the first one.
*
*
* @param pageNumber
* Query results are returned in pages the size of the PageSize parameter. By default, Amazon
* Kendra returns the first page of results. Use this parameter to get result pages after the first one.
*/
public void setPageNumber(Integer pageNumber) {
this.pageNumber = pageNumber;
}
/**
*
* Query results are returned in pages the size of the PageSize parameter. By default, Amazon Kendra
* returns the first page of results. Use this parameter to get result pages after the first one.
*
*
* @return Query results are returned in pages the size of the PageSize parameter. By default, Amazon
* Kendra returns the first page of results. Use this parameter to get result pages after the first one.
*/
public Integer getPageNumber() {
return this.pageNumber;
}
/**
*
* Query results are returned in pages the size of the PageSize parameter. By default, Amazon Kendra
* returns the first page of results. Use this parameter to get result pages after the first one.
*
*
* @param pageNumber
* Query results are returned in pages the size of the PageSize parameter. By default, Amazon
* Kendra returns the first page of results. Use this parameter to get result pages after the first one.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withPageNumber(Integer pageNumber) {
setPageNumber(pageNumber);
return this;
}
/**
*
* Sets the number of results that are returned in each page of results. The default page size is 10. The maximum
* number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
*
*
* @param pageSize
* Sets the number of results that are returned in each page of results. The default page size is 10. The
* maximum number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
*/
public void setPageSize(Integer pageSize) {
this.pageSize = pageSize;
}
/**
*
* Sets the number of results that are returned in each page of results. The default page size is 10. The maximum
* number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
*
*
* @return Sets the number of results that are returned in each page of results. The default page size is 10. The
* maximum number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
*/
public Integer getPageSize() {
return this.pageSize;
}
/**
*
* Sets the number of results that are returned in each page of results. The default page size is 10. The maximum
* number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
*
*
* @param pageSize
* Sets the number of results that are returned in each page of results. The default page size is 10. The
* maximum number of results returned is 100. If you ask for more than 100 results, only 100 are returned.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withPageSize(Integer pageSize) {
setPageSize(pageSize);
return this;
}
/**
*
* Provides information that determines how the results of the query are sorted. You can set the field that Amazon
* Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending
* order. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra determines
* for the result.
*
*
* @param sortingConfiguration
* Provides information that determines how the results of the query are sorted. You can set the field that
* Amazon Kendra should sort the results on, and specify whether the results should be sorted in ascending or
* descending order. In the case of ties in sorting the results, the results are sorted by relevance.
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result.
*/
public void setSortingConfiguration(SortingConfiguration sortingConfiguration) {
this.sortingConfiguration = sortingConfiguration;
}
/**
*
* Provides information that determines how the results of the query are sorted. You can set the field that Amazon
* Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending
* order. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra determines
* for the result.
*
*
* @return Provides information that determines how the results of the query are sorted. You can set the field that
* Amazon Kendra should sort the results on, and specify whether the results should be sorted in ascending
* or descending order. In the case of ties in sorting the results, the results are sorted by relevance.
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result.
*/
public SortingConfiguration getSortingConfiguration() {
return this.sortingConfiguration;
}
/**
*
* Provides information that determines how the results of the query are sorted. You can set the field that Amazon
* Kendra should sort the results on, and specify whether the results should be sorted in ascending or descending
* order. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra determines
* for the result.
*
*
* @param sortingConfiguration
* Provides information that determines how the results of the query are sorted. You can set the field that
* Amazon Kendra should sort the results on, and specify whether the results should be sorted in ascending or
* descending order. In the case of ties in sorting the results, the results are sorted by relevance.
*
* If you don't provide sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withSortingConfiguration(SortingConfiguration sortingConfiguration) {
setSortingConfiguration(sortingConfiguration);
return this;
}
/**
*
* Provides configuration information to determine how the results of a query are sorted.
*
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results should
* be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* @return Provides configuration information to determine how the results of a query are sorted.
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results
* should be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by
* relevance.
*/
public java.util.List getSortingConfigurations() {
return sortingConfigurations;
}
/**
*
* Provides configuration information to determine how the results of a query are sorted.
*
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results should
* be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* @param sortingConfigurations
* Provides configuration information to determine how the results of a query are sorted.
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results
* should be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by
* relevance.
*/
public void setSortingConfigurations(java.util.Collection sortingConfigurations) {
if (sortingConfigurations == null) {
this.sortingConfigurations = null;
return;
}
this.sortingConfigurations = new java.util.ArrayList(sortingConfigurations);
}
/**
*
* Provides configuration information to determine how the results of a query are sorted.
*
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results should
* be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setSortingConfigurations(java.util.Collection)} or
* {@link #withSortingConfigurations(java.util.Collection)} if you want to override the existing values.
*
*
* @param sortingConfigurations
* Provides configuration information to determine how the results of a query are sorted.
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results
* should be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by
* relevance.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withSortingConfigurations(SortingConfiguration... sortingConfigurations) {
if (this.sortingConfigurations == null) {
setSortingConfigurations(new java.util.ArrayList(sortingConfigurations.length));
}
for (SortingConfiguration ele : sortingConfigurations) {
this.sortingConfigurations.add(ele);
}
return this;
}
/**
*
* Provides configuration information to determine how the results of a query are sorted.
*
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results should
* be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by relevance.
*
*
* @param sortingConfigurations
* Provides configuration information to determine how the results of a query are sorted.
*
* You can set upto 3 fields that Amazon Kendra should sort the results on, and specify whether the results
* should be sorted in ascending or descending order. The sort field quota can be increased.
*
*
* If you don't provide a sorting configuration, the results are sorted by the relevance that Amazon Kendra
* determines for the result. In the case of ties in sorting the results, the results are sorted by
* relevance.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withSortingConfigurations(java.util.Collection sortingConfigurations) {
setSortingConfigurations(sortingConfigurations);
return this;
}
/**
*
* The user context token or user and group information.
*
*
* @param userContext
* The user context token or user and group information.
*/
public void setUserContext(UserContext userContext) {
this.userContext = userContext;
}
/**
*
* The user context token or user and group information.
*
*
* @return The user context token or user and group information.
*/
public UserContext getUserContext() {
return this.userContext;
}
/**
*
* The user context token or user and group information.
*
*
* @param userContext
* The user context token or user and group information.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withUserContext(UserContext userContext) {
setUserContext(userContext);
return this;
}
/**
*
* Provides an identifier for a specific user. The VisitorId should be a unique identifier, such as a
* GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
*
*
* @param visitorId
* Provides an identifier for a specific user. The VisitorId should be a unique identifier, such
* as a GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
*/
public void setVisitorId(String visitorId) {
this.visitorId = visitorId;
}
/**
*
* Provides an identifier for a specific user. The VisitorId should be a unique identifier, such as a
* GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
*
*
* @return Provides an identifier for a specific user. The VisitorId should be a unique identifier,
* such as a GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
*/
public String getVisitorId() {
return this.visitorId;
}
/**
*
* Provides an identifier for a specific user. The VisitorId should be a unique identifier, such as a
* GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
*
*
* @param visitorId
* Provides an identifier for a specific user. The VisitorId should be a unique identifier, such
* as a GUID. Don't use personally identifiable information, such as the user's email address, as the
* VisitorId.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withVisitorId(String visitorId) {
setVisitorId(visitorId);
return this;
}
/**
*
* Enables suggested spell corrections for queries.
*
*
* @param spellCorrectionConfiguration
* Enables suggested spell corrections for queries.
*/
public void setSpellCorrectionConfiguration(SpellCorrectionConfiguration spellCorrectionConfiguration) {
this.spellCorrectionConfiguration = spellCorrectionConfiguration;
}
/**
*
* Enables suggested spell corrections for queries.
*
*
* @return Enables suggested spell corrections for queries.
*/
public SpellCorrectionConfiguration getSpellCorrectionConfiguration() {
return this.spellCorrectionConfiguration;
}
/**
*
* Enables suggested spell corrections for queries.
*
*
* @param spellCorrectionConfiguration
* Enables suggested spell corrections for queries.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withSpellCorrectionConfiguration(SpellCorrectionConfiguration spellCorrectionConfiguration) {
setSpellCorrectionConfiguration(spellCorrectionConfiguration);
return this;
}
/**
*
* Provides configuration to determine how to group results by document attribute value, and how to display them
* (collapsed or expanded) under a designated primary document for each group.
*
*
* @param collapseConfiguration
* Provides configuration to determine how to group results by document attribute value, and how to display
* them (collapsed or expanded) under a designated primary document for each group.
*/
public void setCollapseConfiguration(CollapseConfiguration collapseConfiguration) {
this.collapseConfiguration = collapseConfiguration;
}
/**
*
* Provides configuration to determine how to group results by document attribute value, and how to display them
* (collapsed or expanded) under a designated primary document for each group.
*
*
* @return Provides configuration to determine how to group results by document attribute value, and how to display
* them (collapsed or expanded) under a designated primary document for each group.
*/
public CollapseConfiguration getCollapseConfiguration() {
return this.collapseConfiguration;
}
/**
*
* Provides configuration to determine how to group results by document attribute value, and how to display them
* (collapsed or expanded) under a designated primary document for each group.
*
*
* @param collapseConfiguration
* Provides configuration to determine how to group results by document attribute value, and how to display
* them (collapsed or expanded) under a designated primary document for each group.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public QueryRequest withCollapseConfiguration(CollapseConfiguration collapseConfiguration) {
setCollapseConfiguration(collapseConfiguration);
return this;
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getIndexId() != null)
sb.append("IndexId: ").append(getIndexId()).append(",");
if (getQueryText() != null)
sb.append("QueryText: ").append(getQueryText()).append(",");
if (getAttributeFilter() != null)
sb.append("AttributeFilter: ").append(getAttributeFilter()).append(",");
if (getFacets() != null)
sb.append("Facets: ").append(getFacets()).append(",");
if (getRequestedDocumentAttributes() != null)
sb.append("RequestedDocumentAttributes: ").append(getRequestedDocumentAttributes()).append(",");
if (getQueryResultTypeFilter() != null)
sb.append("QueryResultTypeFilter: ").append(getQueryResultTypeFilter()).append(",");
if (getDocumentRelevanceOverrideConfigurations() != null)
sb.append("DocumentRelevanceOverrideConfigurations: ").append(getDocumentRelevanceOverrideConfigurations()).append(",");
if (getPageNumber() != null)
sb.append("PageNumber: ").append(getPageNumber()).append(",");
if (getPageSize() != null)
sb.append("PageSize: ").append(getPageSize()).append(",");
if (getSortingConfiguration() != null)
sb.append("SortingConfiguration: ").append(getSortingConfiguration()).append(",");
if (getSortingConfigurations() != null)
sb.append("SortingConfigurations: ").append(getSortingConfigurations()).append(",");
if (getUserContext() != null)
sb.append("UserContext: ").append(getUserContext()).append(",");
if (getVisitorId() != null)
sb.append("VisitorId: ").append(getVisitorId()).append(",");
if (getSpellCorrectionConfiguration() != null)
sb.append("SpellCorrectionConfiguration: ").append(getSpellCorrectionConfiguration()).append(",");
if (getCollapseConfiguration() != null)
sb.append("CollapseConfiguration: ").append(getCollapseConfiguration());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof QueryRequest == false)
return false;
QueryRequest other = (QueryRequest) obj;
if (other.getIndexId() == null ^ this.getIndexId() == null)
return false;
if (other.getIndexId() != null && other.getIndexId().equals(this.getIndexId()) == false)
return false;
if (other.getQueryText() == null ^ this.getQueryText() == null)
return false;
if (other.getQueryText() != null && other.getQueryText().equals(this.getQueryText()) == false)
return false;
if (other.getAttributeFilter() == null ^ this.getAttributeFilter() == null)
return false;
if (other.getAttributeFilter() != null && other.getAttributeFilter().equals(this.getAttributeFilter()) == false)
return false;
if (other.getFacets() == null ^ this.getFacets() == null)
return false;
if (other.getFacets() != null && other.getFacets().equals(this.getFacets()) == false)
return false;
if (other.getRequestedDocumentAttributes() == null ^ this.getRequestedDocumentAttributes() == null)
return false;
if (other.getRequestedDocumentAttributes() != null && other.getRequestedDocumentAttributes().equals(this.getRequestedDocumentAttributes()) == false)
return false;
if (other.getQueryResultTypeFilter() == null ^ this.getQueryResultTypeFilter() == null)
return false;
if (other.getQueryResultTypeFilter() != null && other.getQueryResultTypeFilter().equals(this.getQueryResultTypeFilter()) == false)
return false;
if (other.getDocumentRelevanceOverrideConfigurations() == null ^ this.getDocumentRelevanceOverrideConfigurations() == null)
return false;
if (other.getDocumentRelevanceOverrideConfigurations() != null
&& other.getDocumentRelevanceOverrideConfigurations().equals(this.getDocumentRelevanceOverrideConfigurations()) == false)
return false;
if (other.getPageNumber() == null ^ this.getPageNumber() == null)
return false;
if (other.getPageNumber() != null && other.getPageNumber().equals(this.getPageNumber()) == false)
return false;
if (other.getPageSize() == null ^ this.getPageSize() == null)
return false;
if (other.getPageSize() != null && other.getPageSize().equals(this.getPageSize()) == false)
return false;
if (other.getSortingConfiguration() == null ^ this.getSortingConfiguration() == null)
return false;
if (other.getSortingConfiguration() != null && other.getSortingConfiguration().equals(this.getSortingConfiguration()) == false)
return false;
if (other.getSortingConfigurations() == null ^ this.getSortingConfigurations() == null)
return false;
if (other.getSortingConfigurations() != null && other.getSortingConfigurations().equals(this.getSortingConfigurations()) == false)
return false;
if (other.getUserContext() == null ^ this.getUserContext() == null)
return false;
if (other.getUserContext() != null && other.getUserContext().equals(this.getUserContext()) == false)
return false;
if (other.getVisitorId() == null ^ this.getVisitorId() == null)
return false;
if (other.getVisitorId() != null && other.getVisitorId().equals(this.getVisitorId()) == false)
return false;
if (other.getSpellCorrectionConfiguration() == null ^ this.getSpellCorrectionConfiguration() == null)
return false;
if (other.getSpellCorrectionConfiguration() != null && other.getSpellCorrectionConfiguration().equals(this.getSpellCorrectionConfiguration()) == false)
return false;
if (other.getCollapseConfiguration() == null ^ this.getCollapseConfiguration() == null)
return false;
if (other.getCollapseConfiguration() != null && other.getCollapseConfiguration().equals(this.getCollapseConfiguration()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getIndexId() == null) ? 0 : getIndexId().hashCode());
hashCode = prime * hashCode + ((getQueryText() == null) ? 0 : getQueryText().hashCode());
hashCode = prime * hashCode + ((getAttributeFilter() == null) ? 0 : getAttributeFilter().hashCode());
hashCode = prime * hashCode + ((getFacets() == null) ? 0 : getFacets().hashCode());
hashCode = prime * hashCode + ((getRequestedDocumentAttributes() == null) ? 0 : getRequestedDocumentAttributes().hashCode());
hashCode = prime * hashCode + ((getQueryResultTypeFilter() == null) ? 0 : getQueryResultTypeFilter().hashCode());
hashCode = prime * hashCode + ((getDocumentRelevanceOverrideConfigurations() == null) ? 0 : getDocumentRelevanceOverrideConfigurations().hashCode());
hashCode = prime * hashCode + ((getPageNumber() == null) ? 0 : getPageNumber().hashCode());
hashCode = prime * hashCode + ((getPageSize() == null) ? 0 : getPageSize().hashCode());
hashCode = prime * hashCode + ((getSortingConfiguration() == null) ? 0 : getSortingConfiguration().hashCode());
hashCode = prime * hashCode + ((getSortingConfigurations() == null) ? 0 : getSortingConfigurations().hashCode());
hashCode = prime * hashCode + ((getUserContext() == null) ? 0 : getUserContext().hashCode());
hashCode = prime * hashCode + ((getVisitorId() == null) ? 0 : getVisitorId().hashCode());
hashCode = prime * hashCode + ((getSpellCorrectionConfiguration() == null) ? 0 : getSpellCorrectionConfiguration().hashCode());
hashCode = prime * hashCode + ((getCollapseConfiguration() == null) ? 0 : getCollapseConfiguration().hashCode());
return hashCode;
}
@Override
public QueryRequest clone() {
return (QueryRequest) super.clone();
}
}