org.apache.lucene.search

Class MultiCollector

java.lang.Object

org.apache.lucene.search.MultiCollector

All Implemented Interfaces:

Collector

public class MultiCollector
extends java.lang.Object
implements Collector

A Collector which allows running a search with several Collectors. It offers a static wrap(org.apache.lucene.search.Collector...) method which accepts a list of collectors and wraps them with MultiCollector, while filtering out the null null ones.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	MultiCollector.MultiLeafCollector

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	cacheScores
private Collector[]	collectors

Constructor Summary

Constructors

Modifier	Constructor and Description
private	MultiCollector(Collector... collectors)

Method Summary

Modifier and Type	Method and Description
LeafCollector	getLeafCollector(LeafReaderContext context) Create a new collector to collect the given context.
boolean	needsScores() Indicates if document scores are needed by this collector.
static Collector	wrap(Collector... collectors) See wrap(Iterable).
static Collector	wrap(java.lang.Iterable<? extends Collector> collectors) Wraps a list of Collectors with a MultiCollector.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

cacheScores

private final boolean cacheScores

collectors

private final Collector[] collectors

Constructor Detail

MultiCollector

private MultiCollector(Collector... collectors)

Method Detail

wrap

public static Collector wrap(Collector... collectors)

See wrap(Iterable).

wrap

public static Collector wrap(java.lang.Iterable<? extends Collector> collectors)

Wraps a list of Collectors with a MultiCollector. This method works as follows:

• Filters out the null collectors, so they are not used during search time.
• If the input contains 1 real collector (i.e. non-null ), it is returned.
• Otherwise the method returns a MultiCollector which wraps the non-null ones.

Throws:

java.lang.IllegalArgumentException - if either 0 collectors were input, or all collectors are null.

needsScores

public boolean needsScores()

Description copied from interface: Collector

Indicates if document scores are needed by this collector.

Specified by:

needsScores in interface Collector

Returns:

true if scores are needed.

getLeafCollector

public LeafCollector getLeafCollector(LeafReaderContext context)
                               throws java.io.IOException

Description copied from interface: Collector

Create a new collector to collect the given context.

Specified by:

getLeafCollector in interface Collector

Parameters:

context - next atomic reader context

Throws:

java.io.IOException