net.freeutils.httpserver

Class HTTPServer.LimitedInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

net.freeutils.httpserver.HTTPServer.LimitedInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

HTTPServer.ChunkedInputStream

Enclosing class:

HTTPServer

public static class HTTPServer.LimitedInputStream
extends FilterInputStream

The LimitedInputStream provides access to a limited number of consecutive bytes from the underlying InputStream, starting at its current position. If this limit is reached, it behaves as though the end of stream has been reached (although the underlying stream remains open and may contain additional data).

Field Summary

Fields

Modifier and Type	Field and Description
protected long	limit
protected boolean	prematureEndException

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

Constructors

Constructor and Description
LimitedInputStream(InputStream in, long limit, boolean prematureEndException) Constructs a LimitedInputStream with the given underlying input stream and limit.

Method Summary

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

Methods inherited from class java.io.FilterInputStream

mark, read, reset

Methods inherited from class java.lang.Object

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

Field Detail

limit

protected long limit

prematureEndException

protected boolean prematureEndException

Constructor Detail

LimitedInputStream

public LimitedInputStream(InputStream in,
                          long limit,
                          boolean prematureEndException)

Constructs a LimitedInputStream with the given underlying input stream and limit.

Parameters:

in - the underlying input stream

limit - the maximum number of bytes that may be consumed from the underlying stream before this stream ends. If zero or negative, this stream will be at its end from initialization.

prematureEndException - specifies the stream's behavior when the underlying stream end is reached before the limit is reached: if true, an exception is thrown, otherwise this stream reaches its end as well (i.e. read() returns -1)

Throws:

NullPointerException - if the given stream is null

Method Detail

read

public int read()
         throws IOException

Overrides:

read in class FilterInputStream

Throws:

IOException

read

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

Overrides:

read in class FilterInputStream

Throws:

IOException

skip

public long skip(long len)
          throws IOException

Overrides:

skip in class FilterInputStream

Throws:

IOException

available

public int available()
              throws IOException

Overrides:

available in class FilterInputStream

Throws:

IOException

markSupported

public boolean markSupported()

Overrides:

markSupported in class FilterInputStream

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class FilterInputStream