Package org.junit.internal

Class Throwables

  • public final class Throwables
extends java.lang.Object
    Miscellaneous functions dealing with Throwable.
    Since:
    4.12
    Author:
    kcooney@google.com (Kevin Cooney)

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.lang.String getStacktrace​(java.lang.Throwable exception)
      Returns the stacktrace of the given Throwable as a String.
      static java.lang.String getTrimmedStackTrace​(java.lang.Throwable exception)
      Gets a trimmed version of the stack trace of the given exception.
      static java.lang.Exception rethrowAsException​(java.lang.Throwable e)
      Rethrows the given Throwable, allowing the caller to declare that it throws Exception.

      • Methods inherited from class java.lang.Object

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

    • Method Detail

      • rethrowAsException

        public static java.lang.Exception rethrowAsException​(java.lang.Throwable e)
                                              throws java.lang.Exception
        Rethrows the given Throwable, allowing the caller to declare that it throws Exception. This is useful when your callers have nothing reasonable they can do when a Throwable is thrown. This is declared to return Exception so it can be used in a throw clause: 
         try {
   doSomething();
 } catch (Throwable e} {
   throw Throwables.rethrowAsException(e);
 }
 doSomethingLater();
        Parameters:
        e - exception to rethrow
        Returns:
        does not return anything
        Throws:
        java.lang.Exception
        Since:
        4.12

      • getStacktrace

        public static java.lang.String getStacktrace​(java.lang.Throwable exception)
        Returns the stacktrace of the given Throwable as a String.
        Since:
        4.13

      • getTrimmedStackTrace

        public static java.lang.String getTrimmedStackTrace​(java.lang.Throwable exception)
        Gets a trimmed version of the stack trace of the given exception. Stack trace elements that are below the test method are filtered out.
        Returns:
        a trimmed stack trace, or the original trace if trimming wasn't possible