[LUCENE-4152] add one-syllable method to IndexReader enumerate subreaders

• Type: Bug
• Status: Closed
• Priority: Blocker
• Resolution: Fixed
• Fix Version/s: 4.0, 6.0
• Lucene Fields: New
• Assignee: Robert Muir
• Reporter: Robert Muir
• Created: 18/Jun/12 11:19
• Updated: 28/Aug/22 13:19
• Resolved: 14/Aug/12 02:18

Description

Description is exactly as written.

getSequentialSubReaders/getTopLevelReaderContext, these method names are way too long/unuseable. They also have tricky semantics (e.g. returning null).

In lucene 4, people cannot just use any indexreader and get a merged view. So we need to make this stuff easy on them:

• single-syllable method name (leaves(), subs(), i will think on this)
• supports enhanced for-loop (no returning null or anything like that)
• on indexreader (not atomic or composite, plain old indexreader)

Issue Links

• is blocked by: LUCENE-3866 Make CompositeReader.getSequentialSubReaders() and the corresponding IndexReaderContext methods return unmodifiable List<R extends IndexReader>
• is depended upon by: LUCENE-4306 Make IR.getSequentialSubReaders() protected