Apache HttpCore 4.4.16 · org.apache.http.impl.io.ContentLengthInputStream

Modifier and Type	Field and Description
private static final int	BUFFER_SIZE
private boolean	closed True if the stream is closed.
private final long	contentLength The maximum number of bytes that can be read from the stream.
private SessionInputBuffer	in Wrapped input stream that all calls are delegated to.
private long	pos The current position

Access	Constructor and Description
public	ContentLengthInputStream(final SessionInputBuffer The session input buffer in, final long The maximum number of bytes that can be read from the stream. Subsequent read operations will return -1. contentLength) Wraps a session input buffer and cuts off output after a defined number of bytes.

Method Summary

Modifier and Type	Method and Description
public int	available() Overrides java.io.InputStream.available. Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking, which may be 0, or 0 when end of stream is detected.
public void	close() Overrides java.io.InputStream.close. Implements java.io.Closeable.close. Reads until the end of the known length of content.
public int	Returns: The next byte or -1 if the end of stream has been reached. read() Implements abstract java.io.InputStream.read. Read the next byte from the stream
public int	Returns: The number of bytes read, or -1 if the end of content has been reached. read(final byte[] The byte array to fill. b, final int Start filling at this position. off, final int The number of bytes to attempt to read. len) Overrides java.io.InputStream.read. Does standard `InputStream#read(byte[], int, int)` behavior, but also notifies the watcher when the contents have been consumed.
public int	Returns: The number of bytes read into the buffer. read(final byte[] The byte array to put the new data in. b) Overrides java.io.InputStream.read. Read more bytes from the stream.
public long	Returns: The actual number of bytes skipped. ≤ 0 if no bytes are skipped. skip(final long The number of bytes to skip. n) Overrides java.io.InputStream.skip. Skips and discards a number of bytes from the input stream.

Inherited from java.io.InputStream:: mark markSupported nullInputStream readAllBytes readNBytes readNBytes reset skipNBytes transferTo

BUFFER_SIZE	back to summary
private static final int BUFFER_SIZE

closed	back to summary
private boolean closed True if the stream is closed.

contentLength	back to summary
private final long contentLength The maximum number of bytes that can be read from the stream. Subsequent read operations will return -1.

in	back to summary
private SessionInputBuffer in Wrapped input stream that all calls are delegated to.

pos	back to summary
private long pos The current position

ContentLengthInputStream	back to summary
public ContentLengthInputStream(final SessionInputBuffer in, final long contentLength) Wraps a session input buffer and cuts off output after a defined number of bytes. Parameters in:SessionInputBuffer The session input buffer contentLength:long The maximum number of bytes that can be read from the stream. Subsequent read operations will return -1.

Method Detail

available back to summary

available	back to summary
public int available() throws IOException Overrides java.io.InputStream.available. Doc from java.io.InputStream.available. Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking, which may be 0, or 0 when end of stream is detected. The read might be on the same thread or another thread. A single read or skip of this many bytes will not block, but may read or skip fewer bytes. Note that while some implementations of `InputStream` will return the total number of bytes in the stream, many will not. It is never correct to use the return value of this method to allocate a buffer intended to hold all data in this stream. A subclass's implementation of this method may choose to throw an `IOException` if this input stream has been closed by invoking the `close()` method. Returns:int an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking or `0` when it reaches the end of the input stream. Annotations @Override Exceptions IOException: if an I/O error occurs.

public int available() throws IOException

Overrides java.io.InputStream.available.

Doc from java.io.InputStream.available.

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking, which may be 0, or 0 when end of stream is detected. The read might be on the same thread or another thread. A single read or skip of this many bytes will not block, but may read or skip fewer bytes.

Note that while some implementations of InputStream will return the total number of bytes in the stream, many will not. It is never correct to use the return value of this method to allocate a buffer intended to hold all data in this stream.

A subclass's implementation of this method may choose to throw an IOException if this input stream has been closed by invoking the close() method.

Returns:int

an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking or 0 when it reaches the end of the input stream.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs.

close	back to summary
public void close() throws IOException Overrides java.io.InputStream.close. Implements java.io.Closeable.close. Reads until the end of the known length of content. Does not close the underlying socket input, but instead leaves it primed to parse the next response. Annotations @Override Exceptions IOException: If an IO problem occurs.

back to summary

public void close() throws IOException

Overrides java.io.InputStream.close.

Implements java.io.Closeable.close.

Reads until the end of the known length of content.

Does not close the underlying socket input, but instead leaves it primed to parse the next response.

Annotations

@Override

Exceptions

IOException:: If an IO problem occurs.

read back to summary

read	back to summary
public int read() throws IOException Implements abstract java.io.InputStream.read. Read the next byte from the stream Returns:int The next byte or -1 if the end of stream has been reached. Annotations @Override Exceptions IOException: If an IO problem occurs See Also `java.io.InputStream#read()`

public int read() throws IOException

Implements abstract java.io.InputStream.read.

Read the next byte from the stream

Returns:int

The next byte or -1 if the end of stream has been reached.

Annotations

@Override

Exceptions

IOException:: If an IO problem occurs

See Also

java.io.InputStream#read()

read back to summary

read	back to summary
public int read(final byte[] b, final int off, final int len) throws IOException Overrides java.io.InputStream.read. Does standard `InputStream#read(byte[], int, int)` behavior, but also notifies the watcher when the contents have been consumed. Parameters b:byte[] The byte array to fill. off:int Start filling at this position. len:int The number of bytes to attempt to read. Returns:int The number of bytes read, or -1 if the end of content has been reached. Annotations @Override Exceptions IOException: Should an error occur on the wrapped stream.

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

Overrides java.io.InputStream.read.

Does standard InputStream#read(byte[], int, int) behavior, but also notifies the watcher when the contents have been consumed.

Parameters

b:byte[]: The byte array to fill.
off:int: Start filling at this position.
len:int: The number of bytes to attempt to read.

Returns:int

The number of bytes read, or -1 if the end of content has been reached.

Annotations

@Override

Exceptions

IOException:: Should an error occur on the wrapped stream.

read back to summary

read	back to summary
public int read(final byte[] b) throws IOException Overrides java.io.InputStream.read. Read more bytes from the stream. Parameters b:byte[] The byte array to put the new data in. Returns:int The number of bytes read into the buffer. Annotations @Override Exceptions IOException: If an IO problem occurs See Also `java.io.InputStream#read(byte[])`

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

Overrides java.io.InputStream.read.

public Class ContentLengthInputStream

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail