info.freelibrary.util.ThrowingBiConsumer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of freelib-utils Show documentation

A small collection of utility classes

There is a newer version: 5.2.0


package info.freelibrary.util;

import java.util.function.BiConsumer;

import info.freelibrary.util.warnings.PMD;

/**
 * A bi-consumer that throws a runtime exception. This is not an ideal solution (as the PMD suppressions indicate), but
 * it provides a generic way to handle exceptions thrown in lambdas.
 *
 * @param  The first input that the function accepts
 * @param  The second input that the function accepts
 */
@FunctionalInterface
public interface ThrowingBiConsumer extends BiConsumer {

    @Override
    @SuppressWarnings({ PMD.AVOID_CATCHING_GENERIC_EXCEPTION })
    default void accept(final T a1stInput, final U a2ndInput) {
        try {
            acceptThrows(a1stInput, a2ndInput);
        } catch (final Exception details) {
            throw new I18nRuntimeException(details);
        }
    }

    /**
     * A method that wraps any exceptions through by the bi-consumer with a runtime exception.
     *
     * @param a1stInput A first input accepted by the consumer
     * @param a2ndInput A second input accepted by the consumer
     * @throws Exception An exception thrown by the consumer
     */
    @SuppressWarnings({ PMD.SIGNATURE_DECLARE_THROWS_EXCEPTION })
    void acceptThrows(T a1stInput, U a2ndInput) throws Exception;

}