Apache HttpComponents Core HTTP/1.1 5.2.4 · org.apache.hc.core5.http.impl.io.SessionInputBufferImpl

Field Summary

Modifier and Type	Field and Description
private final byte[]	buffer
private int	bufferLen
private int	bufferPos
private CharBuffer	cbuf
private final CharsetDecoder	decoder
private final ByteArrayBuffer	lineBuffer
private final int	maxLineLen
private final BasicHttpTransportMetrics	metrics
private final int	minChunkLimit

Constructor Summary

Access	Constructor and Description
public	SessionInputBufferImpl(final BasicHttpTransportMetrics HTTP transport metrics. metrics, final int buffer size. Must be a positive number. bufferSize, final int size limit below which data chunks should be buffered in memory in order to minimize native method invocations on the underlying network socket. The optimal value of this parameter can be platform specific and defines a trade-off between performance of memory copy operations and that of native method invocation. If negative default chunk limited will be used. minChunkLimit, final int maximum line length. maxLineLen, final CharsetDecoder charDecoder to be used for decoding HTTP protocol elements. If `null` simple type cast will be used for byte to char conversion. charDecoder) Creates new instance of SessionInputBufferImpl.
public	SessionInputBufferImpl(final BasicHttpTransportMetrics metrics, final int bufferSize)
public	SessionInputBufferImpl(final int bufferSize, final int maxLineLen)
public	SessionInputBufferImpl(final int bufferSize, final CharsetDecoder decoder)
public	SessionInputBufferImpl(final int bufferSize)

Method Summary

Modifier and Type	Method and Description
private int	appendDecoded(final CharArrayBuffer charbuffer, final ByteBuffer bbuf)
public int	available() Implements org.apache.hc.core5.http.io.SessionInputBuffer.available. Returns available space in the buffer.
public int	capacity() Implements org.apache.hc.core5.http.io.SessionInputBuffer.capacity. Returns total capacity of the buffer
public void	clear()
public int	fillBuffer(final InputStream inputStream)
public HttpTransportMetrics	getMetrics() Implements org.apache.hc.core5.http.io.SessionInputBuffer.getMetrics. Returns `HttpTransportMetrics` for this session buffer.
private int	handleDecodingResult(final CoderResult result, final CharArrayBuffer charBuffer)
public boolean	hasBufferedData()
public int	length() Implements org.apache.hc.core5.http.io.SessionInputBuffer.length. Returns length data stored in the buffer
private int	Returns: HTTP line as a string lineFromLineBuffer(final CharArrayBuffer charBuffer) Reads a complete line of characters up to a line delimiter from this session buffer.
private int	lineFromReadBuffer(final CharArrayBuffer charbuffer, final int position)
public int	read(final InputStream Input stream inputStream) Implements org.apache.hc.core5.http.io.SessionInputBuffer.read. Reads the next byte of data from this session buffer.
public int	read(final byte[] the buffer into which the data is read. b, final int the start offset in array `b` at which the data is written. off, final int the maximum number of bytes to read. len, final InputStream Input stream inputStream) Implements org.apache.hc.core5.http.io.SessionInputBuffer.read. Reads up to `len` bytes of data from the session buffer into an array of bytes.
public int	read(final byte[] the buffer into which the data is read. b, final InputStream Input stream inputStream) Implements org.apache.hc.core5.http.io.SessionInputBuffer.read. Reads some number of bytes from the session buffer and stores them into the buffer array `b`.
public int	Returns: the total number of bytes read into the buffer, or `-1` is there is no more data because the end of the stream has been reached. readLine(final CharArrayBuffer the line buffer, one line of characters upon return charBuffer, final InputStream Input stream inputStream) Implements org.apache.hc.core5.http.io.SessionInputBuffer.readLine. Reads a complete line of characters up to a line delimiter from this session buffer into the given line buffer.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

buffer	back to summary
private final byte[] buffer

bufferLen	back to summary
private int bufferLen

