Package org.apache.lucene.search.vectorhighlight

Interface FragmentsBuilder

All Known Implementing Classes:

BaseFragmentsBuilder, ScoreOrderFragmentsBuilder, SimpleFragmentsBuilder

public interface FragmentsBuilder

FragmentsBuilder is an interface for fragments (snippets) builder classes. A FragmentsBuilder class can be plugged in to FastVectorHighlighter.

Method Summary

Modifier and Type	Method	Description
java.lang.String	createFragment(IndexReader reader, int docId, java.lang.String fieldName, FieldFragList fieldFragList)	create a fragment.
java.lang.String	createFragment(IndexReader reader, int docId, java.lang.String fieldName, FieldFragList fieldFragList, java.lang.String[] preTags, java.lang.String[] postTags, Encoder encoder)	create a fragment.
java.lang.String[]	createFragments(IndexReader reader, int docId, java.lang.String fieldName, FieldFragList fieldFragList, int maxNumFragments)	create multiple fragments.
java.lang.String[]	createFragments(IndexReader reader, int docId, java.lang.String fieldName, FieldFragList fieldFragList, int maxNumFragments, java.lang.String[] preTags, java.lang.String[] postTags, Encoder encoder)	create multiple fragments.

Method Detail

createFragment

java.lang.String createFragment(IndexReader reader,
                                int docId,
                                java.lang.String fieldName,
                                FieldFragList fieldFragList)
                         throws java.io.IOException

create a fragment.

Parameters:

reader - IndexReader of the index

docId - document id to be highlighted

fieldName - field of the document to be highlighted

fieldFragList - FieldFragList object

Returns:

a created fragment or null when no fragment created

Throws:

java.io.IOException - If there is a low-level I/O error

createFragments

java.lang.String[] createFragments(IndexReader reader,
                                   int docId,
                                   java.lang.String fieldName,
                                   FieldFragList fieldFragList,
                                   int maxNumFragments)
                            throws java.io.IOException

create multiple fragments.

Parameters:

reader - IndexReader of the index

docId - document id to be highlighter

fieldName - field of the document to be highlighted

fieldFragList - FieldFragList object

maxNumFragments - maximum number of fragments

Returns:

created fragments or null when no fragments created. size of the array can be less than maxNumFragments

Throws:

java.io.IOException - If there is a low-level I/O error

createFragment

java.lang.String createFragment(IndexReader reader,
                                int docId,
                                java.lang.String fieldName,
                                FieldFragList fieldFragList,
                                java.lang.String[] preTags,
                                java.lang.String[] postTags,
                                Encoder encoder)
                         throws java.io.IOException

create a fragment.

Parameters:

reader - IndexReader of the index

docId - document id to be highlighted

fieldName - field of the document to be highlighted

fieldFragList - FieldFragList object

preTags - pre-tags to be used to highlight terms

postTags - post-tags to be used to highlight terms

encoder - an encoder that generates encoded text

Returns:

a created fragment or null when no fragment created

Throws:

java.io.IOException - If there is a low-level I/O error

createFragments

java.lang.String[] createFragments(IndexReader reader,
                                   int docId,
                                   java.lang.String fieldName,
                                   FieldFragList fieldFragList,
                                   int maxNumFragments,
                                   java.lang.String[] preTags,
                                   java.lang.String[] postTags,
                                   Encoder encoder)
                            throws java.io.IOException

create multiple fragments.

Parameters:

reader - IndexReader of the index

docId - document id to be highlighter

fieldName - field of the document to be highlighted

fieldFragList - FieldFragList object

maxNumFragments - maximum number of fragments

preTags - pre-tags to be used to highlight terms

postTags - post-tags to be used to highlight terms

encoder - an encoder that generates encoded text

Returns:

created fragments or null when no fragments created. size of the array can be less than maxNumFragments

Throws:

java.io.IOException - If there is a low-level I/O error