public interface

ContentInputBuffer

org.apache.http.nio.util.ContentInputBuffer
Known Indirect Subclasses

Class Overview

Buffer for storing content streamed out from a ContentDecoder.

Summary

Public Methods
abstract int consumeContent(ContentDecoder decoder)
Reads content from the given ContentDecoder and stores it in this buffer.
abstract int read()
Reads one byte from this buffer.
abstract int read(byte[] b, int off, int len)
Reads up to len bytes of data from this buffer into an array of bytes.
abstract void reset()
Resets the buffer by clearing its state and stored content.

Public Methods

public abstract int consumeContent (ContentDecoder decoder)

Reads content from the given ContentDecoder and stores it in this buffer.

Parameters
decoder the content decoder.
Returns
  • number of bytes read.
Throws
IOException in case of an I/O error.

public abstract int read ()

Reads one byte from this buffer. If the buffer is empty this method can throw a runtime exception. The exact type of runtime exception thrown by this method depends on implementation. This method returns -1 if the end of content stream has been reached.

Returns
  • one byte
Throws
IOException

public abstract int read (byte[] b, int off, int len)

Reads up to len bytes of data from this buffer into an array of bytes. The exact number of bytes read depends how many bytes are stored in the buffer.

If off is negative, or len is negative, or off+len is greater than the length of the array b, this method can throw a runtime exception. The exact type of runtime exception thrown by this method depends on implementation. This method returns -1 if the end of content stream has been reached.

Parameters
b the buffer into which the data is read.
off the start offset in array b at which the data is written.
len the maximum number of bytes to read.
Returns
  • the total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached.
Throws
IOException if an I/O error occurs.

public abstract void reset ()

Resets the buffer by clearing its state and stored content.