com.ptteng.course.util.aliPayUtil.apacheCommonUtil.httpclient

类 ContentLengthInputStream

java.lang.Object

java.io.InputStream

com.ptteng.course.util.aliPayUtil.apacheCommonUtil.httpclient.ContentLengthInputStream

所有已实现的接口:

Closeable, AutoCloseable

public class ContentLengthInputStream
extends InputStream

Cuts the wrapped InputStream off after a specified number of bytes.

Implementation note: Choices abound. One approach would pass through the InputStream.mark(int) and InputStream.reset() calls to the underlying stream. That's tricky, though, because you then have to start duplicating the work of keeping track of how much a reset rewinds. Further, you have to watch out for the "readLimit", and since the semantics for the readLimit leave room for differing implementations, you might get into a lot of trouble.

Alternatively, you could make this class extend BufferedInputStream and then use the protected members of that class to avoid duplicated effort. That solution has the side effect of adding yet another possible layer of buffering.

Then, there is the simple choice, which this takes - simply don't support InputStream.mark(int) and InputStream.reset(). That choice has the added benefit of keeping this class very simple.

从以下版本开始:

2.0

作者:

Ortwin Glueck, Eric Johnson, Mike Bowler

构造器概要

构造器

构造器和说明
ContentLengthInputStream(InputStream in, int contentLength) 已过时。 use ContentLengthInputStream(InputStream, long) Creates a new length limited stream
ContentLengthInputStream(InputStream in, long contentLength) Creates a new length limited stream

方法概要

限定符和类型	方法和说明
void	close() Reads until the end of the known length of content.
int	read() Read the next byte from the stream
int	read(byte[] b) Read more bytes from the stream.
int	read(byte[] b, int off, int len) Does standard InputStream.read(byte[], int, int) behavior, but also notifies the watcher when the contents have been consumed.
long	skip(long n) Skips and discards a number of bytes from the input stream.

从类继承的方法 java.io.InputStream

available, mark, markSupported, reset

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ContentLengthInputStream

public ContentLengthInputStream(InputStream in,
                                int contentLength)

已过时。 use ContentLengthInputStream(InputStream, long) Creates a new length limited stream

参数:

in - The stream to wrap

contentLength - The maximum number of bytes that can be read from the stream. Subsequent read operations will return -1.

ContentLengthInputStream

public ContentLengthInputStream(InputStream in,
                                long contentLength)

Creates a new length limited stream

参数:

in - The stream to wrap

contentLength - The maximum number of bytes that can be read from the stream. Subsequent read operations will return -1.

从以下版本开始:

3.0

方法详细资料

close

public void close()
           throws IOException

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.

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

覆盖:

close 在类中 InputStream

抛出:

IOException - If an IO problem occurs.

read

public int read()
         throws IOException

Read the next byte from the stream

指定者:

read 在类中 InputStream

返回:

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

抛出:

IOException - If an IO problem occurs

另请参阅:

InputStream.read()

read

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

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

覆盖:

read 在类中 InputStream

参数:

b - The byte array to fill.

off - Start filling at this position.

len - The number of bytes to attempt to read.

返回:

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

抛出:

IOException - Should an error occur on the wrapped stream.

read

public int read(byte[] b)
         throws IOException

Read more bytes from the stream.

覆盖:

read 在类中 InputStream

参数:

b - The byte array to put the new data in.

返回:

The number of bytes read into the buffer.

抛出:

IOException - If an IO problem occurs

另请参阅:

InputStream.read(byte[])

skip

public long skip(long n)
          throws IOException

Skips and discards a number of bytes from the input stream.

覆盖:

skip 在类中 InputStream

参数:

n - The number of bytes to skip.

返回:

The actual number of bytes skipped. <= 0 if no bytes are skipped.

抛出:

IOException - If an error occurs while skipping bytes.

另请参阅:

InputStream.skip(long)