de.team33.libs.exceptional.v4.functional

Class Converter

java.lang.Object

de.team33.libs.exceptional.v4.functional.Converter

public final class Converter
extends Object

A tool that can convert certain functional constructs that may throw checked exceptions (e.g. XFunction) into more common constructs (e.g. Function) that will wrap such exceptions in unchecked exceptions.

See Also:

Conversion

Method Summary

Modifier and Type	Method and Description
static Function<Throwable,RuntimeException>	altWrapping(Function<String,RuntimeException> wrapping) Returns an alternative wrapping method for using(Function) that uses the message of the original Exception to create the wrapping RuntimeException.
<T,U> BiConsumer<T,U>	biConsumer(XBiConsumer<T,U,?> xBiConsumer) Wraps an XBiConsumer that may throw a checked exception as BiConsumer that, when executed, wraps any occurring checked exception as specific unchecked exception.
<T,U,R> BiFunction<T,U,R>	biFunction(XBiFunction<T,U,R,?> xBiFunction) Wraps an XBiFunction that may throw a checked exception as BiFunction that, when executed, wraps any occurring checked exception as a specific unchecked exception.
<T,U> BiPredicate<T,U>	biPredicate(XBiPredicate<T,U,?> xBiPredicate) Wraps an XBiPredicate that may throw a checked exception as BiPredicate that, when executed, wraps any occurring checked exception as a specific unchecked exception.
<T> Consumer<T>	consumer(XConsumer<T,?> xConsumer) Wraps an XConsumer that may throw a checked exception as Consumer that, when executed, wraps any occurring checked exception as specific unchecked exception.
<T,R> Function<T,R>	function(XFunction<T,R,?> xFunction) Wraps an XFunction that may throw a checked exception as Function that, when executed, wraps any occurring checked exception as specific unchecked exception.
<T> Predicate<T>	predicate(XPredicate<T,?> xPredicate) Wraps an XPredicate that may throw a checked exception as Predicate that, when executed, wraps any occurring checked exception as specific unchecked exception.
Runnable	runnable(XRunnable<?> xRunnable) Wraps an XRunnable that may throw a checked exception as Runnable that, when executed, wraps any occurring checked exception as specific unchecked exception.
static Function<Throwable,RuntimeException>	stdWrapping(BiFunction<String,Throwable,RuntimeException> wrapping) Returns a standard wrapping method for using(Function) that uses the message of the original Exception to create the wrapping RuntimeException.
<R> Supplier<R>	supplier(XSupplier<R,?> xSupplier) Wraps an XSupplier that may throw a checked exception as Supplier that, when executed, wraps any occurring checked exception as specific unchecked exception.
static Converter	using(Function<Throwable,RuntimeException> wrapping) Returns a new instance using a given wrapping method.

Methods inherited from class java.lang.Object

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

Method Detail

using

public static Converter using(Function<Throwable,RuntimeException> wrapping)

Returns a new instance using a given wrapping method.

See Also:

stdWrapping(BiFunction), altWrapping(Function)

stdWrapping

public static Function<Throwable,RuntimeException> stdWrapping(BiFunction<String,Throwable,RuntimeException> wrapping)

Returns a standard wrapping method for using(Function) that uses the message of the original Exception to create the wrapping RuntimeException.

This is mainly intended to view a typical standard constructor of a RuntimeException that requires two parameters (message text and causing exception, e.g. WrappedException.WrappedException(String, Throwable)) as a Function in order to use it with using(Function).

The resulting function uses the message text of the causing exception unchanged as the message text of its resulting RuntimeException.

Example:

 import static de.team33.libs.exceptional.v4.functional.Converter.stdWrapping;
 import static de.team33.libs.exceptional.v4.functional.Converter.using;

 public class MyClass {

     private static final FunctionalConverter CONVERTER = using(stdWrapping(WrappedException::new));

     // ...
 }
 

altWrapping

public static Function<Throwable,RuntimeException> altWrapping(Function<String,RuntimeException> wrapping)

Returns an alternative wrapping method for using(Function) that uses the message of the original Exception to create the wrapping RuntimeException.

This is mainly intended to view a typical standard constructor of a RuntimeException that requires a single string parameter (the detail message) as a Function in order to use it with using(Function).

The resulting function uses the message text of the causing exception unchanged as the message text of its resulting RuntimeException and then initializes the causing exception as its cause.

Example:

 import static de.team33.libs.exceptional.v4.functional.Converter.altWrapping;
 import static de.team33.libs.exceptional.v4.functional.Converter.using;

 public class MyConversion {

     private static final FunctionalConverter CONVERTER = using(altWrapping(MyException::new));

     // ...

     public static class MyException extends RuntimeException {

         public MyException(final String message) {
             super(message);
         }
     }
 }
 

runnable

public final Runnable runnable(XRunnable<?> xRunnable)

Wraps an XRunnable that may throw a checked exception as Runnable that, when executed, wraps any occurring checked exception as specific unchecked exception.

consumer

public final <T> Consumer<T> consumer(XConsumer<T,?> xConsumer)

Wraps an XConsumer that may throw a checked exception as Consumer that, when executed, wraps any occurring checked exception as specific unchecked exception.

biConsumer

public final <T,U> BiConsumer<T,U> biConsumer(XBiConsumer<T,U,?> xBiConsumer)

Wraps an XBiConsumer that may throw a checked exception as BiConsumer that, when executed, wraps any occurring checked exception as specific unchecked exception.

supplier

public final <R> Supplier<R> supplier(XSupplier<R,?> xSupplier)

Wraps an XSupplier that may throw a checked exception as Supplier that, when executed, wraps any occurring checked exception as specific unchecked exception.

predicate

public final <T> Predicate<T> predicate(XPredicate<T,?> xPredicate)

Wraps an XPredicate that may throw a checked exception as Predicate that, when executed, wraps any occurring checked exception as specific unchecked exception.

biPredicate

public final <T,U> BiPredicate<T,U> biPredicate(XBiPredicate<T,U,?> xBiPredicate)

Wraps an XBiPredicate that may throw a checked exception as BiPredicate that, when executed, wraps any occurring checked exception as a specific unchecked exception.

function

public final <T,R> Function<T,R> function(XFunction<T,R,?> xFunction)

Wraps an XFunction that may throw a checked exception as Function that, when executed, wraps any occurring checked exception as specific unchecked exception.

biFunction

public final <T,U,R> BiFunction<T,U,R> biFunction(XBiFunction<T,U,R,?> xBiFunction)

Wraps an XBiFunction that may throw a checked exception as BiFunction that, when executed, wraps any occurring checked exception as a specific unchecked exception.