Lucene4.6至 Lucene6.6的每个迭代对API的改动

由于项目需求，需要将Lucene4.6升级到Lucene6.6，因此我对这之间的所有重要的API改动做了搜集；特别重要的改变加粗显示。

 

Lucene4.7改动：

LUCENE-5405: Make ShingleAnalzyerWrapper.getWrappedAnalyzer() public final
(gsingers)

LUCENE-5395: The SpatialArgsParser now only reads WKT, no more "lat, lon" etc. but it's easy to override the parseShape method if you wish.

Lucene4.8改动：

• LUCENE-5516: MergeScheduler#merge() now accepts a MergeTrigger as well as a boolean that indicates if a new merge was found in the caller thread before the scheduler was called.
  (Simon Willnauer)
• LUCENE-5487: Separated bulk scorer (new Weight.bulkScorer method) from normal scoring (Weight.scorer) for those queries that can do bulk scoring more efficiently, e.g. BooleanQuery in some cases. This also simplified the Weight.scorer API by removing the two confusing booleans.
  
  

 

Lucene4.9改动：

• ·LUCENE-5725: MoreLikeThis#like now accepts multiple values per field. The pre-existing method has been deprecated in favor of a variable arguments for the like text.
  (Alex Ksikes via Simon Willnauer)
• ·LUCENE-5711: MergePolicy accepts an IndexWriter instance on each method rather than holding state against a single IndexWriter instance.
• ·LUCENE-5640: The Token class was deprecated. Since Lucene 2.9, TokenStreams are using Attributes, Token is no longer used.
  (Uwe Schindler, Robert Muir)
• ·LUCENE-5678: IndexOutput no longer allows seeking, so it is no longer required to use RandomAccessFile to write Indexes. Lucene now uses standard FileOutputStream wrapped with OutputStreamIndexOutput to write index data. BufferedIndexOutput was removed, because buffering and checksumming is provided by FilterOutputStreams, provided by the JDK.

 

 

Lucene5.0改动：

LUCENE-4924: DocIdSetIterator.docID() must now return -1 when the iterator is not positioned. This change affects all classes that inherit from DocIdSetIterator, including DocsEnum and DocsAndPositionsEnum.
(Adrien Grand)