bufferPos	back to summary
private int bufferPos

cbuf	back to summary
private CharBuffer cbuf

decoder	back to summary
private final CharsetDecoder decoder

lineBuffer	back to summary
private final ByteArrayBuffer lineBuffer

maxLineLen	back to summary
private final int maxLineLen

metrics	back to summary
private final BasicHttpTransportMetrics metrics

minChunkLimit	back to summary
private final int minChunkLimit

Constructor Detail

SessionInputBufferImpl back to summary

SessionInputBufferImpl	back to summary
public SessionInputBufferImpl(final BasicHttpTransportMetrics metrics, final int bufferSize, final int minChunkLimit, final int maxLineLen, final CharsetDecoder charDecoder) Creates new instance of SessionInputBufferImpl. Parameters metrics:BasicHttpTransportMetrics HTTP transport metrics. bufferSize:int buffer size. Must be a positive number. minChunkLimit:int size limit below which data chunks should be buffered in memory in order to minimize native method invocations on the underlying network socket. The optimal value of this parameter can be platform specific and defines a trade-off between performance of memory copy operations and that of native method invocation. If negative default chunk limited will be used. maxLineLen:int maximum line length. charDecoder:CharsetDecoder charDecoder to be used for decoding HTTP protocol elements. If `null` simple type cast will be used for byte to char conversion.

public SessionInputBufferImpl(final BasicHttpTransportMetrics metrics, final int bufferSize, final int minChunkLimit, final int maxLineLen, final CharsetDecoder charDecoder)

Creates new instance of SessionInputBufferImpl.

Parameters

metrics:BasicHttpTransportMetrics: HTTP transport metrics.
bufferSize:int: buffer size. Must be a positive number.
minChunkLimit:int: size limit below which data chunks should be buffered in memory in order to minimize native method invocations on the underlying network socket. The optimal value of this parameter can be platform specific and defines a trade-off between performance of memory copy operations and that of native method invocation. If negative default chunk limited will be used.
maxLineLen:int: maximum line length.
charDecoder:CharsetDecoder: charDecoder to be used for decoding HTTP protocol elements. If null simple type cast will be used for byte to char conversion.

SessionInputBufferImpl	back to summary
public SessionInputBufferImpl(final BasicHttpTransportMetrics metrics, final int bufferSize)

SessionInputBufferImpl	back to summary
public SessionInputBufferImpl(final int bufferSize, final int maxLineLen)

SessionInputBufferImpl	back to summary
public SessionInputBufferImpl(final int bufferSize, final CharsetDecoder decoder)

SessionInputBufferImpl	back to summary
public SessionInputBufferImpl(final int bufferSize)

Method Detail

appendDecoded	back to summary
private int appendDecoded(final CharArrayBuffer charbuffer, final ByteBuffer bbuf) throws IOException

available	back to summary
public int available() Implements org.apache.hc.core5.http.io.SessionInputBuffer.available. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.available. Returns available space in the buffer. Returns:int available space. Annotations @Override

available

back to summary

public int available()

Implements org.apache.hc.core5.http.io.SessionInputBuffer.available.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.available.

Returns available space in the buffer.

Returns:int

available space.

Annotations

@Override

capacity	back to summary
public int capacity() Implements org.apache.hc.core5.http.io.SessionInputBuffer.capacity. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.capacity. Returns total capacity of the buffer Returns:int total capacity Annotations @Override

capacity

back to summary

public int capacity()

Implements org.apache.hc.core5.http.io.SessionInputBuffer.capacity.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.capacity.

Returns total capacity of the buffer

Returns:int

total capacity

Annotations

@Override

clear	back to summary
public void clear()

fillBuffer	back to summary
public int fillBuffer(final InputStream inputStream) throws IOException

getMetrics back to summary

getMetrics	back to summary
public HttpTransportMetrics getMetrics() Implements org.apache.hc.core5.http.io.SessionInputBuffer.getMetrics. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.getMetrics. Returns `HttpTransportMetrics` for this session buffer. Returns:HttpTransportMetrics transport metrics. Annotations @Override

