com.aspectran.utils.MultiException Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of aspectran-utils Show documentation
Miscellaneous utility classes used across multiple packages
There is a newer version: 8.1.3
/*
 * Copyright (c) 2008-2024 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.utils;

import java.io.Serial;
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 {

    @Serial
    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 me) {
            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();
    }

}