ej.eclasspath.httpclient

Class FixedLengthInputStream

java.lang.Object

java.io.InputStream

ej.eclasspath.httpclient.FixedLengthInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class FixedLengthInputStream
extends java.io.InputStream

A FixedLengthInputStream provides a stream for reading a body of a http message that has a Content-Length header.

This class is a decorator: it wraps the input stream of the connection, reads from it, and adds the length check. Closing this stream closes the underlying stream.

The stream ends after Content-Length bytes, even if the server sends more bytes. If the underlying stream ends before Content-Length bytes, for example because the connection closed too early, the read throws an IOException instead of returning the end of the stream.

Constructor Summary

Constructors

Constructor and Description
FixedLengthInputStream(java.io.InputStream in, long length) Creates a stream that reads a body of the given length from the given stream.

Method Summary

Modifier and Type	Method and Description
int	available()
void	close()
int	read()
int	read(byte[] b, int off, int len)
long	skip(long n)

Methods inherited from class java.io.InputStream

mark, markSupported, read, reset

Methods inherited from class java.lang.Object

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

Constructor Detail

FixedLengthInputStream

public FixedLengthInputStream(java.io.InputStream in,
                              long length)

Creates a stream that reads a body of the given length from the given stream.

Parameters:

in - the underlying stream, positioned at the start of the body

length - the value of the Content-Length header

Method Detail

read

public int read()
         throws java.io.IOException

Specified by:

read in class java.io.InputStream

Throws:

java.io.IOException

read

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

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

skip

public long skip(long n)
          throws java.io.IOException

Overrides:

skip in class java.io.InputStream

Throws:

java.io.IOException

available

public int available()
              throws java.io.IOException

Overrides:

available in class java.io.InputStream

Throws:

java.io.IOException

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class java.io.InputStream

Throws:

java.io.IOException