com.diffplug.common.base

Class Errors.Handling

java.lang.Object

com.diffplug.common.base.Errors

com.diffplug.common.base.Errors.Handling

All Implemented Interfaces:

Consumer<Throwable>

Enclosing class:

Errors

public static class Errors.Handling
extends Errors

An Errors which is free to rethrow the exception, but it might not.

If we want to wrap a method with a return value, since the handler might not throw an exception, we need a default value to return.

Nested Class Summary

Nested classes/interfaces inherited from class com.diffplug.common.base.Errors

Errors.ConstrainedTo<E extends Throwable>, Errors.Handling, Errors.Plugins, Errors.Rethrowing, Errors.WrappedAsRuntimeException

Field Summary

Fields inherited from class com.diffplug.common.base.Errors

handler

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Handling(Consumer<Throwable> error)

Method Summary

Modifier and Type	Method and Description
<T> T	getWithDefault(Throwing.Supplier<T> supplier, T onFailure) Attempts to call supplier and returns onFailure if an exception is thrown.
<T,R> Function<T,R>	wrapFunctionWithDefault(Throwing.Function<T,R> function, R onFailure) Returns a Function which wraps function and returns onFailure if an exception is thrown.
<T> Predicate<T>	wrapPredicateWithDefault(Throwing.Predicate<T> predicate, boolean onFailure) Returns a Predicate which wraps predicate and returns onFailure if an exception is thrown.
<T,R> Function<T,R>	wrapWithDefault(Throwing.Function<T,R> function, R onFailure) Returns a Function which wraps function and returns onFailure if an exception is thrown.
<T> Predicate<T>	wrapWithDefault(Throwing.Predicate<T> predicate, boolean onFailure) Returns a Predicate which wraps predicate and returns onFailure if an exception is thrown.
<T> Supplier<T>	wrapWithDefault(Throwing.Supplier<T> supplier, T onFailure) Returns a Supplier which wraps supplier and returns onFailure if an exception is thrown.

Methods inherited from class com.diffplug.common.base.Errors

accept, asRuntime, asTerminal, constrainTo, createHandling, createRethrowing, dialog, log, rethrow, run, suppress, wrap, wrap

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.function.Consumer

andThen

Constructor Detail

Handling

protected Handling(Consumer<Throwable> error)

Method Detail

getWithDefault

public <T> T getWithDefault(Throwing.Supplier<T> supplier,
                            @Nullable
                            T onFailure)

Attempts to call supplier and returns onFailure if an exception is thrown.

wrapWithDefault

public <T> Supplier<T> wrapWithDefault(Throwing.Supplier<T> supplier,
                                       @Nullable
                                       T onFailure)

Returns a Supplier which wraps supplier and returns onFailure if an exception is thrown.

wrapWithDefault

public <T,R> Function<T,R> wrapWithDefault(Throwing.Function<T,R> function,
                                           @Nullable
                                           R onFailure)

Returns a Function which wraps function and returns onFailure if an exception is thrown.

If you are getting an error about the method wrapWithDefault is ambiguous, use #wrapFunctionWithDefault(com.diffplug.common.base.Throwing.Function) or {@link #wrapPredicateWithDefault(com.diffplug.common.base.Throwing.Predicate).

wrapWithDefault

public <T> Predicate<T> wrapWithDefault(Throwing.Predicate<T> predicate,
                                        boolean onFailure)

Returns a Predicate which wraps predicate and returns onFailure if an exception is thrown.

If you are getting an error about the method wrapWithDefault is ambiguous, use #wrapFunctionWithDefault(com.diffplug.common.base.Throwing.Function) or {@link #wrapPredicateWithDefault(com.diffplug.common.base.Throwing.Predicate).

wrapFunctionWithDefault

public <T,R> Function<T,R> wrapFunctionWithDefault(Throwing.Function<T,R> function,
                                                   @Nullable
                                                   R onFailure)

Returns a Function which wraps function and returns onFailure if an exception is thrown.

wrapPredicateWithDefault

public <T> Predicate<T> wrapPredicateWithDefault(Throwing.Predicate<T> predicate,
                                                 boolean onFailure)

Returns a Predicate which wraps predicate and returns onFailure if an exception is thrown.