## 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
`String` `createFragment(IndexReader reader, int docId, String fieldName, FieldFragList fieldFragList)` create a fragment.
`String` `createFragment(IndexReader reader, int docId, String fieldName, FieldFragList fieldFragList, String[] preTags, String[] postTags, Encoder encoder)` create a fragment.
`String[]` `createFragments(IndexReader reader, int docId, String fieldName, FieldFragList fieldFragList, int maxNumFragments)` create multiple fragments.
`String[]` `createFragments(IndexReader reader, int docId, String fieldName, FieldFragList fieldFragList, int maxNumFragments, String[] preTags, String[] postTags, Encoder encoder)` create multiple fragments.

Method Detail

### createFragment

    String createFragment(IndexReader reader,
                          int docId,
                          String fieldName,
                          FieldFragList fieldFragList)
                          throws 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:
    `IOException`

### createFragments

    String[] createFragments(IndexReader reader,
                             int docId,
                             String fieldName,
                             FieldFragList fieldFragList,
                             int maxNumFragments)
                             throws 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:
    `IOException`

### createFragment

    String createFragment(IndexReader reader,
                          int docId,
                          String fieldName,
                          FieldFragList fieldFragList,
                          String[] preTags,
                          String[] postTags,
                          Encoder encoder)
                          throws 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:
    `IOException`

### createFragments

    String[] createFragments(IndexReader reader,
                             int docId,
                             String fieldName,
                             FieldFragList fieldFragList,
                             int maxNumFragments,
                             String[] preTags,
                             String[] postTags,
                             Encoder encoder)
                             throws 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:
    `IOException`