com.gc.iotools.stream.is

Class SizeLimitInputStream

java.lang.Object

java.io.InputStream

com.gc.iotools.stream.is.SizeLimitInputStream

All Implemented Interfaces:

Closeable

Deprecated.

public class SizeLimitInputStream
extends InputStream

An input stream wrapper that will read only a definite number of bytes from the underlying stream. Deprecated since 1.2.15 because already included in commons-io BoundedInputStream.

Since:

1.2.0

Version:

$Id: SizeLimitInputStream.java 580 2015-04-06 21:13:34Z gcontini $

Author:

dvd.smnt

Field Summary

Fields

Modifier and Type	Field and Description
protected long	currentPosition Deprecated. The number of bytes that have been read from the in stream.
protected InputStream	in Deprecated. The underlying stream from which data are read.
protected long	markPosition Deprecated. The position in the stream when mark(int) was called.
protected long	maxSize Deprecated. The number of bytes to read at most from the in stream.

Constructor Summary

Constructors

Constructor and Description
SizeLimitInputStream(InputStream in, long maxSize) Deprecated. Create a new SizeLimitInputStream from another stream given a size limit.

Method Summary

Methods

Modifier and Type	Method and Description
int	available() Deprecated.
void	close() Deprecated. Close the underlying stream.
long	getBytesLeft() Deprecated. Get the maximum number of bytes left to read before the limit, set in the constructor, is reached.
long	getBytesRead() Deprecated. Get the number of bytes actually read from this stream.
long	getMaxSize() Deprecated. Get the number of total bytes (including bytes already read) that can be read from this stream (as set in the constructor).
void	mark(int readlimit) Deprecated.
boolean	markSupported() Deprecated.
int	read() Deprecated.
int	read(byte[] b) Deprecated.
int	read(byte[] b, int off, int len) Deprecated.
void	reset() Deprecated.
long	skip(long n) Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

currentPosition

protected long currentPosition

Deprecated.

The number of bytes that have been read from the in stream. Read methods should check to ensure that currentPosition never exceeds maxSize.

in

protected InputStream in

Deprecated.

The underlying stream from which data are read. All methods are forwarded to it, after checking that the maxSize size that hasn't been reached.

markPosition

protected long markPosition

Deprecated.

The position in the stream when mark(int) was called. It's used to reset the current position when reset() is called.

maxSize

protected final long maxSize

Deprecated.

The number of bytes to read at most from the in stream. Read methods should check to ensure that the number of bytes read never exceeds maxSize.

Constructor Detail

SizeLimitInputStream

public SizeLimitInputStream(InputStream in,
                    long maxSize)

Deprecated.

Create a new SizeLimitInputStream from another stream given a size limit.

Bytes are read from the underlying stream until size limit is reached.

Parameters:

in - The underlying input stream from where the data is read.

maxSize - the max number of bytes to allow to be read from the underlying stream.

Method Detail

available

public int available()
              throws IOException

Deprecated.

Overrides:

available in class InputStream

Throws:

IOException

close

public void close()
           throws IOException

Deprecated.

Close the underlying stream. Calling this method may make data on the underlying stream unavailable.

Specified by:

close in interface Closeable

Overrides:

close in class InputStream

Throws:

IOException

getBytesLeft

public long getBytesLeft()

Deprecated.

Get the maximum number of bytes left to read before the limit, set in the constructor, is reached.

Returns:

The number of bytes that (at a maximum) are left to be taken from this stream.

getBytesRead

public long getBytesRead()

Deprecated.

Get the number of bytes actually read from this stream.

Returns:

number of bytes that have already been taken from this stream.

getMaxSize

public long getMaxSize()

Deprecated.

Get the number of total bytes (including bytes already read) that can be read from this stream (as set in the constructor).

Returns:

Maximum bytes that can be read until the size limit runs out

mark

public void mark(int readlimit)

Deprecated.

Overrides:

mark in class InputStream

markSupported

public boolean markSupported()

Deprecated.

Overrides:

markSupported in class InputStream

read

public int read()
         throws IOException

Deprecated.

Specified by:

read in class InputStream

Throws:

IOException

read

public int read(byte[] b)
         throws IOException

Deprecated.

Overrides:

read in class InputStream

Throws:

IOException

read

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

Deprecated.

Overrides:

read in class InputStream

Throws:

IOException

reset

public void reset()
           throws IOException

Deprecated.

Overrides:

reset in class InputStream

Throws:

IOException

skip

public long skip(long n)
          throws IOException

Deprecated.

Overrides:

skip in class InputStream

Throws:

IOException