cl.core.util.Exceptions Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of cl-core Show documentation

Tools for the busy Java developer

The newest version!

package cl.core.util;

import java.io.IOException;
import java.io.PrintWriter;
import java.io.StringWriter;
import java.io.UncheckedIOException;
import java.io.Writer;
import java.util.Objects;

/**
 * Utilities related to exception handling.
 */
public final class Exceptions {

    private Exceptions(){}
    
    /**
     * Get a stack trace as a string.
     */
    public static String getStackTrace(Throwable e) {
        Objects.requireNonNull(e);
        Writer result = new StringWriter();
        PrintWriter printWriter = new PrintWriter(result);
        e.printStackTrace(printWriter);
        return result.toString();
    }

    /**
     * Get root cause of a throwable.  The root of a throwable which has no causes is the throwable itself.
     */
    public static Throwable getRootCause(Throwable e) {
        Objects.requireNonNull(e);
        Throwable c = e;
        Throwable cause = c;
        while((c = c.getCause()) != null) {
            cause = c;
        }
        return cause;
    }

    /**
     * Get a stack traces of a throwable's root as a string.
     */
    public static String getRootStackTrace(Throwable e) {
        Objects.requireNonNull(e);
        return getStackTrace(getRootCause(e));
    }
    
    /**
     * Wrap a checked exception into an unchecked exception.
     */
    public static RuntimeException toUnchecked(Exception e) {
        if (e instanceof RuntimeException) {
            return (RuntimeException)e;
        }
        else if (e instanceof IOException) {
            return new UncheckedIOException((IOException)e);
        }
        return new RuntimeException(e);
    }
}