[LUCENE-2540] Document. add get(i) and addAll to make interacting with fieldables and documents easier/faster and more readable

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 3.0.2
• Fix Version/s: 4.9, 6.0
• Component/s: core/other
• Labels: dead
• Lucene Fields: New, Patch Available
• Assignee: Unassigned
• Reporter: Woody Anderson
• Created: 16/Jul/10 04:23
• Updated: 28/Aug/22 12:29

Description

Working with Document Fieldables is often a pain.
getting the ith involves chained method calls and is not very readable:

// nice
doc.getFieldable(i);

// not nice
doc.getFields().get(i);

also, when combining documents, or otherwise aggregating multiple fields into a single document,

// nice
doc.addAll(fieldables);

// note nice: less readable and more error prone
List<Fieldable> fields = ...;
for (Fieldable field : fields) {
  result.add(field);
}