org.michailov.async.io

Class AsyncLineSplitter

java.lang.Object

org.michailov.async.AsyncAgent

org.michailov.async.io.AsyncLineSplitter

public class AsyncLineSplitter
extends AsyncAgent

Asynchronous splitter of chars into lines.

See Also:

WhenReady, AsyncAgent, CharRingBuffer, StringRingBuffer

Constructor Summary

Constructors

Constructor and Description
AsyncLineSplitter(CharRingBuffer charRingBuffer, StringRingBuffer stringRingBuffer, LineAsyncOptions lineAsyncOptions) Constructs an AsyncLineSpliter instance over the given ring buffers.

Method Summary

Modifier and Type	Method and Description
protected void	action() "action" function that reads chars from the input char ring buffer and writes lines to the output string ring buffer.
protected boolean	done() "done" predicate that returns true when this async agent wants to quit the current async loop.
CharRingBuffer	getCharRingBuffer() Returns the attached char ring buffer from where chars will be read from.
StringRingBuffer	getStringRingBuffer() Returns the attached string ring buffer where lines will be written.
boolean	isEOF() Checks whether this line splitter has reached EOF of the input char ring buffer.
protected boolean	ready() "ready" predicate that returns true when chars can be read from the input char ring buffer and lines can be written to the output string ring buffer without blocking.

Methods inherited from class org.michailov.async.AsyncAgent

applyAsync, isIdle, setIdle, setIdleAndThrow, startApplyLoopAsync

Methods inherited from class java.lang.Object

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

Constructor Detail

AsyncLineSplitter

public AsyncLineSplitter(CharRingBuffer charRingBuffer,
                         StringRingBuffer stringRingBuffer,
                         LineAsyncOptions lineAsyncOptions)

Constructs an AsyncLineSpliter instance over the given ring buffers.

Parameters:

charRingBuffer - CharRingBuffer to read chars from.

stringRingBuffer - StringRingBuffer to write lines to.

lineAsyncOptions - LineAsyncOptions to use for all async operations.

Method Detail

getCharRingBuffer

public CharRingBuffer getCharRingBuffer()

Returns the attached char ring buffer from where chars will be read from.

Returns:

The attached char ring buffer from where chars will be read from.

getStringRingBuffer

public StringRingBuffer getStringRingBuffer()

Returns the attached string ring buffer where lines will be written.

Returns:

The attached string ring buffer where lines will be written.

isEOF

public boolean isEOF()

Checks whether this line splitter has reached EOF of the input char ring buffer.

Returns:

true iff EOF has been reached or an exception has been encountered.

ready

protected boolean ready()

"ready" predicate that returns true when chars can be read from the input char ring buffer and lines can be written to the output string ring buffer without blocking.

Overrides:

ready in class AsyncAgent

Returns:

Derived classes should override this method to return true iff it is time to execute AsyncAgent.action().

done

protected boolean done()

"done" predicate that returns true when this async agent wants to quit the current async loop.

Overrides:

done in class AsyncAgent

Returns:

Derived classes should override this method to return true iff it is time for the loop to stop.

action

protected void action()

"action" function that reads chars from the input char ring buffer and writes lines to the output string ring buffer.

Overrides:

action in class AsyncAgent