public class TaggedInputStream extends ProxyInputStream
TaggedIOException
class to wrap all thrown
IOException
s. 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(Exception)
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 }
TaggedIOException
in
Constructor and Description |
---|
TaggedInputStream(InputStream proxy)
Creates a tagging decorator for the given input stream.
|
Modifier and Type | Method and Description |
---|---|
static TaggedInputStream |
get(InputStream proxy)
Casts or wraps the given stream to a TaggedInputStream instance.
|
protected void |
handleIOException(IOException e)
Tags any IOExceptions thrown, wrapping and re-throwing.
|
boolean |
isCauseOf(IOException exception)
Tests if the given exception was caused by this stream.
|
void |
throwIfCauseOf(Exception exception)
Re-throws the original exception thrown by this stream.
|
String |
toString() |
afterRead, available, beforeRead, close, mark, markSupported, read, read, read, reset, skip
public TaggedInputStream(InputStream proxy)
proxy
- input stream to be decoratedpublic static TaggedInputStream get(InputStream proxy)
stream
- normal input streampublic boolean isCauseOf(IOException exception)
exception
- an exceptiontrue
if the exception was thrown by this stream,
false
otherwisepublic void throwIfCauseOf(Exception exception) throws IOException
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.exception
- an exceptionIOException
- original exception, if any, thrown by this streamprotected void handleIOException(IOException e) throws IOException
handleIOException
in class ProxyInputStream
e
- The IOException thrownIOException
- if an I/O error occursCopyright © 2007-2015 The Apache Software Foundation. All Rights Reserved.