org.tiogasolutions.dev.common.exceptions.ExceptionUtils Maven / Gradle / Ivy
/*
* Copyright 2012 Jacob D Parr
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.tiogasolutions.dev.common.exceptions;
import org.tiogasolutions.dev.common.ReflectUtils;
import org.tiogasolutions.dev.common.StringUtils;
import java.io.*;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import static java.lang.String.format;
public class ExceptionUtils {
private ExceptionUtils() {
}
public static Path assertIsFile(Path path) throws IOException {
assertIsFile(path.toFile());
return path;
}
public static File assertIsFile(File file) throws IOException {
assertExists(file);
if (file.isFile() == false) {
String msg = String.format("The path \"%s\" is not a file.", file.getAbsolutePath());
throw new IOException(msg);
}
return file;
}
public static Path assertIsDirectory(Path path) throws IOException {
assertIsDirectory(path.toFile());
return path;
}
public static File assertIsDirectory(File file) throws IOException {
assertExists(file);
if (file.isDirectory() == false) {
String msg = String.format("The path \"%s\" is not a directory.", file.getAbsolutePath());
throw new IOException(msg);
}
return file;
}
public static Path assertExists(Path path) throws FileNotFoundException {
assertExists(path.toFile());
return path;
}
public static File assertExists(File file) throws FileNotFoundException {
if (file.exists() == false) {
String msg = format("The path \"%s\" does not exist.", file.getAbsolutePath());
throw new FileNotFoundException(msg);
}
return file;
}
public static String assertNotZeroLength(String value, String name) {
if (value == null) {
String msg = String.format("The value \"%s\" cannot be null.", name);
throw new NullPointerException(msg);
} else if (value.isEmpty()) {
String msg = String.format("The value \"%s\" is an empty string.", name);
throw new NullPointerException(msg);
}
return value;
}
public static T assertNotNull(T value, String name) {
if (value == null) {
String msg = String.format("The value \"%s\" cannot be null.", name);
throw trimStackTrace(new NullPointerException(msg));
}
return value;
}
public static T[] assertNotEmpty(T[] value, String name) {
assertNotNull(value, name);
if (value.length == 0) {
String msg = String.format("The value \"%s\" cannot be empty.", name);
throw trimStackTrace(new NullPointerException(msg));
}
return value;
}
public static Collection assertNotEmpty(Collection value, String name) {
assertNotNull(value, name);
if (value.size() == 0) {
String msg = String.format("The value \"%s\" cannot be empty.", name);
throw trimStackTrace(new NullPointerException(msg));
}
return value;
}
public static long assertPositive(long value, String name) {
if (value <= 0) {
String msg = String.format("The value \"%s\" cannot be less than zero.", name);
throw trimStackTrace(new IllegalArgumentException(msg));
}
return value;
}
public static long assertNegative(long value, String name) {
if (value >= 0) {
String msg = String.format("The value \"%s\" cannot be greater than zero.", name);
throw trimStackTrace(new IllegalArgumentException(msg));
}
return value;
}
private static T trimStackTrace(T ex) {
List elements = new ArrayList();
Collections.addAll(elements, ex.getStackTrace());
elements.remove(0);
ex.setStackTrace(ReflectUtils.toArray(StackTraceElement.class, elements));
return ex;
}
public static String toString(Throwable e) {
StringWriter writer = new StringWriter();
e.printStackTrace(new PrintWriter(writer));
return writer.toString();
}
public static Throwable getRootCause(Throwable e) {
Throwable cause = e.getCause();
while (cause != null && cause != e) {
e = cause;
cause = e.getCause();
}
return e;
}
/**
* Gets the message for an exception taking into consideration that
* not all exceptions (ie NPE) will have a message in which case the
* class's name will be used in lue of no message.
* @param ex any throwable
* @return a non-null message
*/
public static String getMessage(Throwable ex) {
String msg = ex.getMessage();
return StringUtils.isBlank(msg) ? ex.getClass().getName() : msg;
}
/**
* Gets the message for an exception's root exception taking into
* consideration that not all exceptions (ie NPE) will have a message
* in which case the class's name will be used in lue of no message.
* @param ex any throwable
* @return a non-null message for the root throwable
*/
public static String getRootMessage(Throwable ex) {
ex = getRootCause(ex);
String msg = ex.getMessage();
return StringUtils.isBlank(msg) ? ex.getClass().getName() : msg;
}
public static String getStackTrace(Throwable e) {
StringWriter writer = new StringWriter();
PrintWriter pw = new PrintWriter(writer);
e.printStackTrace(pw);
return writer.toString();
}
public static List getRootCauses(Throwable e) {
Throwable last = e.getCause();
List list = new ArrayList();
list.add(e);
while (last != e && last != null) {
list.add(last);
e = last;
last = e.getCause();
}
return list;
}
}