LUCENE-8778: Add a migration note to MIGRATE.txt

This commit is contained in:
Tomoko Uchida 2019-08-04 23:52:45 +09:00
parent b6c26f6c16
commit 09993c6cf0
1 changed files with 15 additions and 0 deletions

View File

@ -1,5 +1,20 @@
# Apache Lucene Migration Guide
## Analysis factories now have customizable symbolic names (LUCENE-8778) ##
The SPI names for concrete subclasses of TokenizerFactory, TokenFilterFactory, and CharfilterFactory are no longer
derived from their class name. Instead, each factory must have a static "NAME" field like this:
/** o.a.l.a.standard.StandardTokenizerFactory's SPI name */
public static final String NAME = "standard";
A factory can be resolved/instantiated with its NAME by using methods such as TokenizerFactory#lookupClass(String)
or TokenizerFactory#forName(String, Map<String,String>).
If there are any user-defined factory classes that don't have proper NAME field, an exception will be thrown
when (re)loading factories. e.g., when calling TokenizerFactory#reloadTokenizers(ClassLoader).
## TermsEnum is now fully abstract (LUCENE-8292) ##
TermsEnum has been changed to be fully abstract, so non-abstract subclass must implement all it's methods.