com.blade.kit.base

类 ThrowableKit

java.lang.Object

com.blade.kit.base.ThrowableKit

public final class ThrowableKit
extends Object

Static utility methods pertaining to instances of Throwable.

See the Guava User Guide entry on Throwables.

从以下版本开始:

1.0

作者:

Kevin Bourrillion, Ben Yu

方法概要

限定符和类型	方法和说明
static Throwable	getRootCause(Throwable throwable) Returns the innermost cause of throwable.
static String	getStackTraceAsString(Throwable throwable) Returns a string containing the result of toString(), followed by the full, recursive stack trace of throwable.
static RuntimeException	propagate(Throwable throwable) Propagates throwable as-is if it is an instance of RuntimeException or Error, or else as a last resort, wraps it in a RuntimeException then propagates.
static <X extends Throwable> void	propagateIfInstanceOf(Throwable throwable, Class<X> declaredType) Propagates throwable exactly as-is, if and only if it is an instance of declaredType.
static void	propagateIfPossible(Throwable throwable) Propagates throwable exactly as-is, if and only if it is an instance of RuntimeException or Error.
static <X extends Throwable> void	propagateIfPossible(Throwable throwable, Class<X> declaredType) Propagates throwable exactly as-is, if and only if it is an instance of RuntimeException, Error, or declaredType.
static <X1 extends Throwable,X2 extends Throwable> void	propagateIfPossible(Throwable throwable, Class<X1> declaredType1, Class<X2> declaredType2) Propagates throwable exactly as-is, if and only if it is an instance of RuntimeException, Error, declaredType1, or declaredType2.
static RuntimeException	unchecked(Throwable e)

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

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

方法详细资料

propagateIfInstanceOf

public static <X extends Throwable> void propagateIfInstanceOf(Throwable throwable,
                                                               Class<X> declaredType)
                                                        throws X extends Throwable

Propagates throwable exactly as-is, if and only if it is an instance of declaredType. Example usage:

 try {
        someMethodThatCouldThrowAnything();
 } catch (IKnowWhatToDoWithThisException e) {
        handle(e);
 } catch (Throwable t) {
        Throwables.propagateIfInstanceOf(t, IOException.class);
        Throwables.propagateIfInstanceOf(t, SQLException.class);
        throw Throwables.propagate(t);
 }
 

抛出:

X extends Throwable

propagateIfPossible

public static void propagateIfPossible(Throwable throwable)

Propagates throwable exactly as-is, if and only if it is an instance of RuntimeException or Error. Example usage:

 try {
        someMethodThatCouldThrowAnything();
 } catch (IKnowWhatToDoWithThisException e) {
        handle(e);
 } catch (Throwable t) {
        Throwables.propagateIfPossible(t);
        throw new RuntimeException("unexpected", t);
 }
 

propagateIfPossible

public static <X extends Throwable> void propagateIfPossible(Throwable throwable,
                                                             Class<X> declaredType)
                                                      throws X extends Throwable

Propagates throwable exactly as-is, if and only if it is an instance of RuntimeException, Error, or declaredType. Example usage:

 try {
        someMethodThatCouldThrowAnything();
 } catch (IKnowWhatToDoWithThisException e) {
        handle(e);
 } catch (Throwable t) {
        Throwables.propagateIfPossible(t, OtherException.class);
        throw new RuntimeException("unexpected", t);
 }
 

参数:

throwable - the Throwable to possibly propagate

declaredType - the single checked exception type declared by the calling method

抛出:

X extends Throwable

propagateIfPossible

public static <X1 extends Throwable,X2 extends Throwable> void propagateIfPossible(Throwable throwable,
                                                                                   Class<X1> declaredType1,
                                                                                   Class<X2> declaredType2)
                                                                            throws X1 extends Throwable,
                                                                                   X2 extends Throwable

Propagates throwable exactly as-is, if and only if it is an instance of RuntimeException, Error, declaredType1, or declaredType2. In the unlikely case that you have three or more declared checked exception types, you can handle them all by invoking these methods repeatedly. See usage example in propagateIfPossible(Throwable, Class).

参数:

throwable - the Throwable to possibly propagate

declaredType1 - any checked exception type declared by the calling method

declaredType2 - any other checked exception type declared by the calling method

抛出:

X1 extends Throwable

propagate

public static RuntimeException propagate(Throwable throwable)

Propagates throwable as-is if it is an instance of RuntimeException or Error, or else as a last resort, wraps it in a RuntimeException then propagates.

This method always throws an exception. The RuntimeException return type is only for client code to make Java type system happy in case a return value is required by the enclosing method. Example usage:

 T doSomething() {
        try {
                return someMethodThatCouldThrowAnything();
        } catch (IKnowWhatToDoWithThisException e) {
                return handle(e);
        } catch (Throwable t) {
                throw Throwables.propagate(t);
        }
 }
 

参数:

throwable - the Throwable to propagate

返回:

nothing will ever be returned; this return type is only for your convenience, as illustrated in the example above

getRootCause

public static Throwable getRootCause(Throwable throwable)

Returns the innermost cause of throwable. The first throwable in a chain provides context from when the error or exception was initially detected. Example usage:

 assertEquals("Unable to assign a customer id", Throwables.getRootCause(e).getMessage());
 

getStackTraceAsString

public static String getStackTraceAsString(Throwable throwable)

Returns a string containing the result of toString(), followed by the full, recursive stack trace of throwable. Note that you probably should not be parsing the resulting string; if you need programmatic access to the stack frames, you can call Throwable.getStackTrace().

unchecked

public static RuntimeException unchecked(Throwable e)