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