Package org.apache.lucene.search.postingshighlight

Class DefaultPassageFormatter

java.lang.Object

org.apache.lucene.search.postingshighlight.PassageFormatter

org.apache.lucene.search.postingshighlight.DefaultPassageFormatter

public class DefaultPassageFormatter
extends PassageFormatter

Creates a formatted snippet from the top passages.

The default implementation marks the query terms as bold, and places ellipses between unconnected passages.

Constructor Summary

Constructors

Constructor	Description
DefaultPassageFormatter()	Creates a new DefaultPassageFormatter with the default tags.
DefaultPassageFormatter(String preTag, String postTag, String ellipsis, boolean escape)	Creates a new DefaultPassageFormatter with custom tags.

Method Summary

Modifier and Type	Method	Description
String	format(Passage[] passages, String content)	Formats the top passages from content into a human-readable text snippet.

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultPassageFormatter

public DefaultPassageFormatter()

Creates a new DefaultPassageFormatter with the default tags.

DefaultPassageFormatter

public DefaultPassageFormatter(String preTag,
 String postTag,
 String ellipsis,
 boolean escape)

Creates a new DefaultPassageFormatter with custom tags.

Parameters:

preTag - text which should appear before a highlighted term.

postTag - text which should appear after a highlighted term.

ellipsis - text which should be used to connect two unconnected passages.

escape - true if text should be html-escaped

Method Details

format

public String format(Passage[] passages,
 String content)

Description copied from class: PassageFormatter

Formats the top passages from content into a human-readable text snippet.

Specified by:

format in class PassageFormatter

Parameters:

passages - top-N passages for the field. Note these are sorted in the order that they appear in the document for convenience.

content - content for the field.

Returns:

formatted highlight. Note that for the non-expert APIs in PostingsHighlighter that return String, the toString method on the Object returned by this method is used to compute the string.