Collector
主要用于从搜索中收集原始结果,并实现排序或自定义结果过滤、排序等。Lucene的核心收集器都是从Collector派生的。
收集器将score从收集的文档中分离出来,如果不需要则跳过分数计算。需要分数的收集器需要实现setScorer方法,保持传递的Scorer实例,在collect方法中调用Scorer.score()方法计算当前命中结果的分数。如果收集器需要多次获取一个命中结果的分数,建议使用ScoreCachingWrappingScorer。
传递给collect方法的doc时相对与当前reader的,如果想要解析为实际的docID,需要加上当前reader的基数docBase,即docID=docBase+doc。
CachingCollector
从搜索中缓存所有文档,还可以缓存分数,然后可以将它们重放给其他的收集器。TopDocsCollector
一个抽象基类,在收集完成后,根据一些条件收集前N个结果。TopScoreDocCollector
TopDocsCollector的子类,根据score和docID排序,在IndexSearcher的search方法内部使用,不需要显示指定,是最常用的收集器。TopFieldCollector
TopDocsCollector的子类,根据指定的排序对象排序,在IndexSearcher的search方法内部使用,需要显示指定。TimeLimitingCollector
包装其他的收集器,当查询超过指定时间时会中止搜索。PositiveScoresOnlyCollector
包装其他的收集器,只收集score大于0的结果。在其setScorer(Scorer scorer)方法中,为了防止其包装的收集器会再次调用scorer.score()方法,使用ScoreCachingWrappingScorer包装了scorer。TotalHitCountCollector
只计算总命中数。MultiCollector
使多个收集器与搜索一起运行。常用于分组查询。wrap(Collector... collectors):使用MultiCollector包装一组收集器,首先会过滤空元素null,如果过滤后收集器数量为0,则抛出IllegalArgumentException异常,如果过滤后收集器数量为1,则直接返回该收集器,否则返回一个包含多个收集器的MultiCollector。
acceptsDocsOutOfOrder():只要MultiCollector中有一个收集器不允许无序就返回false。