LUCENE-5388: Remove Reader from Tokenizer's constructor and from Analyzer's createComponents. TokenStreams now always get their input via setReader.
(Benson Margulies via Robert Muir - pull request #16)

LUCENE-5527: The Collector API has been refactored to use a dedicated（专用的） Collector per leaf.
(Shikhar Bhushan, Adrien Grand)

LUCENE-5702: The FieldComparator API has been refactor to a per-leaf API, just like Collectors.
(Adrien Grand)

LUCENE-4246: IndexWriter.close now always closes, even if it throws an exception. The new IndexWriterConfig.setCommitOnClose (default true) determines whether close() should commit before closing.

LUCENE-5569: *AtomicReader/AtomicReaderContext have been renamed to *LeafReader/LeafReaderContext.

LUCENE-6021:FixedBitSet.nextSetBit now returns DocIdSetIterator.NO_MORE_DOCS instead of -1 when there are no more bits which are set.
(Adrien Grand)

LUCENE-6084: IndexOutput's constructor now requires a String resourceDescription so its toString is sane
(Robert Muir, Mike McCandless)

LUCENE-6121: CachingTokenFilter.reset() now propagates to its input if called before incrementToken(). You must call reset() now on this filter instead of doing it a-priori on the input(), which previously didn't work.
(David Smiley, Robert Muir)

LUCENE-6165: IndexWriter.addIndexes(IndexReader...) changed to addIndexes(CodecReader...)
(Robert Muir)

 

 

Lucene5.1改动：

LUCENE-6218, LUCENE-6220: Add Collector.needsScores() and needsScores parameter to Query.createWeight().
(Robert Muir, Adrien Grand)

LUCENE-4524, LUCENE-6246, LUCENE-6256, LUCENE-6271:

Merge DocsEnum and DocsAndPositionsEnum into a single PostingsEnum iterator. TermsEnum.docs() and TermsEnum.docsAndPositions() are replaced by TermsEnum.postings().

LUCENE-6270: Replaced TermsFilter with TermsQuery, use a QueryWrapperFilter(TermsQuery) instead.
(Adrien Grand)

LUCENE-6272: Scorer extends DocSetIdIterator rather than DocsEnum
(Alan Woodward)

LUCENE-6286: Removed IndexSearcher methods that take a Filter object. A BooleanQuery with a filter clause must be used instead.
(Adrien Grand)

LUCENE-6300: PrefixFilter, TermRangeFilter and NumericRangeFilter have been removed. Use PrefixQuery, TermRangeQuery and NumericRangeQuery instead.
(Adrien Grand)

LUCENE-6303: Replaced FilterCache with QueryCache and CachingWrapperFilter with CachingWrapperQuery.
(Adrien Grand)

 

 

Lucene5.2改动：

• LUCENE-6377: SearcherFactory#newSearcher now accepts the previous reader to simplify warming logic during opening new searchers.
  (Simon Willnauer)
• LUCENE-6410: Removed unused "reuse" parameter to Terms.iterator.
  (Robert Muir, Mike McCandless)

 

Lucene5.3改动：

• LUCENE-6552: Add MergePolicy.OneMerge.getMergeInfo and rename setInfo to setMergeInfo
  (Simon Willnauer, Mike McCandless)
• LUCENE-6583: FilteredQuery is deprecated and will be removed in 6.0. It should be replaced with a BooleanQuery which handle the query as a MUST clause and the filter as a FILTER clause.
  (Adrien Grand)
• LUCENE-6553: The postings, spans and scorer APIs no longer take an acceptDocs parameter. Live docs are now always checked on top of these APIs.
  (Adrien Grand)
• LUCENE-6643: GroupingSearch from lucene/grouping was changed to take a Query object to define groups instead of a Filter.
  (Adrien Grand)
• LUCENE-6648: All lucene/facet APIs now take Query objects where they used to take Filter objects.
  (Adrien Grand)  
• LUCENE-6531: PhraseQuery is now immutable and can be built using the PhraseQuery.Builder class.
  (Adrien Grand)
• LUCENE-6570: BooleanQuery is now immutable and can be built using the BooleanQuery.Builder class.
  (Adrien Grand)

 

Lucene5.4改动：

• LUCENE-6855: CachingWrapperQuery is deprecated and will be removed in 6.0.
  (Adrien Grand)
• LUCENE-6849: Expose IndexWriter.flush() method, to move all in-memory segments to disk without opening a near-real-time reader nor calling fsync
  (Robert Muir, Simon Willnauer, Mike McCandless)

 

Lucene5.5改动：

• LUCENE-6919: The Scorer class has been refactored to expose an iterator instead of extending DocIdSetIterator. asTwoPhaseIterator() has been renamed to twoPhaseIterator() for consistency.
  (Adrien Grand)
• LUCENE-6980: Default applyAllDeletes to true when opening near-real-time readers
  (Mike McCandless)
• LUCENE-6932: IndexInput.seek implementations now throw EOFException if you seek beyond the end of the file
  (Adrien Grand, Mike McCandless)
• LUCENE-6988: IndexableField.tokenStream() no longer throws IOException
  (Alan Woodward)

 

Lucene6.0改动：

LUCENE-6583: FilteredQuery has been removed. Instead, you can construct a BooleanQuery with one MUST clause for the query, and one FILTER clause for the filter.
(Adrien Grand)

LUCENE-6706: PayloadTermQuery and PayloadNearQuery have been removed. Instead, use PayloadScoreQuery to wrap any SpanQuery.
(Alan Woodward)

LUCENE-6947: SortField.missingValue is now protected. You can read its value using the new SortField.getMissingValue getter.
(Adrien Grand)

LUCENE-7052, LUCENE-7053: Remove custom comparators from BytesRef class and solely use natural byte[] comparator throughout codebase. This also simplifies API of BytesRefHash. It also replaces the natural comparator in ArrayUtil by Java 8's Comparator#naturalOrder().
(Mike McCandless, Uwe Schindler, Robert Muir)

LUCENE-7058: Add getters to various Query implementations
(Guillaume Smet via Alan Woodward)

LUCENE-7064: MultiPhraseQuery is now immutable and should be constructed with MultiPhraseQuery.Builder.
(Luc Vanlerberghe via Adrien Grand)

LUCENE-6952: These classes are now abstract: FilterCodecReader, FilterLeafReader, FilterCollector, FilterDirectory. And some Filter* classes in lucene-test-framework too.
(David Smiley)

SOLR-8867: FunctionValues.getRangeScorer now takes a LeafReaderContext instead of an IndexReader, and avoids matching documents without a value in the field for numeric fields.
(yonik)

 

 

Lucene6.1改动：

LUCENE-7243:Removed the LeafReaderContext parameter from QueryCachingPolicy#shouldCache.
(Adrien Grand)

 

 

Lucene6.2改动：

ScoringWrapperSpans was removed since it had no purpose or effect as of Lucene 5.5.

 

Lucene6.3改动：

修复了一些BUG无API改动！

 

Lucene6.4改动：

修复了一些BUG无API改动！

 

Lucene6.5改动：

• ·  LUCENE-7624: TermsQuery has been renamed as TermInSetQuery and moved to core.
  (Alan Woodward)
• LUCENE-7637: TermInSetQuery requires that all terms come from the same field.
  (Adrien Grand)
• LUCENE-7644: FieldComparatorSource.newComparator() and SortField.getComparator() no longer throw IOException
  (Alan Woodward)
• LUCENE-7628: Scorer.getChildren() now only returns Scorers that are positioned on the current document, and can throw an IOException. AssertingScorer checks that getChildren() is not called on an unpositioned Scorer.
  (Alan Woodward, Adrien Grand)
• LUCENE-7707: TopDocs.merge now takes a boolean option telling it when to use the incoming shard index versus when to assign the shard index itself, allowing users to merge shard responses incrementally instead of once all shard responses are present.
  (Simon Willnauer, Mike McCandless)

 

Lucene6.6改动：

修复了一些BUG无API改动！