org.apache.commons.io.input

类 TaggedInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

org.apache.commons.io.input.ProxyInputStream

org.apache.commons.io.input.TaggedInputStream

所有已实现的接口:

Closeable, AutoCloseable

public class TaggedInputStream
extends ProxyInputStream

An input stream decorator that tags potential exceptions so that the stream that caused the exception can easily be identified. This is done by using the TaggedIOException class to wrap all thrown IOExceptions. See below for an example of using this class.

 TaggedInputStream stream = new TaggedInputStream(...);
 try {
     // Processing that may throw an IOException either from this stream
     // or from some other IO activity like temporary files, etc.
     processStream(stream);
 } catch (IOException e) {
     if (stream.isCauseOf(e)) {
         // The exception was caused by this stream.
         // Use e.getCause() to get the original exception.
     } else {
         // The exception was caused by something else.
     }
 }
 

Alternatively, the throwIfCauseOf(Throwable) method can be used to let higher levels of code handle the exception caused by this stream while other processing errors are being taken care of at this lower level.

 TaggedInputStream stream = new TaggedInputStream(...);
 try {
     processStream(stream);
 } catch (IOException e) {
     stream.throwIfCauseOf(e);
     // ... or process the exception that was caused by something else
 }
 

从以下版本开始:

2.0

另请参阅:

TaggedIOException

字段概要

从类继承的字段 java.io.FilterInputStream

in

构造器概要

构造器

构造器和说明
TaggedInputStream(InputStream proxy) Creates a tagging decorator for the given input stream.

方法概要

限定符和类型	方法和说明
protected void	handleIOException(IOException e) Tags any IOExceptions thrown, wrapping and re-throwing.
boolean	isCauseOf(Throwable exception) Tests if the given exception was caused by this stream.
void	throwIfCauseOf(Throwable throwable) Re-throws the original exception thrown by this stream.

从类继承的方法 org.apache.commons.io.input.ProxyInputStream

afterRead, available, beforeRead, close, mark, markSupported, read, read, read, reset, skip

从类继承的方法 java.lang.Object

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

构造器详细资料

TaggedInputStream

public TaggedInputStream(InputStream proxy)

Creates a tagging decorator for the given input stream.

参数:

proxy - input stream to be decorated

方法详细资料

isCauseOf

public boolean isCauseOf(Throwable exception)

Tests if the given exception was caused by this stream.

参数:

exception - an exception

返回:

true if the exception was thrown by this stream, false otherwise

throwIfCauseOf

public void throwIfCauseOf(Throwable throwable)
                    throws IOException

Re-throws the original exception thrown by this stream. This method first checks whether the given exception is a TaggedIOException wrapper created by this decorator, and then unwraps and throws the original wrapped exception. Returns normally if the exception was not thrown by this stream.

参数:

throwable - an exception

抛出:

IOException - original exception, if any, thrown by this stream

handleIOException

protected void handleIOException(IOException e)
                          throws IOException

Tags any IOExceptions thrown, wrapping and re-throwing.

覆盖:

handleIOException 在类中 ProxyInputStream

参数:

e - The IOException thrown

抛出:

IOException - if an I/O error occurs