Failable¶

public class org.apache.commons.lang3.function.Failable[source]¶

This class provides utility functions, and classes for working with the java.util.function package, or more generally, with Java 8 lambdas. More specifically, it attempts to address the fact that lambdas are supposed not to throw Exceptions, at least not checked Exceptions, like instances of Exception. This enforces the use of constructs like:

Consumer<java.lang.reflect.Method> consumer = m -> {
    try {
        m.invoke(o, args);
    } catch (Throwable t) {
        throw Failable.rethrow(t);
    }
};

By replacing a Consumer<O> with a FailableConsumer<O,? extends Throwable>, this can be written like follows:

Functions.accept(m -> m.invoke(o, args));

Obviously, the second version is much more concise and the spirit of Lambda expressions is met better than the first version.

Since:: 3.11

Methods¶

`accept(FailableBiConsumer, Object, Object)`	Consumes a consumer and rethrows any exception as a `RuntimeException`.
`accept(FailableConsumer, Object)`	Consumes a consumer and rethrows any exception as a `RuntimeException`.
`accept(FailableDoubleConsumer, double)`	Consumes a consumer and rethrows any exception as a `RuntimeException`.
`accept(FailableIntConsumer, int)`	Consumes a consumer and rethrows any exception as a `RuntimeException`.
`accept(FailableLongConsumer, long)`	Consumes a consumer and rethrows any exception as a `RuntimeException`.
`apply(FailableBiFunction, Object, Object)`	Applies a function and rethrows any exception as a `RuntimeException`.
`apply(FailableFunction, Object)`	Applies a function and rethrows any exception as a `RuntimeException`.
`applyAsDouble(FailableDoubleBinaryOperator, double, double)`	Applies a function and rethrows any exception as a `RuntimeException`.
`applyNonNull(Object, FailableFunction)`	Applies a value to a function if the value isn’t `null`, otherwise the method returns `null`.
`applyNonNull(Object, FailableFunction, FailableFunction)`	Applies values to a chain of functions, where a `null` can short-circuit each step.
`applyNonNull(Object, FailableFunction, FailableFunction, FailableFunction)`	Applies values to a chain of functions, where a `null` can short-circuit each step.
`asBiConsumer(FailableBiConsumer)`	Converts the given `FailableBiConsumer` into a standard `BiConsumer`.
`asBiFunction(FailableBiFunction)`	Converts the given `FailableBiFunction` into a standard `BiFunction`.
`asBiPredicate(FailableBiPredicate)`	Converts the given `FailableBiPredicate` into a standard `BiPredicate`.
`asCallable(FailableCallable)`	Converts the given `FailableCallable` into a standard `Callable`.
`asConsumer(FailableConsumer)`	Converts the given `FailableConsumer` into a standard `Consumer`.
`asFunction(FailableFunction)`	Converts the given `FailableFunction` into a standard `Function`.
`asPredicate(FailablePredicate)`	Converts the given `FailablePredicate` into a standard `Predicate`.
`asRunnable(FailableRunnable)`	Converts the given `FailableRunnable` into a standard `Runnable`.
`asSupplier(FailableSupplier)`	Converts the given `FailableSupplier` into a standard `Supplier`.
`call(FailableCallable)`	Calls a callable and rethrows any exception as a `RuntimeException`.
`get(FailableSupplier)`	Gets the result of invoking the supplier.
`getAsBoolean(FailableBooleanSupplier)`	Gets the result of invoking the boolean supplier.
`getAsDouble(FailableDoubleSupplier)`	Gets the result of invoking the double supplier.
`getAsInt(FailableIntSupplier)`	Gets the result of invoking the int supplier.
`getAsLong(FailableLongSupplier)`	Gets the result of invoking the long supplier.
`getAsShort(FailableShortSupplier)`	Gets the result of invoking the short supplier.
`rethrow(Throwable)`	Rethrows a `Throwable` as an unchecked exception.
`run(FailableRunnable)`	Runs a runnable and rethrows any exception as a `RuntimeException`.
`stream(Collection)`	Converts the given collection into a `FailableStream`.
`stream(Stream)`	Converts the given stream into a `FailableStream`.
`test(FailableBiPredicate, Object, Object)`	Tests a predicate and rethrows any exception as a `RuntimeException`.
`test(FailablePredicate, Object)`	Tests a predicate and rethrows any exception as a `RuntimeException`.
`tryWithResources(FailableRunnable, FailableConsumer, FailableRunnable[])`	A simple try-with-resources implementation, that can be used, if your objects do not implement the `AutoCloseable` interface.
`tryWithResources(FailableRunnable, FailableRunnable[])`	A simple try-with-resources implementation, that can be used, if your objects do not implement the `AutoCloseable` interface.

public static <T, U, E extends Throwable> void accept(FailableBiConsumer<T, U, E> consumer, T object1, U object2)[source]¶