org.ssf4j.Exceptions Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ssf4j-api Show documentation

There is a newer version: 0.4

package org.ssf4j;

/**
 * Utility class for dealing with exceptions
 * @author robin
 *
 */
public class Exceptions {

	/**
	 * Convert the argument to a {@link RuntimeException} so it can be thrown.
	 * 
	 * If the argument is an {@link Error} then rethrow it immediately.
	 * If the argument is already a RuntimeException, return it.
	 * Finally, wrap the argument in a RuntimeException and return it.
	 * 
	 * @param t
	 * @param message
	 * @return
	 */
	public static RuntimeException runtime(Throwable t) {
		return runtime(t, null);
	}
	
	/**
	 * Convert the argument to a {@link RuntimeException} so it can be thrown.
	 * 
	 * If the argument is an {@link Error} then rethrow it immediately.
	 * If a message is supplied, wrap the argument in a RuntimeException with
	 * the message and return it.
	 * If a message is not supplied but the argument is already a RuntimeException,
	 * return it.
	 * Finally, wrap the argument in a RuntimeException and return it.
	 * 
	 * 
	 * {@code
	 * try {
	 *     // do something
	 * } catch(Throwable t) {
	 *     throw Exceptions.runtime(t, "It didn't work.");
	 * }
	 * }
	 * 
	 * 
	 * @param t
	 * @param message
	 * @return
	 */
	public static RuntimeException runtime(Throwable t, String message) {
		if(t instanceof Error)
			throw (Error) t;
		if(message != null)
			return new RuntimeException(message, t);
		if(t instanceof RuntimeException)
			return (RuntimeException) t;
		return new RuntimeException(t);
	}
}