com.atlassian.confluence.search.summary
Class HitHighlighter

java.lang.Object
  extended by 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.



Copyright © 2003-2008 Atlassian Pty Ltd. All Rights Reserved.