Class SearchHit

All Implemented Interfaces:
java.lang.Iterable<DocumentField>, Writeable, ToXContent, ToXContentObject

public final class SearchHit
extends java.lang.Object
implements Writeable, ToXContentObject, java.lang.Iterable<DocumentField>
A single search hit.
See Also:
  • Constructor Details

  • Method Details

    • writeTo

      public void writeTo​(StreamOutput out) throws
      Description copied from interface: Writeable
      Write this into the StreamOutput.
      Specified by:
      writeTo in interface Writeable
    • docId

      public int docId()
    • score

      public void score​(float score)
    • getScore

      public float getScore()
      The score.
    • version

      public void version​(long version)
    • getVersion

      public long getVersion()
      The version of the hit.
    • setSeqNo

      public void setSeqNo​(long seqNo)
    • setPrimaryTerm

      public void setPrimaryTerm​(long primaryTerm)
    • getSeqNo

      public long getSeqNo()
      returns the sequence number of the last modification to the document, or SequenceNumbers.UNASSIGNED_SEQ_NO if not requested.
    • getPrimaryTerm

      public long getPrimaryTerm()
      returns the primary term of the last modification to the document, or SequenceNumbers.UNASSIGNED_PRIMARY_TERM if not requested.
    • getIndex

      public java.lang.String getIndex()
      The index of the hit.
    • getId

      public java.lang.String getId()
      The id of the document.
    • getType

      @Deprecated public java.lang.String getType()
      Types are in the process of being removed. Instead of using a type, prefer to filter on a field on the document.
      The type of the document.
    • getNestedIdentity

      public SearchHit.NestedIdentity getNestedIdentity()
      If this is a nested hit then nested reference information is returned otherwise null is returned.
    • getSourceRef

      public BytesReference getSourceRef()
      Returns bytes reference, also uncompress the source if needed.
    • sourceRef

      public SearchHit sourceRef​(BytesReference source)
      Sets representation, might be compressed....
    • hasSource

      public boolean hasSource()
      Is the source available or not. A source with no fields will return true. This will return false if fields doesn't contain _source or if source is disabled in the mapping.
    • getSourceAsString

      public java.lang.String getSourceAsString()
      The source of the document as string (can be null).
    • getSourceAsMap

      public java.util.Map<java.lang.String,​java.lang.Object> getSourceAsMap()
      The source of the document as a map (can be null).
    • iterator

      public java.util.Iterator<DocumentField> iterator()
      Specified by:
      iterator in interface java.lang.Iterable<DocumentField>
    • field

      public DocumentField field​(java.lang.String fieldName)
      The hit field matching the given field name.
    • getFields

      public java.util.Map<java.lang.String,​DocumentField> getFields()
      A map of hit fields (from field name to hit fields) if additional fields were required to be loaded.
    • fieldsOrNull

      public java.util.Map<java.lang.String,​DocumentField> fieldsOrNull()
    • fields

      public void fields​(java.util.Map<java.lang.String,​DocumentField> fields)
    • getHighlightFields

      public java.util.Map<java.lang.String,​HighlightField> getHighlightFields()
      A map of highlighted fields.
    • highlightFields

      public void highlightFields​(java.util.Map<java.lang.String,​HighlightField> highlightFields)
    • sortValues

      public void sortValues​(java.lang.Object[] sortValues, DocValueFormat[] sortValueFormats)
    • sortValues

      public void sortValues​(SearchSortValues sortValues)
    • getSortValues

      public java.lang.Object[] getSortValues()
      An array of the (formatted) sort values used.
    • getRawSortValues

      public java.lang.Object[] getRawSortValues()
      An array of the (raw) sort values used.
    • getExplanation

      public getExplanation()
      If enabled, the explanation of the search hit.
    • explanation

      public void explanation​( explanation)
    • getShard

      public SearchShardTarget getShard()
      The shard of the search hit.
    • shard

      public void shard​(SearchShardTarget target)
    • getClusterAlias

      public java.lang.String getClusterAlias()
      Returns the cluster alias this hit comes from or null if it comes from a local cluster
    • matchedQueries

      public void matchedQueries​(java.lang.String[] matchedQueries)
    • getMatchedQueries

      public java.lang.String[] getMatchedQueries()
      The set of query and filter names the query matched with. Mainly makes sense for compound filters and queries.
    • getInnerHits

      public java.util.Map<java.lang.String,​SearchHits> getInnerHits()
      Inner hits or null if there are none
    • setInnerHits

      public void setInnerHits​(java.util.Map<java.lang.String,​SearchHits> innerHits)
    • toXContent

      public XContentBuilder toXContent​(XContentBuilder builder, ToXContent.Params params) throws
      Specified by:
      toXContent in interface ToXContent
    • toInnerXContent

      public XContentBuilder toInnerXContent​(XContentBuilder builder, ToXContent.Params params) throws
    • fromXContent

      public static SearchHit fromXContent​(XContentParser parser)
    • declareInnerHitsParseFields

      public static void declareInnerHitsParseFields​(ObjectParser<java.util.Map<java.lang.String,​java.lang.Object>,​java.lang.Void> parser)
    • createFromMap

      public static SearchHit createFromMap​(java.util.Map<java.lang.String,​java.lang.Object> values)
    • equals

      public boolean equals​(java.lang.Object obj)
      equals in class java.lang.Object
    • hashCode

      public int hashCode()
      hashCode in class java.lang.Object
    • toString

      public java.lang.String toString()
      toString in class java.lang.Object