com.aspectran.core.util.MultiException Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2023 The Aspectran Project
*
* 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 com.aspectran.core.util;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/**
* Wraps multiple exceptions.
*
* Allows multiple exceptions to be thrown as a single exception.
*/
public class MultiException extends Exception {
private static final long serialVersionUID = 2675035125716434028L;
private List nested;
public MultiException() {
super("Multiple exceptions");
}
public void add(Throwable e) {
if (e == null) {
throw new IllegalArgumentException();
}
if (nested == null) {
initCause(e);
nested = new ArrayList<>();
} else {
addSuppressed(e);
}
if (e instanceof MultiException) {
MultiException me = (MultiException)e;
nested.addAll(me.nested);
} else {
nested.add(e);
}
}
public int size() {
return (nested == null ? 0 : nested.size());
}
public List getThrowables() {
return (nested == null ? Collections.emptyList() : nested);
}
public Throwable getThrowable(int i) {
return nested.get(i);
}
/**
* Throw a MultiException.
* If this multi exception is empty then no action is taken. If it
* contains a single exception that is thrown, otherwise this
* multi exception is thrown.
* @exception Exception the Error or Exception if nested is 1, or the
* MultiException itself if nested is more than 1.
*/
public void ifExceptionThrow() throws Exception {
if (nested == null || nested.isEmpty()) {
return;
}
if (nested.size() == 1) {
Throwable th = nested.get(0);
if (th instanceof Error) {
throw (Error)th;
}
if (th instanceof Exception) {
throw (Exception)th;
}
}
throw this;
}
/**
* Throw a Runtime exception.
* If this multi exception is empty then no action is taken. If it
* contains a single error or runtime exception that is thrown, otherwise this
* multi exception is thrown, wrapped in a runtime exception.
* @exception Error if this exception contains exactly 1 {@link Error}
* @exception RuntimeException if this exception contains 1 {@link Throwable} but
* it is not an error, or it contains more than 1 {@link Throwable} of any type
*/
public void ifExceptionThrowRuntime() throws Error {
if (nested == null || nested.isEmpty()) {
return;
}
if (nested.size() == 1) {
Throwable th = nested.get(0);
if (th instanceof Error) {
throw (Error)th;
} else if (th instanceof RuntimeException) {
throw (RuntimeException)th;
} else {
throw new RuntimeException(th);
}
}
throw new RuntimeException(this);
}
/**
* Throw a MultiException.
* If this multi exception is empty then no action is taken. If it
* contains a any exceptions then this
* multi exception is thrown.
* @throws MultiException the MultiException if there are nested exception
*/
public void ifExceptionThrowMulti() throws MultiException {
if (nested != null && !nested.isEmpty()) {
throw this;
}
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append(MultiException.class.getSimpleName());
if (nested == null || nested.size() <= 0) {
sb.append("[]");
} else {
sb.append(nested);
}
return sb.toString();
}
}