[LUCENE-7276] Add an optional reason to the MatchNoDocsQuery

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Fix Version/s: 6.2, 7.0
• Component/s: core/search
• Labels: patch
• Lucene Fields: New, Patch Available
• Assignee: Unassigned
• Reporter: Jim Ferenczi
• Created: 09/May/16 07:45
• Updated: 28/Aug/22 14:57
• Resolved: 08/Jul/16 17:13

Description

It's sometimes difficult to debug a query that results in a MatchNoDocsQuery. The MatchNoDocsQuery is always rewritten in an empty boolean query.
This patch adds an optional reason and implements a weight in order to keep track of the reason why the query did not match any document. The reason is printed on toString and when an explanation for noMatch is asked.
For instance the query:
new MatchNoDocsQuery("Field not found").toString()
=> 'MatchNoDocsQuery["field 'title' not found"]'