AbstractWordsFileFilterFactory (Lucene 10.5.0 common API)
Description: declaration: package: org.apache.lucene.analysis.en, class: AbstractWordsFileFilterFactory

Package org.apache.lucene.analysis.en

# Class AbstractWordsFileFilterFactory

java.lang.Object
org.apache.lucene.analysis.AbstractAnalysisFactory
org.apache.lucene.analysis.TokenFilterFactory
org.apache.lucene.analysis.en.AbstractWordsFileFilterFactory

All Implemented Interfaces:
  `ResourceLoaderAware`

Direct Known Subclasses:
  `CommonGramsFilterFactory`, `KeepWordFilterFactory`, `StopFilterFactory`

public abstract class AbstractWordsFileFilterFactory extends TokenFilterFactory implements ResourceLoaderAware
Abstract parent class for analysis factories that accept a stopwords file as input.

Concrete implementations can leverage the following input attributes. All attributes are optional:

- `ignoreCase` defaults to `false`
- `words` should be the name of a stopwords file to parse, if not specified the factory will use the value provided by `createDefaultWords()` implementation in concrete subclass.
- `format` defines how the `words` file will be parsed, and defaults to `wordset`. If `words` is not specified, then `format` must not be specified.

The valid values for the `format` option are:

- `wordset` - This is the default format, which supports one word per line (including any intra-word whitespace) and allows whole line comments beginning with the "#" character. Blank lines are ignored. See `WordlistLoader.getLines` for details.
- `snowball` - This format allows for multiple words specified on each line, and trailing comments may be specified using the vertical line ("|"). Blank lines are ignored. See `WordlistLoader.getSnowballWordSet` for details.

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final String`
  `FORMAT_SNOWBALL`
  `static final String`
  `FORMAT_WORDSET`

  ### Fields inherited from class org.apache.lucene.analysis.AbstractAnalysisFactory

  `LUCENE_MATCH_VERSION_PARAM, luceneMatchVersion`

- ## Constructor Summary

  Constructors
  Modifier
  Constructor
  Description
  `protected`
  `AbstractWordsFileFilterFactory()`
  Default ctor for compatibility with SPI
  ``
  `AbstractWordsFileFilterFactory(Map<String,String> args)`
  Initialize this factory via a set of key-value pairs.

- ## Method Summary

  Modifier and Type
  Method
  Description
  `protected abstract CharArraySet`
  `createDefaultWords()`
  Default word set implementation.
  `String`
  `getFormat()`
  `String`
  `getWordFiles()`
  `CharArraySet`
  `getWords()`
  `void`
  `inform(ResourceLoader loader)`
  Initialize the set of stopwords provided via ResourceLoader, or using defaults.
  `boolean`
  `isIgnoreCase()`

  ### Methods inherited from class org.apache.lucene.analysis.TokenFilterFactory

  `availableTokenFilters, create, findSPIName, forName, lookupClass, normalize, reloadTokenFilters`

  ### Methods inherited from class org.apache.lucene.analysis.AbstractAnalysisFactory

  `defaultCtorException, get, get, get, get, get, getBoolean, getChar, getClassArg, getFloat, getInt, getLines, getLuceneMatchVersion, getOriginalArgs, getPattern, getSet, getSnowballWordSet, getWordSet, isExplicitLuceneMatchVersion, require, require, require, requireBoolean, requireChar, requireFloat, requireInt, setExplicitLuceneMatchVersion, splitAt, splitFileNames`

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### FORMAT_WORDSET

    public static final String FORMAT_WORDSET
    See Also:
      - Constant Field Values

  - ### FORMAT_SNOWBALL

    public static final String FORMAT_SNOWBALL
    See Also:
      - Constant Field Values

- ## Constructor Details

  - ### AbstractWordsFileFilterFactory

    protected AbstractWordsFileFilterFactory()
    Default ctor for compatibility with SPI

  - ### AbstractWordsFileFilterFactory

    public AbstractWordsFileFilterFactory(Map<String,String> args)
    Initialize this factory via a set of key-value pairs.

- ## Method Details

  - ### inform

    public void inform(ResourceLoader loader) throws IOException
    Initialize the set of stopwords provided via ResourceLoader, or using defaults.
    Specified by:
      `inform` in interface `ResourceLoaderAware`
    Throws:
      `IOException`

  - ### createDefaultWords

    protected abstract CharArraySet createDefaultWords()
    Default word set implementation.

  - ### getWords

    public CharArraySet getWords()

  - ### getWordFiles

    public String getWordFiles()

  - ### getFormat

    public String getFormat()

  - ### isIgnoreCase

    public boolean isIgnoreCase()