Package org.apache.commons.io.input
Class ProxyInputStream
- java.lang.Object
-
- java.io.InputStream
-
- java.io.FilterInputStream
-
- org.apache.commons.io.input.ProxyInputStream
-
- All Implemented Interfaces:
java.io.Closeable
,java.lang.AutoCloseable
- Direct Known Subclasses:
AutoCloseInputStream
,BOMInputStream
,BoundedInputStream
,CloseShieldInputStream
,CountingInputStream
,MarkShieldInputStream
,ObservableInputStream
,SwappedDataInputStream
,TaggedInputStream
,TeeInputStream
public abstract class ProxyInputStream extends java.io.FilterInputStream
A proxy stream which acts as aFilterInputStream
, by passing all method calls on to the proxied stream, not changing which methods are called.It is an alternative base class to
FilterInputStream
to increase reusability, becauseFilterInputStream
changes the methods being called, such as read(byte[]) to read(byte[], int, int).In addition, this class allows you to:
- notify a subclass that n bytes are about to be read through
beforeRead(int)
- notify a subclass that n bytes were read through
afterRead(int)
- notify a subclass that an exception was caught through
handleIOException(IOException)
unwrap()
itself
This class does not add any state (no additional instance variables).
-
-
Constructor Summary
Constructors Constructor Description ProxyInputStream(java.io.InputStream proxy)
Constructs a new ProxyInputStream.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
available()
Invokes the delegate'savailable()
method.void
close()
Invokes the delegate'sclose()
method.void
mark(int readLimit)
Invokes the delegate'smark(int)
method.boolean
markSupported()
Invokes the delegate'smarkSupported()
method.int
read()
Invokes the delegate'sread()
method.int
read(byte[] b)
Invokes the delegate'sread(byte[])
method.int
read(byte[] b, int off, int len)
Invokes the delegate'sread(byte[], int, int)
method.void
reset()
Invokes the delegate'sreset()
method.long
skip(long n)
Invokes the delegate'sskip(long)
method.java.io.InputStream
unwrap()
Unwraps this instance by returning the underlying InputStream.
-
-
-
Method Detail
-
available
public int available() throws java.io.IOException
Invokes the delegate'savailable()
method.- Overrides:
available
in classjava.io.FilterInputStream
- Returns:
- the number of available bytes
- Throws:
java.io.IOException
- if an I/O error occurs.
-
close
public void close() throws java.io.IOException
Invokes the delegate'sclose()
method.- Specified by:
close
in interfacejava.lang.AutoCloseable
- Specified by:
close
in interfacejava.io.Closeable
- Overrides:
close
in classjava.io.FilterInputStream
- Throws:
java.io.IOException
- if an I/O error occurs.
-
mark
public void mark(int readLimit)
Invokes the delegate'smark(int)
method.- Overrides:
mark
in classjava.io.FilterInputStream
- Parameters:
readLimit
- read ahead limit
-
markSupported
public boolean markSupported()
Invokes the delegate'smarkSupported()
method.- Overrides:
markSupported
in classjava.io.FilterInputStream
- Returns:
- true if mark is supported, otherwise false
-
read
public int read() throws java.io.IOException
Invokes the delegate'sread()
method.- Overrides:
read
in classjava.io.FilterInputStream
- Returns:
- the byte read or -1 if the end of stream
- Throws:
java.io.IOException
- if an I/O error occurs.
-
read
public int read(byte[] b) throws java.io.IOException
Invokes the delegate'sread(byte[])
method.- Overrides:
read
in classjava.io.FilterInputStream
- Parameters:
b
- the buffer to read the bytes into- Returns:
- the number of bytes read or EOF if the end of stream
- Throws:
java.io.IOException
- if an I/O error occurs.
-
read
public int read(byte[] b, int off, int len) throws java.io.IOException
Invokes the delegate'sread(byte[], int, int)
method.- Overrides:
read
in classjava.io.FilterInputStream
- Parameters:
b
- the buffer to read the bytes intooff
- The start offsetlen
- The number of bytes to read- Returns:
- the number of bytes read or -1 if the end of stream
- Throws:
java.io.IOException
- if an I/O error occurs.
-
reset
public void reset() throws java.io.IOException
Invokes the delegate'sreset()
method.- Overrides:
reset
in classjava.io.FilterInputStream
- Throws:
java.io.IOException
- if an I/O error occurs.
-
skip
public long skip(long n) throws java.io.IOException
Invokes the delegate'sskip(long)
method.- Overrides:
skip
in classjava.io.FilterInputStream
- Parameters:
n
- the number of bytes to skip- Returns:
- the actual number of bytes skipped
- Throws:
java.io.IOException
- if an I/O error occurs.
-
unwrap
public java.io.InputStream unwrap()
Unwraps this instance by returning the underlying InputStream.Use with caution; useful to query the underlying InputStream.
- Returns:
- the underlying InputStream.
- Since:
- 2.16.0
-
-