com.atlassian.confluence.search.summary
Class HitHighlighter

java.lang.Object
  com.atlassian.confluence.search.summary.HitHighlighter

@NotThreadSafe
public class HitHighlighter
extends java.lang.Object

Finds search hits in content based on a given Lucene query. Highlights those hits with a formatter. This class is not thread safe.

Constructor Summary

HitHighlighter(org.apache.lucene.search.Query query, org.apache.lucene.analysis.Analyzer analyzer)
Create a new highlighter that uses the default formatter, and HTML encoding.

HitHighlighter(org.apache.lucene.search.Query query, org.apache.lucene.analysis.Analyzer analyzer, org.apache.lucene.search.highlight.Formatter formatter)
Create a new highlighter with specified formatter with HTML encoding.

HitHighlighter(org.apache.lucene.search.Query query, org.apache.lucene.analysis.Analyzer analyzer, org.apache.lucene.search.highlight.Formatter formatter, org.apache.lucene.search.highlight.Encoder encoder)
Create a new highlighter

Method Summary

java.lang.String	getBestFragments(java.lang.String text) Use the Lucene Highlighter directly.
java.lang.String	getSummary(java.lang.String text) Get a summary, suitable for displaying excerpts of search results.
java.lang.String	highlightText(java.lang.String text) Highlights text without fragmenting it.
java.lang.String	highlightWikiMarkup(java.lang.String markup) Highlight text without fragmenting, after stripping wiki markup.
void	setFragmenter(org.apache.lucene.search.highlight.Fragmenter originalFragmenter)
void	setNoFragments()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HitHighlighter

public HitHighlighter(org.apache.lucene.search.Query query,
                      org.apache.lucene.analysis.Analyzer analyzer)

Create a new highlighter that uses the default formatter, and HTML encoding. The output format for hit highlights is: Lorem ipsum <span class="search-highlight>dolor</span> sit amet

HitHighlighter

public HitHighlighter(org.apache.lucene.search.Query query,
                      org.apache.lucene.analysis.Analyzer analyzer,
                      org.apache.lucene.search.highlight.Formatter formatter)

Create a new highlighter with specified formatter with HTML encoding.

HitHighlighter

public HitHighlighter(org.apache.lucene.search.Query query,
                      org.apache.lucene.analysis.Analyzer analyzer,
                      org.apache.lucene.search.highlight.Formatter formatter,
                      org.apache.lucene.search.highlight.Encoder encoder)

Create a new highlighter

Method Detail

setFragmenter

public void setFragmenter(org.apache.lucene.search.highlight.Fragmenter originalFragmenter)

setNoFragments

public void setNoFragments()

getSummary

public java.lang.String getSummary(java.lang.String text)

Get a summary, suitable for displaying excerpts of search results.

Returns:

a summary, or an empty string if the summary is null or empty.

highlightWikiMarkup

public java.lang.String highlightWikiMarkup(java.lang.String markup)

Highlight text without fragmenting, after stripping wiki markup.

highlightText

public java.lang.String highlightText(java.lang.String text)

Highlights text without fragmenting it.

getBestFragments

public java.lang.String getBestFragments(java.lang.String text)

Use the Lucene Highlighter directly. Text that doesn't match the query will return an empty string.