com.blacklocus.qs

Class LineReaderQuIP

java.lang.Object

com.blacklocus.qs.LineReaderQuIP

All Implemented Interfaces:

QueueItemProvider<java.lang.String>, java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<java.util.Collection<java.lang.String>>, java.util.Iterator<java.util.Collection<java.lang.String>>

public class LineReaderQuIP
extends java.lang.Object
implements QueueItemProvider<java.lang.String>, java.io.Closeable

QueueItemProvider based on lines of text from an InputStream.

Constructor Summary

Constructors

Constructor and Description
LineReaderQuIP(java.io.InputStream inputStream, java.lang.Integer limit)

Method Summary

Modifier and Type	Method and Description
void	close()
boolean	hasNext()
java.util.Iterator<java.util.Collection<java.lang.String>>	iterator() Generally returns this.
java.util.Collection<java.lang.String>	next()
void	remove() A means to delete the message because it is done or should not be processed again.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

LineReaderQuIP

public LineReaderQuIP(java.io.InputStream inputStream,
                      @Nullable
                      java.lang.Integer limit)

Parameters:

inputStream - newline-separated JSON documents

limit - (optional) maximum number of JSON documents (lines) to read. Defaults to unlimited.

Method Detail

iterator

public java.util.Iterator<java.util.Collection<java.lang.String>> iterator()

Description copied from interface: QueueItemProvider

Generally returns this. QueueItemProviders are not generally reusable/resettable since the underlying message source will often not be reversible. Mashing the two interfaces together simplifies implementations a bit, and also supports any typical Iterable usage.

Specified by:

iterator in interface QueueItemProvider<java.lang.String>

Specified by:

iterator in interface java.lang.Iterable<java.util.Collection<java.lang.String>>

hasNext

public boolean hasNext()

Specified by:

hasNext in interface QueueItemProvider<java.lang.String>

Specified by:

hasNext in interface java.util.Iterator<java.util.Collection<java.lang.String>>

Returns:

true if the reading QueueReader should continue processing messages from this provider.

next

public java.util.Collection<java.lang.String> next()

Specified by:

next in interface QueueItemProvider<java.lang.String>

Specified by:

next in interface java.util.Iterator<java.util.Collection<java.lang.String>>

Returns:

the next batch of messages, or an empty collection if none were available. Should never return null. The reading QueueReader may sleep after receiving an empty batch depending on its configuration.

remove

public void remove()

Description copied from interface: QueueItemProvider

A means to delete the message because it is done or should not be processed again. If the provider does not care or has no such notion, should not throw an exception. An exception may be thrown if the provider does recognize remove semantics, but somehow failed in executing that intention.

Specified by:

remove in interface QueueItemProvider<java.lang.String>

Specified by:

remove in interface java.util.Iterator<java.util.Collection<java.lang.String>>

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException