org.apache.commons.compress.utils

Class SkipShieldingInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.apache.commons.compress.utils.SkipShieldingInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class SkipShieldingInputStream
extends java.io.FilterInputStream

A wrapper that overwrites skip(long) and delegates to FilterInputStream.read() instead.

Some implementations of InputStream implement InputStream.skip(long) in a way that throws an exception if the stream is not seekable - System.in is known to behave that way. For such a stream it is impossible to invoke skip at all and you have to read from the stream (and discard the data read) instead. Skipping is potentially much faster than reading so we do want to invoke skip when possible. We provide this class so you can wrap your own InputStream in it if you encounter problems with skip throwing an exception.

Since:

1.17

Constructor Summary

Constructors

Constructor and Description
SkipShieldingInputStream(java.io.InputStream in)

Method Summary

Modifier and Type	Method and Description
long	skip(long n)

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, read, read, reset

Methods inherited from class java.lang.Object

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

Constructor Detail

SkipShieldingInputStream

public SkipShieldingInputStream(java.io.InputStream in)

Method Detail

skip

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

Overrides:

skip in class java.io.FilterInputStream

Throws:

java.io.IOException