public final class CollationKeyAnalyzer extends Analyzer
Configures KeywordTokenizer
with CollationAttributeFactory
.
Converts the token into its CollationKey
, and then
encodes the CollationKey directly to allow
it to be stored as an index term.
WARNING: Make sure you use exactly the same Collator at
index and query time -- CollationKeys are only comparable when produced by
the same Collator. Since RuleBasedCollator
s are not
independently versioned, it is unsafe to search against stored
CollationKeys unless the following are exactly the same (best practice is
to store this information with the index and check that they remain the
same at query time):
Collator.getInstance(java.util.Locale)
.
Collator.setStrength(int)
The ICUCollationKeyAnalyzer
in the analysis-icu package
uses ICU4J's Collator, which makes
its version available, thus allowing collation to be versioned
independently from the JVM. ICUCollationKeyAnalyzer is also significantly
faster and generates significantly shorter keys than CollationKeyAnalyzer.
See http://site.icu-project.org/charts/collation-icu4j-sun for key
generation timing and key length comparisons between ICU4J and
java.text.Collator over several languages.
CollationKeys generated by java.text.Collators are not compatible with those those generated by ICU Collators. Specifically, if you use CollationKeyAnalyzer to generate index terms, do not use ICUCollationKeyAnalyzer on the query side, or vice versa.
Analyzer.ReuseStrategy, Analyzer.TokenStreamComponents
GLOBAL_REUSE_STRATEGY, PER_FIELD_REUSE_STRATEGY
Constructor and Description |
---|
CollationKeyAnalyzer(Collator collator)
Create a new CollationKeyAnalyzer, using the specified collator.
|
Modifier and Type | Method and Description |
---|---|
protected AttributeFactory |
attributeFactory(String fieldName) |
protected Analyzer.TokenStreamComponents |
createComponents(String fieldName) |
close, getOffsetGap, getPositionIncrementGap, getReuseStrategy, getVersion, initReader, initReaderForNormalization, normalize, normalize, setVersion, tokenStream, tokenStream
public CollationKeyAnalyzer(Collator collator)
collator
- CollationKey generatorprotected AttributeFactory attributeFactory(String fieldName)
attributeFactory
in class Analyzer
protected Analyzer.TokenStreamComponents createComponents(String fieldName)
createComponents
in class Analyzer
Copyright © 2000-2020 Apache Software Foundation. All Rights Reserved.