org.ujorm.tools.web.ExceptionProvider Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of ujo-web Show documentation
Ujorm-web module for a common use
The newest version!
/*
 * Copyright 2021-2022 Pavel Ponec
 *
 * 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.ujorm.tools.web;

import java.util.function.Consumer;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import org.ujorm.tools.Assert;

/**
 *
 * @author Pavel Ponec
 */
public final class ExceptionProvider {

    /** Provider with no exception */
    @NotNull
    private static final ExceptionProvider EMPTY = new ExceptionProvider(null);

    @Nullable
    private final Throwable e;

    private ExceptionProvider(@Nullable final Throwable e) {
        this.e = e;
    }

    /**
     * Re-throw any exception.
     *
     * @deprecated Use the method {@link #catchEx(Class, Consumer)} rather
     */
    @Deprecated
    public void catchEx() {
        catchEx(IllegalStateException.class, e -> {throw e;});
    }

    /**
     * Apply consumer if the exception is a required type (or not null).
     *
     * @deprecated Use the method {@link #catchEx(Class, Consumer)} rather
     */
    @Deprecated
    public void catche(@NotNull final Consumer exceptionConsumer) {
        catchEx(Throwable.class, exceptionConsumer);
    }


    /**
     * Apply consumer if the exception is a required type (or not null).
     */
    public void catchEx(@NotNull final Consumer exceptionConsumer) {
        catchEx(Throwable.class, exceptionConsumer);
    }

    /**
     * Apply consumer if the exception is not null.
     */
    public  void catchEx(@NotNull final Class exceptionClass, @NotNull final Consumer exceptionConsumer) {
        if (e != null) {
            if (exceptionClass.isInstance(e)) {
                exceptionConsumer.accept((T) e);
            } else if (e instanceof RuntimeException) {
                throw (RuntimeException) e;
            } else if (e instanceof Error) {
                throw (Error) e;
            } else {
                throw new IllegalStateException(e);
            }
        }
    }

    /** A factory method */
    @NotNull
    public static ExceptionProvider of(@NotNull final Throwable e) {
        return new ExceptionProvider(Assert.notNull(e, "Exception is required"));
    }

    /** A factory method */
    @NotNull
    public static ExceptionProvider of() {
        return EMPTY;
    }

}