org.glassfish.grizzly

Interface InputSource

public interface InputSource

This interface defines methods to allow an InputStream or Reader to notify the developer when and how much data is ready to be read without blocking.

Since:

2.0

Method Summary

Modifier and Type	Method and Description
boolean	isFinished()
boolean	isReady()
void	notifyAvailable(ReadHandler handler) Notify the specified ReadHandler when any number of bytes or characters can be read without blocking.
void	notifyAvailable(ReadHandler handler, int size) Notify the specified ReadHandler when the number of bytes that can be read without blocking is greater or equal to the specified size.
int	readyData()

Method Detail

notifyAvailable

void notifyAvailable(ReadHandler handler)

Notify the specified ReadHandler when any number of bytes or characters can be read without blocking.

Invoking this method is equivalent to calling: notifyAvailable(handler, 1).

Parameters:

handler - the ReadHandler to notify.

Throws:

IllegalArgumentException - if handler is null.

IllegalStateException - if an attempt is made to register a handler before an existing registered handler has been invoked or if all request data has already been read.

See Also:

ReadHandler.onDataAvailable(), ReadHandler.onAllDataRead()

notifyAvailable

void notifyAvailable(ReadHandler handler,
                     int size)

Notify the specified ReadHandler when the number of bytes that can be read without blocking is greater or equal to the specified size.

Parameters:

handler - the ReadHandler to notify.

size - the least number of bytes that must be available before the ReadHandler is invoked.

Throws:

IllegalArgumentException - if handler is null, or if size is less or equal to zero.

IllegalStateException - if an attempt is made to register a handler before an existing registered handler has been invoked or if all request data has already been read.

See Also:

ReadHandler.onDataAvailable(), ReadHandler.onAllDataRead()

isFinished

boolean isFinished()

Returns:

true when all data for this particular request has been read, otherwise returns false.

readyData

int readyData()

Returns:

the number of bytes (or characters) that may be obtained without blocking. Note when dealing with characters, this method may return an estimate on the number of characters available.

isReady

boolean isReady()

Returns:

true if data can be obtained without blocking, otherwise returns false.