Class QueryResultItem
- java.lang.Object
-
- software.amazon.awssdk.services.kendra.model.QueryResultItem
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<QueryResultItem.Builder,QueryResultItem>
@Generated("software.amazon.awssdk:codegen") public final class QueryResultItem extends Object implements SdkPojo, Serializable, ToCopyableBuilder<QueryResultItem.Builder,QueryResultItem>
A single query result.
A query result contains information about a document returned by the query. This includes the original location of the document, a list of attributes assigned to the document, and relevant text from the document that satisfies the query.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceQueryResultItem.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description List<AdditionalResultAttribute>additionalAttributes()One or more additional fields/attributes associated with the query result.static QueryResultItem.Builderbuilder()CollapsedResultDetailcollapsedResultDetail()Provides details about a collapsed group of search results.List<DocumentAttribute>documentAttributes()An array of document fields/attributes assigned to a document in the search results.TextWithHighlightsdocumentExcerpt()An extract of the text in the document.StringdocumentId()The identifier for the document.TextWithHighlightsdocumentTitle()The title of the document.StringdocumentURI()The URI of the original location of the document.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)StringfeedbackToken()A token that identifies a particular result from a particular query.QueryResultFormatformat()If theTypeof document within the response isANSWER, then it is either aTABLEanswer orTEXTanswer.StringformatAsString()If theTypeof document within the response isANSWER, then it is either aTABLEanswer orTEXTanswer.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasAdditionalAttributes()For responses, this returns true if the service returned a value for the AdditionalAttributes property.booleanhasDocumentAttributes()For responses, this returns true if the service returned a value for the DocumentAttributes property.inthashCode()Stringid()The unique identifier for the query result item id (Id) and the query result item document id (DocumentId) combined.ScoreAttributesscoreAttributes()Indicates the confidence level of Amazon Kendra providing a relevant result for the query.List<SdkField<?>>sdkFields()static Class<? extends QueryResultItem.Builder>serializableBuilderClass()TableExcerpttableExcerpt()An excerpt from a table within a document.QueryResultItem.BuildertoBuilder()StringtoString()Returns a string representation of this object.QueryResultTypetype()The type of document within the response.StringtypeAsString()The type of document within the response.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
id
public final String id()
The unique identifier for the query result item id (
Id) and the query result item document id (DocumentId) combined. The value of this field changes with every request, even when you have the same documents.- Returns:
- The unique identifier for the query result item id (
Id) and the query result item document id (DocumentId) combined. The value of this field changes with every request, even when you have the same documents.
-
type
public final QueryResultType type()
The type of document within the response. For example, a response could include a question-answer that's relevant to the query.
If the service returns an enum value that is not available in the current SDK version,
typewill returnQueryResultType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtypeAsString().- Returns:
- The type of document within the response. For example, a response could include a question-answer that's relevant to the query.
- See Also:
QueryResultType
-
typeAsString
public final String typeAsString()
The type of document within the response. For example, a response could include a question-answer that's relevant to the query.
If the service returns an enum value that is not available in the current SDK version,
typewill returnQueryResultType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtypeAsString().- Returns:
- The type of document within the response. For example, a response could include a question-answer that's relevant to the query.
- See Also:
QueryResultType
-
format
public final QueryResultFormat format()
If the
Typeof document within the response isANSWER, then it is either aTABLEanswer orTEXTanswer. If it's a table answer, a table excerpt is returned inTableExcerpt. If it's a text answer, a text excerpt is returned inDocumentExcerpt.If the service returns an enum value that is not available in the current SDK version,
formatwill returnQueryResultFormat.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromformatAsString().- Returns:
- If the
Typeof document within the response isANSWER, then it is either aTABLEanswer orTEXTanswer. If it's a table answer, a table excerpt is returned inTableExcerpt. If it's a text answer, a text excerpt is returned inDocumentExcerpt. - See Also:
QueryResultFormat
-
formatAsString
public final String formatAsString()
If the
Typeof document within the response isANSWER, then it is either aTABLEanswer orTEXTanswer. If it's a table answer, a table excerpt is returned inTableExcerpt. If it's a text answer, a text excerpt is returned inDocumentExcerpt.If the service returns an enum value that is not available in the current SDK version,
formatwill returnQueryResultFormat.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromformatAsString().- Returns:
- If the
Typeof document within the response isANSWER, then it is either aTABLEanswer orTEXTanswer. If it's a table answer, a table excerpt is returned inTableExcerpt. If it's a text answer, a text excerpt is returned inDocumentExcerpt. - See Also:
QueryResultFormat
-
hasAdditionalAttributes
public final boolean hasAdditionalAttributes()
For responses, this returns true if the service returned a value for the AdditionalAttributes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
additionalAttributes
public final List<AdditionalResultAttribute> additionalAttributes()
One or more additional fields/attributes associated with the query result.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasAdditionalAttributes()method.- Returns:
- One or more additional fields/attributes associated with the query result.
-
documentId
public final String documentId()
The identifier for the document.
- Returns:
- The identifier for the document.
-
documentTitle
public final TextWithHighlights documentTitle()
The title of the document. Contains the text of the title and information for highlighting the relevant terms in the title.
- Returns:
- The title of the document. Contains the text of the title and information for highlighting the relevant terms in the title.
-
documentExcerpt
public final TextWithHighlights documentExcerpt()
An extract of the text in the document. Contains information about highlighting the relevant terms in the excerpt.
- Returns:
- An extract of the text in the document. Contains information about highlighting the relevant terms in the excerpt.
-
documentURI
public final String documentURI()
The URI of the original location of the document.
- Returns:
- The URI of the original location of the document.
-
hasDocumentAttributes
public final boolean hasDocumentAttributes()
For responses, this returns true if the service returned a value for the DocumentAttributes property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
documentAttributes
public final List<DocumentAttribute> documentAttributes()
An array of document fields/attributes assigned to a document in the search results. For example, the document author (
_author) or the source URI (_source_uri) of the document.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasDocumentAttributes()method.- Returns:
- An array of document fields/attributes assigned to a document in the search results. For example, the
document author (
_author) or the source URI (_source_uri) of the document.
-
scoreAttributes
public final ScoreAttributes scoreAttributes()
Indicates the confidence level of Amazon Kendra providing a relevant result for the query. Each result is placed into a bin that indicates the confidence,
VERY_HIGH,HIGH,MEDIUMandLOW. You can use the score to determine if a response meets the confidence needed for your application.The field is only set to
LOWwhen theTypefield is set toDOCUMENTand Amazon Kendra is not confident that the result is relevant to the query.- Returns:
- Indicates the confidence level of Amazon Kendra providing a relevant result for the query. Each result is
placed into a bin that indicates the confidence,
VERY_HIGH,HIGH,MEDIUMandLOW. You can use the score to determine if a response meets the confidence needed for your application.The field is only set to
LOWwhen theTypefield is set toDOCUMENTand Amazon Kendra is not confident that the result is relevant to the query.
-
feedbackToken
public final String feedbackToken()
A token that identifies a particular result from a particular query. Use this token to provide click-through feedback for the result. For more information, see Submitting feedback.
- Returns:
- A token that identifies a particular result from a particular query. Use this token to provide click-through feedback for the result. For more information, see Submitting feedback.
-
tableExcerpt
public final TableExcerpt tableExcerpt()
An excerpt from a table within a document.
- Returns:
- An excerpt from a table within a document.
-
collapsedResultDetail
public final CollapsedResultDetail collapsedResultDetail()
Provides details about a collapsed group of search results.
- Returns:
- Provides details about a collapsed group of search results.
-
toBuilder
public QueryResultItem.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<QueryResultItem.Builder,QueryResultItem>
-
builder
public static QueryResultItem.Builder builder()
-
serializableBuilderClass
public static Class<? extends QueryResultItem.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
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.
-
-