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)
Creates a new
Analyzer.TokenStreamComponents instance for this analyzer. |
close, getOffsetGap, getPositionIncrementGap, getReuseStrategy, getVersion, initReader, initReaderForNormalization, normalize, normalize, setVersion, tokenStream, tokenStream
public CollationKeyAnalyzer(Collator collator)
collator
- CollationKey generatorprotected AttributeFactory attributeFactory(String fieldName)
Analyzer
AttributeFactory
to be used for
analysis
and
normalization
on the given
FieldName
. The default implementation returns
TokenStream.DEFAULT_TOKEN_ATTRIBUTE_FACTORY
.attributeFactory
in class Analyzer
protected Analyzer.TokenStreamComponents createComponents(String fieldName)
Analyzer
Analyzer.TokenStreamComponents
instance for this analyzer.createComponents
in class Analyzer
fieldName
- the name of the fields content passed to the
Analyzer.TokenStreamComponents
sink as a readerAnalyzer.TokenStreamComponents
for this analyzer.