public HttpTransportMetrics getMetrics()

Implements org.apache.hc.core5.http.io.SessionInputBuffer.getMetrics.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.getMetrics.

Returns HttpTransportMetrics for this session buffer.

Returns:HttpTransportMetrics

transport metrics.

Annotations

@Override

handleDecodingResult	back to summary
private int handleDecodingResult(final CoderResult result, final CharArrayBuffer charBuffer) throws IOException

hasBufferedData	back to summary
public boolean hasBufferedData()

length	back to summary
public int length() Implements org.apache.hc.core5.http.io.SessionInputBuffer.length. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.length. Returns length data stored in the buffer Returns:int data length Annotations @Override

length

back to summary

public int length()

Implements org.apache.hc.core5.http.io.SessionInputBuffer.length.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.length.

Returns length data stored in the buffer

Returns:int

data length

Annotations

@Override

lineFromLineBuffer back to summary

lineFromLineBuffer	back to summary
private int lineFromLineBuffer(final CharArrayBuffer charBuffer) throws IOException Reads a complete line of characters up to a line delimiter from this session buffer. The line delimiter itself is discarded. If no char is available because the end of the stream has been reached, `null` is returned. This method blocks until input data is available, end of file is detected, or an exception is thrown. This method treats a lone LF as a valid line delimiters in addition to CR-LF required by the HTTP specification. Returns:int HTTP line as a string Exceptions IOException: if an I/O error occurs.

private int lineFromLineBuffer(final CharArrayBuffer charBuffer) throws IOException

Reads a complete line of characters up to a line delimiter from this session buffer. The line delimiter itself is discarded. If no char is available because the end of the stream has been reached, null is returned. This method blocks until input data is available, end of file is detected, or an exception is thrown.

This method treats a lone LF as a valid line delimiters in addition to CR-LF required by the HTTP specification.

Returns:int

HTTP line as a string

Exceptions

IOException:: if an I/O error occurs.

lineFromReadBuffer	back to summary
private int lineFromReadBuffer(final CharArrayBuffer charbuffer, final int position) throws IOException

read back to summary

read	back to summary
public int read(final InputStream inputStream) throws IOException Implements org.apache.hc.core5.http.io.SessionInputBuffer.read. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.read. Reads the next byte of data from this session buffer. The value byte is returned as an `int` in the range `0` to `255`. If no byte is available because the end of the stream has been reached, the value `-1` is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown. Parameters inputStream:InputStream Input stream Returns:int the next byte of data, or `-1` if the end of the stream is reached. Annotations @Override Exceptions IOException: if an I/O error occurs.

public int read(final InputStream inputStream) throws IOException

Implements org.apache.hc.core5.http.io.SessionInputBuffer.read.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.read.

Reads the next byte of data from this session buffer. The value byte is returned as an int in the range 0 to 255. If no byte is available because the end of the stream has been reached, the value -1 is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.

Parameters

inputStream:InputStream: Input stream

Returns:int

the next byte of data, or -1 if the end of the stream is reached.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

read back to summary

read	back to summary
public int read(final byte[] b, final int off, final int len, final InputStream inputStream) throws IOException Implements org.apache.hc.core5.http.io.SessionInputBuffer.read. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.read. Reads up to `len` bytes of data from the session buffer into an array of bytes. An attempt is made to read as many as `len` bytes, but a smaller number may be read, possibly zero. The number of bytes actually read is returned as an integer. This method blocks until input data is available, end of file is detected, or an exception is thrown. If `off` is negative, or `len` is negative, or `off+len` is greater than the length of the array `b`, then an `IndexOutOfBoundsException` is thrown. Parameters b:byte[] the buffer into which the data is read. off:int the start offset in array `b` at which the data is written. len:int the maximum number of bytes to read. inputStream:InputStream Input stream Returns:int 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. Annotations @Override Exceptions IOException: if an I/O error occurs.

