Package org.apache.solr.client.solrj.io.stream

Class DeepRandomStream

java.lang.Object

org.apache.solr.client.solrj.io.stream.TupleStream

org.apache.solr.client.solrj.io.stream.DeepRandomStream

All Implemented Interfaces:

Closeable, Serializable, AutoCloseable, Expressible, org.apache.solr.common.MapSerializable, org.apache.solr.common.MapWriter, org.apache.solr.common.NavigableObject, org.noggit.JSONWriter.Writable

public class DeepRandomStream
extends TupleStream
implements Expressible

Connects to Zookeeper to pick replicas from a specific collection to send the query to. Under the covers the SolrStream instances send the query to the replicas. SolrStreams are opened using a thread pool, but a single thread is used to iterate and merge Tuples from each SolrStream.

Since:

5.1.0

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	DeepRandomStream.StreamOpener
protected class	DeepRandomStream.TupleWrapper

Nested classes/interfaces inherited from class org.apache.solr.client.solrj.io.stream.TupleStream

TupleStream.IgnoreException

Nested classes/interfaces inherited from interface org.apache.solr.common.MapWriter

org.apache.solr.common.MapWriter.EntryWriter

Field Summary

Fields

Modifier and Type	Field	Description
protected String	collection
protected StreamComparator	comp
protected Map<String,Tuple>	eofTuples
protected Map<String,String>	fieldMappings
protected org.apache.solr.common.params.ModifiableSolrParams	params
protected List<TupleStream>	solrStreams
protected StreamContext	streamContext
protected Deque<DeepRandomStream.TupleWrapper>	tuples
protected String	zkHost

Fields inherited from interface org.apache.solr.common.MapWriter

EMPTY

Constructor Summary

Constructors

Constructor	Description
DeepRandomStream()
DeepRandomStream(String zkHost, String collectionName, org.apache.solr.common.params.SolrParams params)
DeepRandomStream(StreamExpression expression, StreamFactory factory)

Method Summary

Modifier and Type	Method	Description
protected Tuple	_read()
protected org.apache.solr.common.params.ModifiableSolrParams	adjustParams(org.apache.solr.common.params.ModifiableSolrParams params)
List<TupleStream>	children()
void	close()
protected void	constructStreams()
StreamComparator	getStreamSort()	Return the stream sort - ie, the order in which records are returned
void	open()
Tuple	read()
void	setFieldMappings(Map<String,String> fieldMappings)
void	setStreamContext(StreamContext context)
void	setTrace(boolean trace)
Explanation	toExplanation(StreamFactory factory)	Returns an explanation about the stream object
StreamExpression	toExpression(StreamFactory factory)

Methods inherited from class org.apache.solr.client.solrj.io.stream.TupleStream

getCost, getShards, getShards, getStreamNodeId, writeMap

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.solr.common.MapWriter

jsonStr, toMap, write

Methods inherited from interface org.apache.solr.common.NavigableObject

_forEachEntry, _forEachEntry, _forEachEntry, _get, _get, _getStr, _getStr, _size

Field Details

zkHost

protected String zkHost

collection

protected String collection

params

protected org.apache.solr.common.params.ModifiableSolrParams params

fieldMappings

protected Map<String,String> fieldMappings

comp

protected StreamComparator comp

eofTuples

protected transient Map<String,Tuple> eofTuples

solrStreams

protected transient List<TupleStream> solrStreams

tuples

protected transient Deque<DeepRandomStream.TupleWrapper> tuples

streamContext

protected transient StreamContext streamContext

Constructor Details

DeepRandomStream

public DeepRandomStream()

DeepRandomStream

public DeepRandomStream(String zkHost,
 String collectionName,
 org.apache.solr.common.params.SolrParams params)
                 throws IOException

Parameters:

zkHost - Zookeeper ensemble connection string

collectionName - Name of the collection to operate on

params - Map<String, String[]> of parameter/value pairs

Throws:

IOException - Something went wrong

DeepRandomStream

public DeepRandomStream(StreamExpression expression,
 StreamFactory factory)
                 throws IOException

Throws:

IOException

Method Details

toExpression

public StreamExpression toExpression(StreamFactory factory)
                              throws IOException

Specified by:

toExpression in interface Expressible

Throws:

IOException

toExplanation

public Explanation toExplanation(StreamFactory factory)
                          throws IOException

Description copied from interface: Expressible

Returns an explanation about the stream object

Specified by:

toExplanation in interface Expressible

Specified by:

toExplanation in class TupleStream

Parameters:

factory - Stream factory for this, contains information about the function name

Returns:

Explanation about this stream object containing explanations of any child stream objects

Throws:

IOException - throw on any error

setFieldMappings

public void setFieldMappings(Map<String,String> fieldMappings)

setTrace

public void setTrace(boolean trace)

setStreamContext

public void setStreamContext(StreamContext context)

Specified by:

setStreamContext in class TupleStream

open

public void open()
          throws IOException

Specified by:

open in class TupleStream

Throws:

IOException

children

public List<TupleStream> children()

Specified by:

children in class TupleStream

constructStreams

protected void constructStreams()
                         throws IOException

Throws:

IOException

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in class TupleStream

Throws:

IOException

getStreamSort

public StreamComparator getStreamSort()

Return the stream sort - ie, the order in which records are returned

Specified by:

getStreamSort in class TupleStream

read

public Tuple read()
           throws IOException

Specified by:

read in class TupleStream

Throws:

IOException

_read

protected Tuple _read()
               throws IOException

Throws:

IOException

adjustParams

protected org.apache.solr.common.params.ModifiableSolrParams adjustParams(org.apache.solr.common.params.ModifiableSolrParams params)