-
- All Superinterfaces:
EventListener
public interface ReadListener extends EventListener
This class represents a call-back mechanism that will notify implementations as HTTP request data becomes available to be read without blocking.
- Since:
- Servlet 3.1
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidonAllDataRead()Invoked when all data for the current request has been read and any previous call toonDataAvailable()has returned to the container.voidonDataAvailable()When an instance of theReadListeneris registered with aServletInputStream, this method will be invoked by the container the first time when it is possible to read data.voidonError(Throwable t)Invoked when an error occurs processing the request.
-
-
-
Method Detail
-
onDataAvailable
void onDataAvailable() throws IOExceptionWhen an instance of theReadListeneris registered with aServletInputStream, this method will be invoked by the container the first time when it is possible to read data. Subsequently the container will invoke this method if and only if theServletInputStream.isReady()method has been called and has returned a value offalse, data has subsequently become available to read and any previous call to this method has returned to the container.- Throws:
IOException- if an I/O related error has occurred during processing
-
onAllDataRead
void onAllDataRead() throws IOExceptionInvoked when all data for the current request has been read and any previous call toonDataAvailable()has returned to the container.- Throws:
IOException- if an I/O related error has occurred during processing
-
onError
void onError(Throwable t)
Invoked when an error occurs processing the request.- Parameters:
t- the throwable to indicate why the read operation failed
-
-