public int read(final byte[] b, final int off, final int len, final InputStream inputStream) throws IOException

Implements org.apache.hc.core5.http.io.SessionInputBuffer.read.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.read.

Reads up to len bytes of data from the session buffer into an array of bytes. An attempt is made to read as many as len bytes, but a smaller number may be read, possibly zero. The number of bytes actually read is returned as an integer.

This method blocks until input data is available, end of file is detected, or an exception is thrown.

If off is negative, or len is negative, or off+len is greater than the length of the array b, then an IndexOutOfBoundsException is thrown.

Parameters

b:byte[]: the buffer into which the data is read.
off:int: the start offset in array b at which the data is written.
len:int: the maximum number of bytes to read.
inputStream:InputStream: Input stream

Returns:int

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.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

read back to summary

read	back to summary
public int read(final byte[] b, final InputStream inputStream) throws IOException Implements org.apache.hc.core5.http.io.SessionInputBuffer.read. Doc from org.apache.hc.core5.http.io.SessionInputBuffer.read. Reads some number of bytes from the session buffer and stores them into the buffer array `b`. The number of bytes actually read is returned as an integer. This method blocks until input data is available, end of file is detected, or an exception is thrown. Parameters b:byte[] the buffer into which the data is read. inputStream:InputStream Input stream Returns:int the total number of bytes read into the buffer, or `-1` is there is no more data because the end of the stream has been reached. Annotations @Override Exceptions IOException: if an I/O error occurs.

public int read(final byte[] b, final InputStream inputStream) throws IOException

Implements org.apache.hc.core5.http.io.SessionInputBuffer.read.

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.read.

Reads some number of bytes from the session buffer and stores them into the buffer array b. The number of bytes actually read is returned as an integer. This method blocks until input data is available, end of file is detected, or an exception is thrown.

Parameters

b:byte[]: the buffer into which the data is read.
inputStream:InputStream: Input stream

Returns:int

the total number of bytes read into the buffer, or -1 is there is no more data because the end of the stream has been reached.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

readLine back to summary

readLine	back to summary
public int readLine(final CharArrayBuffer charBuffer, final InputStream inputStream) throws IOException Implements org.apache.hc.core5.http.io.SessionInputBuffer.readLine. Reads a complete line of characters up to a line delimiter from this session buffer into the given line buffer. The number of chars actually read is returned as an integer. The line delimiter itself is discarded. If no char is available because the end of the stream has been reached, the value `-1` is returned. This method blocks until input data is available, end of file is detected, or an exception is thrown. This method treats a lone LF as a valid line delimiters in addition to CR-LF required by the HTTP specification. Parameters charBuffer:CharArrayBuffer the line buffer, one line of characters upon return inputStream:InputStream Doc from org.apache.hc.core5.http.io.SessionInputBuffer.readLine. Input stream Returns:int the total number of bytes read into the buffer, or `-1` is there is no more data because the end of the stream has been reached. Annotations @Override Exceptions IOException: if an I/O error occurs.

public int readLine(final CharArrayBuffer charBuffer, final InputStream inputStream) throws IOException

Implements org.apache.hc.core5.http.io.SessionInputBuffer.readLine.

Reads a complete line of characters up to a line delimiter from this session buffer into the given line buffer. The number of chars actually read is returned as an integer. The line delimiter itself is discarded. If no char is available because the end of the stream has been reached, the value -1 is returned. This method blocks until input data is available, end of file is detected, or an exception is thrown.

This method treats a lone LF as a valid line delimiters in addition to CR-LF required by the HTTP specification.

Parameters

charBuffer:CharArrayBuffer

the line buffer, one line of characters upon return

inputStream:InputStream

Doc from org.apache.hc.core5.http.io.SessionInputBuffer.readLine.

Input stream

Returns:int

the total number of bytes read into the buffer, or -1 is there is no more data because the end of the stream has been reached.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

public Class SessionInputBufferImpl

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail