Package org.elasticsearch.search.fetch.subphase.highlight

Class AbstractHighlighterBuilder<HB extends AbstractHighlighterBuilder<?>>

java.lang.Object
org.elasticsearch.search.fetch.subphase.highlight.AbstractHighlighterBuilder<HB>
All Implemented Interfaces:
Writeable, org.elasticsearch.common.xcontent.ToXContent, org.elasticsearch.common.xcontent.ToXContentObject, Rewriteable<HB>
Direct Known Subclasses:
HighlightBuilder, HighlightBuilder.Field
public abstract class AbstractHighlighterBuilder<HB extends AbstractHighlighterBuilder<?>>
extends java.lang.Object
implements Writeable, Rewriteable<HB>, org.elasticsearch.common.xcontent.ToXContentObject
This abstract class holds parameters shared by HighlightBuilder and HighlightBuilder.Field and provides the common setters, equality, hashCode calculation and common serialization

  • Field Details

  • Constructor Details

  • Method Details

    • writeTo

      public final void writeTo​(StreamOutput out) throws java.io.IOException
      write common parameters to StreamOutput
      Specified by:
      writeTo in interface Writeable
      Throws:
      java.io.IOException

    • doWriteTo

      protected abstract void doWriteTo​(StreamOutput out) throws java.io.IOException
      Throws:
      java.io.IOException

    • preTags

      public HB preTags​(java.lang.String... preTags)
      Set the pre tags that will be used for highlighting.

    • preTags

      public java.lang.String[] preTags()
      Returns:
      the value set by preTags(String...)

    • postTags

      public HB postTags​(java.lang.String... postTags)
      Set the post tags that will be used for highlighting.

    • postTags

      public java.lang.String[] postTags()
      Returns:
      the value set by postTags(String...)

    • fragmentSize

      public HB fragmentSize​(java.lang.Integer fragmentSize)
      Set the fragment size in characters, defaults to HighlightBuilder.DEFAULT_FRAGMENT_CHAR_SIZE

    • fragmentSize

      public java.lang.Integer fragmentSize()
      Returns:
      the value set by fragmentSize(Integer)

    • numOfFragments

      public HB numOfFragments​(java.lang.Integer numOfFragments)
      Set the number of fragments, defaults to HighlightBuilder.DEFAULT_NUMBER_OF_FRAGMENTS

    • numOfFragments

      public java.lang.Integer numOfFragments()
      Returns:
      the value set by numOfFragments(Integer)

    • highlighterType

      public HB highlighterType​(java.lang.String highlighterType)
      Set type of highlighter to use. Out of the box supported types are unified, plain and fvh. Defaults to unified. Details of the different highlighter types are covered in the reference guide.

    • highlighterType

      public java.lang.String highlighterType()
      Returns:
      the value set by highlighterType(String)

    • fragmenter

      public HB fragmenter​(java.lang.String fragmenter)
      Sets what fragmenter to use to break up text that is eligible for highlighting. This option is only applicable when using the plain highlighterType highlighter. Permitted values are "simple" or "span" relating to SimpleFragmenter and SimpleSpanFragmenter implementations respectively with the default being "span"

    • fragmenter

      public java.lang.String fragmenter()
      Returns:
      the value set by fragmenter(String)

    • highlightQuery

      public HB highlightQuery​(QueryBuilder highlightQuery)
      Sets a query to be used for highlighting instead of the search query.

    • highlightQuery

      public QueryBuilder highlightQuery()
      Returns:
      the value set by highlightQuery(QueryBuilder)

    • order

      public HB order​(java.lang.String order)
      The order of fragments per field. By default, ordered by the order in the highlighted text. Can be score, which then it will be ordered by score of the fragments, or none.

    • order

      public HB order​(HighlightBuilder.Order scoreOrdered)
      By default, fragments of a field are ordered by the order in the highlighted text. If set to HighlightBuilder.Order.SCORE, this changes order to score of the fragments.

    • order

      public HighlightBuilder.Order order()
      Returns:
      the value set by order(Order)

    • highlightFilter

      public HB highlightFilter​(java.lang.Boolean highlightFilter)
      Set this to true when using the highlighterType fvh and you want to provide highlighting on filter clauses in your query. Default is false.

    • highlightFilter

      public java.lang.Boolean highlightFilter()
      Returns:
      the value set by highlightFilter(Boolean)

    • boundaryScannerType

      public HB boundaryScannerType​(java.lang.String boundaryScannerType)
      When using the highlighterType fvh this setting controls which scanner to use for fragment boundaries, and defaults to "simple".

    • boundaryScannerType

      public HB boundaryScannerType​(HighlightBuilder.BoundaryScannerType boundaryScannerType)
      When using the highlighterType fvh this setting controls which scanner to use for fragment boundaries, and defaults to "simple".

    • boundaryScannerType

      public HighlightBuilder.BoundaryScannerType boundaryScannerType()
      Returns:
      the value set by boundaryScannerType(String)

    • boundaryMaxScan

      public HB boundaryMaxScan​(java.lang.Integer boundaryMaxScan)
      When using the highlighterType fvh this setting controls how far to look for boundary characters, and defaults to 20.

    • boundaryMaxScan

      public java.lang.Integer boundaryMaxScan()
      Returns:
      the value set by boundaryMaxScan(Integer)

    • boundaryChars

      public HB boundaryChars​(char[] boundaryChars)
      When using the highlighterType fvh this setting defines what constitutes a boundary for highlighting. It’s a single string with each boundary character defined in it. It defaults to .,!? \t\n

    • boundaryChars

      public char[] boundaryChars()
      Returns:
      the value set by boundaryChars(char[])

    • boundaryScannerLocale

      public HB boundaryScannerLocale​(java.lang.String boundaryScannerLocale)
      When using the highlighterType fvh and boundaryScannerType break_iterator, this setting controls the locale to use by the BreakIterator, defaults to "root".

    • boundaryScannerLocale

      public java.util.Locale boundaryScannerLocale()
      Returns:
      the value set by boundaryScannerLocale(String)

    • options

      public HB options​(java.util.Map<java.lang.String,​java.lang.Object> options)
      Allows to set custom options for custom highlighters.

    • options

      public java.util.Map<java.lang.String,​java.lang.Object> options()
      Returns:
      the value set by options(Map)

    • requireFieldMatch

      public HB requireFieldMatch​(java.lang.Boolean requireFieldMatch)
      Set to true to cause a field to be highlighted only if a query matches that field. Default is false meaning that terms are highlighted on all requested fields regardless if the query matches specifically on them.

    • requireFieldMatch

      public java.lang.Boolean requireFieldMatch()
      Returns:
      the value set by requireFieldMatch(Boolean)

    • noMatchSize

      public HB noMatchSize​(java.lang.Integer noMatchSize)
      Sets the size of the fragment to return from the beginning of the field if there are no matches to highlight and the field doesn't also define noMatchSize.
      Parameters:
      noMatchSize - integer to set or null to leave out of request. default is null.
      Returns:
      this for chaining

    • noMatchSize

      public java.lang.Integer noMatchSize()
      Returns:
      the value set by noMatchSize(Integer)

    • phraseLimit

      public HB phraseLimit​(java.lang.Integer phraseLimit)
      Sets the maximum number of phrases the fvh will consider if the field doesn't also define phraseLimit.
      Parameters:
      phraseLimit - maximum number of phrases the fvh will consider
      Returns:
      this for chaining

    • phraseLimit

      public java.lang.Integer phraseLimit()
      Returns:
      the value set by phraseLimit(Integer)

    • forceSource

      public HB forceSource​(java.lang.Boolean forceSource)
      Forces the highlighting to highlight fields based on the source even if fields are stored separately.

    • forceSource

      public java.lang.Boolean forceSource()
      Returns:
      the value set by forceSource(Boolean)

    • toXContent

      public org.elasticsearch.common.xcontent.XContentBuilder toXContent​(org.elasticsearch.common.xcontent.XContentBuilder builder, org.elasticsearch.common.xcontent.ToXContent.Params params) throws java.io.IOException
      Specified by:
      toXContent in interface org.elasticsearch.common.xcontent.ToXContent
      Throws:
      java.io.IOException

    • innerXContent

      protected abstract void innerXContent​(org.elasticsearch.common.xcontent.XContentBuilder builder) throws java.io.IOException
      Throws:
      java.io.IOException

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class java.lang.Object

    • doHashCode

      protected abstract int doHashCode()
      fields only present in subclass should contribute to hashCode in the implementation

    • equals

      public final boolean equals​(java.lang.Object obj)
      Overrides:
      equals in class java.lang.Object

    • doEquals

      protected abstract boolean doEquals​(HB other)
      fields only present in subclass should be checked for equality in the implementation

    • toString

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