org.apache.lucene.analysis
Class PerFieldAnalyzerWrapper

java.lang.Object
  extended by org.apache.lucene.analysis.Analyzer
      extended by org.apache.lucene.analysis.PerFieldAnalyzerWrapper
All Implemented Interfaces:
Closeable

public final class PerFieldAnalyzerWrapper
extends Analyzer

This analyzer is used to facilitate scenarios where different fields require different analysis techniques. Use the Map argument in PerFieldAnalyzerWrapper(Analyzer, java.util.Map) to add non-default analyzers for fields.

Example usage:

   Map analyzerPerField = new HashMap();
   analyzerPerField.put("firstname", new KeywordAnalyzer());
   analyzerPerField.put("lastname", new KeywordAnalyzer());

   PerFieldAnalyzerWrapper aWrapper =
      new PerFieldAnalyzerWrapper(new StandardAnalyzer(), analyzerPerField);
 

In this example, StandardAnalyzer will be used for all fields except "firstname" and "lastname", for which KeywordAnalyzer will be used.

A PerFieldAnalyzerWrapper can be used like any other analyzer, for both indexing and query parsing.


Constructor Summary
PerFieldAnalyzerWrapper(Analyzer defaultAnalyzer)
          Constructs with default analyzer.
PerFieldAnalyzerWrapper(Analyzer defaultAnalyzer, Map<String,Analyzer> fieldAnalyzers)
          Constructs with default analyzer and a map of analyzers to use for specific fields.
 
Method Summary
 void addAnalyzer(String fieldName, Analyzer analyzer)
          Deprecated. Changing the Analyzer for a field after instantiation prevents reusability. Analyzers for fields should be set during construction.
 int getOffsetGap(Fieldable field)
          Return the offsetGap from the analyzer assigned to field
 int getPositionIncrementGap(String fieldName)
          Return the positionIncrementGap from the analyzer assigned to fieldName
 TokenStream reusableTokenStream(String fieldName, Reader reader)
          Creates a TokenStream that is allowed to be re-used from the previous time that the same thread called this method.
 TokenStream tokenStream(String fieldName, Reader reader)
          Creates a TokenStream which tokenizes all the text in the provided Reader.
 String toString()
           
 
Methods inherited from class org.apache.lucene.analysis.Analyzer
close, getPreviousTokenStream, setPreviousTokenStream
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PerFieldAnalyzerWrapper

public PerFieldAnalyzerWrapper(Analyzer defaultAnalyzer)
Constructs with default analyzer.

Parameters:
defaultAnalyzer - Any fields not specifically defined to use a different analyzer will use the one provided here.

PerFieldAnalyzerWrapper

public PerFieldAnalyzerWrapper(Analyzer defaultAnalyzer,
                               Map<String,Analyzer> fieldAnalyzers)
Constructs with default analyzer and a map of analyzers to use for specific fields.

Parameters:
defaultAnalyzer - Any fields not specifically defined to use a different analyzer will use the one provided here.
fieldAnalyzers - a Map (String field name to the Analyzer) to be used for those fields
Method Detail

addAnalyzer

@Deprecated
public void addAnalyzer(String fieldName,
                                   Analyzer analyzer)
Deprecated. Changing the Analyzer for a field after instantiation prevents reusability. Analyzers for fields should be set during construction.

Defines an analyzer to use for the specified field.

Parameters:
fieldName - field name requiring a non-default analyzer
analyzer - non-default analyzer to use for field

tokenStream

public TokenStream tokenStream(String fieldName,
                               Reader reader)
Description copied from class: Analyzer
Creates a TokenStream which tokenizes all the text in the provided Reader. Must be able to handle null field name for backward compatibility.

Specified by:
tokenStream in class Analyzer

reusableTokenStream

public TokenStream reusableTokenStream(String fieldName,
                                       Reader reader)
                                throws IOException
Description copied from class: Analyzer
Creates a TokenStream that is allowed to be re-used from the previous time that the same thread called this method. Callers that do not need to use more than one TokenStream at the same time from this analyzer should use this method for better performance.

Overrides:
reusableTokenStream in class Analyzer
Throws:
IOException

getPositionIncrementGap

public int getPositionIncrementGap(String fieldName)
Return the positionIncrementGap from the analyzer assigned to fieldName

Overrides:
getPositionIncrementGap in class Analyzer
Parameters:
fieldName - Fieldable name being indexed.
Returns:
position increment gap, added to the next token emitted from Analyzer.tokenStream(String,Reader)

getOffsetGap

public int getOffsetGap(Fieldable field)
Return the offsetGap from the analyzer assigned to field

Overrides:
getOffsetGap in class Analyzer
Parameters:
field - the field just indexed
Returns:
offset gap, added to the next token emitted from Analyzer.tokenStream(String,Reader)

toString

public String toString()
Overrides:
toString in class Object