org.apache.commons.io

类 TaggedIOException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

org.apache.commons.io.IOExceptionWithCause

org.apache.commons.io.TaggedIOException

所有已实现的接口:

Serializable

public class TaggedIOException
extends IOExceptionWithCause

An IOException decorator that adds a serializable tag to the wrapped exception. Both the tag and the original exception can be used to determine further processing when this exception is caught.

从以下版本开始:

2.0

另请参阅:

序列化表格

构造器概要

构造器

构造器和说明
TaggedIOException(IOException original, Serializable tag) Creates a tagged wrapper for the given exception.

方法概要

限定符和类型	方法和说明
IOException	getCause() Returns the wrapped exception.
Serializable	getTag() Returns the serializable tag object.
static boolean	isTaggedWith(Throwable throwable, Object tag) Checks whether the given throwable is tagged with the given tag.
static void	throwCauseIfTaggedWith(Throwable throwable, Object tag) Throws the original IOException if the given throwable is a TaggedIOException decorator the given tag.

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

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

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

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

构造器详细资料

TaggedIOException

public TaggedIOException(IOException original,
                         Serializable tag)

Creates a tagged wrapper for the given exception.

参数:

original - the exception to be tagged

tag - tag of this exception

方法详细资料

isTaggedWith

public static boolean isTaggedWith(Throwable throwable,
                                   Object tag)

Checks whether the given throwable is tagged with the given tag.

This check can only succeed if the throwable is a TaggedIOException and the tag is Serializable, but the argument types are intentionally more generic to make it easier to use this method without type casts.

A typical use for this method is in a catch block to determine how a caught exception should be handled:

 Serializable tag = ...;
 try {
     ...;
 } catch (Throwable t) {
     if (TaggedIOExcepton.isTaggedWith(t, tag)) {
         // special processing for tagged exception
     } else {
         // handling of other kinds of exceptions
     }
 }
 

参数:

throwable - The Throwable object to check

tag - tag object

返回:

true if the throwable has the specified tag, otherwise false

throwCauseIfTaggedWith

public static void throwCauseIfTaggedWith(Throwable throwable,
                                          Object tag)
                                   throws IOException

Throws the original IOException if the given throwable is a TaggedIOException decorator the given tag. Does nothing if the given throwable is of a different type or if it is tagged with some other tag.

This method is typically used in a catch block to selectively rethrow tagged exceptions.

 Serializable tag = ...;
 try {
     ...;
 } catch (Throwable t) {
     TaggedIOExcepton.throwCauseIfTagged(t, tag);
     // handle other kinds of exceptions
 }
 

参数:

throwable - an exception

tag - tag object

抛出:

IOException - original exception from the tagged decorator, if any

getTag

public Serializable getTag()

Returns the serializable tag object.

返回:

tag object

getCause

public IOException getCause()

Returns the wrapped exception. The only difference to the overridden Throwable.getCause() method is the narrower return type.

覆盖:

getCause 在类中 Throwable

返回:

wrapped exception