Throwing (jooby 2.0.0.RC2 API)

java.lang.Object
- io.jooby.Throwing

public final class Throwing
extends Object

Collection of throwable interfaces to simplify exception handling, specially on lambdas. We do provide throwable and 100% compatible implementation of Function , Consumer, Runnable, Supplier, Predicate and BiPredicate. Examples:



  interface Query {
    Item findById(String id) throws IOException;
  }

  Query query = ...

  List<Item> items = Arrays.asList("1", "2", "3")
    .stream()
    .map(throwingFunction(query::findById))
    .collect(Collectors.toList());

Author:: edgar

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Throwing.Consumer<V>` Throwable version of `Consumer`.
`static interface`	`Throwing.Consumer2<V1,V2>` Two argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Consumer3<V1,V2,V3>` Three argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Consumer4<V1,V2,V3,V4>` Four argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Consumer5<V1,V2,V3,V4,V5>` Five argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Consumer6<V1,V2,V3,V4,V5,V6>` Six argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Consumer7<V1,V2,V3,V4,V5,V6,V7>` Seven argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Consumer8<V1,V2,V3,V4,V5,V6,V7,V8>` Seven argument version of `Throwing.Consumer`.
`static interface`	`Throwing.Function<V,R>` Throwable version of `Function`.
`static interface`	`Throwing.Function2<V1,V2,R>` Throwable version of `BiFunction`.
`static interface`	`Throwing.Function3<V1,V2,V3,R>` Function with three arguments.
`static interface`	`Throwing.Function4<V1,V2,V3,V4,R>` Function with four arguments.
`static interface`	`Throwing.Function5<V1,V2,V3,V4,V5,R>` Function with five arguments.
`static interface`	`Throwing.Function6<V1,V2,V3,V4,V5,V6,R>` Function with six arguments.
`static interface`	`Throwing.Function7<V1,V2,V3,V4,V5,V6,V7,R>` Function with seven arguments.
`static interface`	`Throwing.Function8<V1,V2,V3,V4,V5,V6,V7,V8,R>` Function with seven arguments.
`static interface`	`Throwing.Predicate<V>` Throwable version of `Throwing.Predicate`.
`static interface`	`Throwing.Predicate2<V1,V2>` Throwable version of `Throwing.Predicate`.
`static interface`	`Throwing.Runnable` Throwable version of `Runnable`.
`static interface`	`Throwing.Supplier<V>` Throwable version of `Supplier`.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`isFatal(Throwable x)` True if the given exception is one of `InterruptedException`, `LinkageError`, `ThreadDeath`, `VirtualMachineError`.
`static RuntimeException`	`sneakyThrow(Throwable x)` Throws any throwable 'sneakily' - you don't need to catch it, nor declare that you throw it onwards.
`static <V> Throwing.Consumer<V>`	`throwingConsumer(Throwing.Consumer<V> action)` Factory method for throwing consumer.
`static <V1,V2> Throwing.Consumer2<V1,V2>`	`throwingConsumer(Throwing.Consumer2<V1,V2> action)` Factory method for throwing consumer.
`static <V1,V2,V3> Throwing.Consumer3<V1,V2,V3>`	`throwingConsumer(Throwing.Consumer3<V1,V2,V3> action)` Factory method for throwing consumer.
`static <V1,V2,V3,V4> Throwing.Consumer4<V1,V2,V3,V4>`	`throwingConsumer(Throwing.Consumer4<V1,V2,V3,V4> action)` Factory method for throwing consumer.
`static <V1,V2,V3,V4,V5> Throwing.Consumer5<V1,V2,V3,V4,V5>`	`throwingConsumer(Throwing.Consumer5<V1,V2,V3,V4,V5> action)` Factory method for throwing consumer.
`static <V1,V2,V3,V4,V5,V6> Throwing.Consumer6<V1,V2,V3,V4,V5,V6>`	`throwingConsumer(Throwing.Consumer6<V1,V2,V3,V4,V5,V6> action)` Factory method for throwing consumer.
`static <V1,V2,V3,V4,V5,V6,V7> Throwing.Consumer7<V1,V2,V3,V4,V5,V6,V7>`	`throwingConsumer(Throwing.Consumer7<V1,V2,V3,V4,V5,V6,V7> action)` Factory method for throwing consumer.
`static <V1,V2,V3,V4,V5,V6,V7,V8> Throwing.Consumer8<V1,V2,V3,V4,V5,V6,V7,V8>`	`throwingConsumer(Throwing.Consumer8<V1,V2,V3,V4,V5,V6,V7,V8> action)` Factory method for throwing consumer.
`static <V,R> Throwing.Function<V,R>`	`throwingFunction(Throwing.Function<V,R> fn)` Factory method for `Throwing.Function` and `Function`.
`static <V1,V2,R> Throwing.Function2<V1,V2,R>`	`throwingFunction(Throwing.Function2<V1,V2,R> fn)` Factory method for `Throwing.Function2` and `BiFunction`.
`static <V1,V2,V3,R> Throwing.Function3<V1,V2,V3,R>`	`throwingFunction(Throwing.Function3<V1,V2,V3,R> fn)` Factory method for throwing function.
`static <V1,V2,V3,V4,R> Throwing.Function4<V1,V2,V3,V4,R>`	`throwingFunction(Throwing.Function4<V1,V2,V3,V4,R> fn)` Factory method for throwing function.
`static <V1,V2,V3,V4,V5,R> Throwing.Function5<V1,V2,V3,V4,V5,R>`	`throwingFunction(Throwing.Function5<V1,V2,V3,V4,V5,R> fn)` Factory method for throwing function.
`static <V1,V2,V3,V4,V5,V6,R> Throwing.Function6<V1,V2,V3,V4,V5,V6,R>`	`throwingFunction(Throwing.Function6<V1,V2,V3,V4,V5,V6,R> fn)` Factory method for throwing function.
`static <V1,V2,V3,V4,V5,V6,V7,R> Throwing.Function7<V1,V2,V3,V4,V5,V6,V7,R>`	`throwingFunction(Throwing.Function7<V1,V2,V3,V4,V5,V6,V7,R> fn)` Factory method for throwing function.
`static <V1,V2,V3,V4,V5,V6,V7,V8,R> Throwing.Function8<V1,V2,V3,V4,V5,V6,V7,V8,R>`	`throwingFunction(Throwing.Function8<V1,V2,V3,V4,V5,V6,V7,V8,R> fn)` Factory method for throwing function.
`static <V> Throwing.Predicate<V>`	`throwingPredicate(Throwing.Predicate<V> predicate)` Factory method for predicate.
`static <V1,V2> Throwing.Predicate2<V1,V2>`	`throwingPredicate(Throwing.Predicate2<V1,V2> predicate)` Factory method for predicate.
`static Throwing.Runnable`	`throwingRunnable(Throwing.Runnable action)` Factory method for `Runnable`.
`static <V> Throwing.Supplier<V>`	`throwingSupplier(Throwing.Supplier<V> fn)` Factory method for `Throwing.Supplier`.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - throwingPredicate
```
public static <V> Throwing.Predicate<V> throwingPredicate(Throwing.Predicate<V> predicate)
```
    Factory method for predicate.
    
    Type Parameters:
    
    V - Type 1.
    
    Parameters:
    
    predicate - Predicate.
    
    Returns:
    
    A throwing predicate.
  - throwingPredicate
```
public static <V1,V2> Throwing.Predicate2<V1,V2> throwingPredicate(Throwing.Predicate2<V1,V2> predicate)
```
    Factory method for predicate.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    Parameters:
    
    predicate - Predicate.
    
    Returns:
    
    A throwing predicate.
  - throwingRunnable
```
public static Throwing.Runnable throwingRunnable(Throwing.Runnable action)
```
    Factory method for Runnable.
    
    Parameters:
    
    action - Runnable.
    
    Returns:
    
    Same runnable.
  - throwingSupplier
```
public static <V> Throwing.Supplier<V> throwingSupplier(Throwing.Supplier<V> fn)
```
    Factory method for Throwing.Supplier.
    
    Type Parameters:
    
    V - Resulting value.
    
    Parameters:
    
    fn - Supplier.
    
    Returns:
    
    Same supplier.
  - throwingFunction
```
public static <V,R> Throwing.Function<V,R> throwingFunction(Throwing.Function<V,R> fn)
```
    Factory method for Throwing.Function and Function.
    
    Type Parameters:
    
    V - Input value.
    
    R - Result value.
    
    Parameters:
    
    fn - Function.
    
    Returns:
    
    Same supplier.
  - throwingFunction
```
public static <V1,V2,R> Throwing.Function2<V1,V2,R> throwingFunction(Throwing.Function2<V1,V2,R> fn)
```
    Factory method for Throwing.Function2 and BiFunction.
    
    Type Parameters:
    
    V1 - Input value.
    
    V2 - Input value.
    
    R - Result value.
    
    Parameters:
    
    fn - Function.
    
    Returns:
    
    Same supplier.
  - throwingFunction
```
public static <V1,V2,V3,R> Throwing.Function3<V1,V2,V3,R> throwingFunction(Throwing.Function3<V1,V2,V3,R> fn)
```
    Factory method for throwing function.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    R - Return type.
    
    Parameters:
    
    fn - Throwing function.
    
    Returns:
    
    Throwing function.
  - throwingFunction
```
public static <V1,V2,V3,V4,R> Throwing.Function4<V1,V2,V3,V4,R> throwingFunction(Throwing.Function4<V1,V2,V3,V4,R> fn)
```
    Factory method for throwing function.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    R - Return type.
    
    Parameters:
    
    fn - Throwing function.
    
    Returns:
    
    Throwing function.
  - throwingFunction
```
public static <V1,V2,V3,V4,V5,R> Throwing.Function5<V1,V2,V3,V4,V5,R> throwingFunction(Throwing.Function5<V1,V2,V3,V4,V5,R> fn)
```
    Factory method for throwing function.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    R - Return type.
    
    Parameters:
    
    fn - Throwing function.
    
    Returns:
    
    Throwing function.
  - throwingFunction
```
public static <V1,V2,V3,V4,V5,V6,R> Throwing.Function6<V1,V2,V3,V4,V5,V6,R> throwingFunction(Throwing.Function6<V1,V2,V3,V4,V5,V6,R> fn)
```
    Factory method for throwing function.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    V6 - Type 6.
    
    R - Return type.
    
    Parameters:
    
    fn - Throwing function.
    
    Returns:
    
    Throwing function.
  - throwingFunction
```
public static <V1,V2,V3,V4,V5,V6,V7,R> Throwing.Function7<V1,V2,V3,V4,V5,V6,V7,R> throwingFunction(Throwing.Function7<V1,V2,V3,V4,V5,V6,V7,R> fn)
```
    Factory method for throwing function.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    V6 - Type 6.
    
    V7 - Type 7.
    
    R - Return type.
    
    Parameters:
    
    fn - Throwing function.
    
    Returns:
    
    Throwing function.
  - throwingFunction
```
public static <V1,V2,V3,V4,V5,V6,V7,V8,R> Throwing.Function8<V1,V2,V3,V4,V5,V6,V7,V8,R> throwingFunction(Throwing.Function8<V1,V2,V3,V4,V5,V6,V7,V8,R> fn)
```
    Factory method for throwing function.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    V6 - Type 6.
    
    V7 - Type 7.
    
    V8 - Type 8.
    
    R - Return type.
    
    Parameters:
    
    fn - Throwing function.
    
    Returns:
    
    Throwing function.
  - throwingConsumer
```
public static <V> Throwing.Consumer<V> throwingConsumer(Throwing.Consumer<V> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V - Type 1.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2> Throwing.Consumer2<V1,V2> throwingConsumer(Throwing.Consumer2<V1,V2> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2,V3> Throwing.Consumer3<V1,V2,V3> throwingConsumer(Throwing.Consumer3<V1,V2,V3> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2,V3,V4> Throwing.Consumer4<V1,V2,V3,V4> throwingConsumer(Throwing.Consumer4<V1,V2,V3,V4> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2,V3,V4,V5> Throwing.Consumer5<V1,V2,V3,V4,V5> throwingConsumer(Throwing.Consumer5<V1,V2,V3,V4,V5> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2,V3,V4,V5,V6> Throwing.Consumer6<V1,V2,V3,V4,V5,V6> throwingConsumer(Throwing.Consumer6<V1,V2,V3,V4,V5,V6> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    V6 - Type 6.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2,V3,V4,V5,V6,V7> Throwing.Consumer7<V1,V2,V3,V4,V5,V6,V7> throwingConsumer(Throwing.Consumer7<V1,V2,V3,V4,V5,V6,V7> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    V6 - Type 6.
    
    V7 - Type 7.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - throwingConsumer
```
public static <V1,V2,V3,V4,V5,V6,V7,V8> Throwing.Consumer8<V1,V2,V3,V4,V5,V6,V7,V8> throwingConsumer(Throwing.Consumer8<V1,V2,V3,V4,V5,V6,V7,V8> action)
```
    Factory method for throwing consumer.
    
    Type Parameters:
    
    V1 - Type 1.
    
    V2 - Type 2.
    
    V3 - Type 3.
    
    V4 - Type 4.
    
    V5 - Type 5.
    
    V6 - Type 6.
    
    V7 - Type 7.
    
    V8 - Type 8.
    
    Parameters:
    
    action - Throwing consumer.
    
    Returns:
    
    Throwing consumer.
  - sneakyThrow
```
public static RuntimeException sneakyThrow(Throwable x)
```
    Throws any throwable 'sneakily' - you don't need to catch it, nor declare that you throw it onwards. The exception is still thrown - javac will just stop whining about it.
    Example usage:
```
public void run() {
     throw sneakyThrow(new IOException("You don't need to catch me!"));
 }
```
    NB: The exception is not wrapped, ignored, swallowed, or redefined. The JVM actually does not know or care about the concept of a 'checked exception'. All this method does is hide the act of throwing a checked exception from the java compiler.
    Note that this method has a return type of RuntimeException; it is advised you always call this method as argument to the throw statement to avoid compiler errors regarding no return statement and similar problems. This method won't of course return an actual RuntimeException - it never returns, it always throws the provided exception.
    Parameters:
    
    x - The throwable to throw without requiring you to catch its type.
    
    Returns:
    
    A dummy RuntimeException; this method never returns normally, it always throws an exception!
  - isFatal
```
public static boolean isFatal(Throwable x)
```
    True if the given exception is one of InterruptedException, LinkageError, ThreadDeath, VirtualMachineError.
    
    Parameters:
    
    x - Exception to test.
    
    Returns:
    
    True if the given exception is one of InterruptedException, LinkageError, ThreadDeath, VirtualMachineError.

Class Throwing

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Method Detail

throwingPredicate

throwingPredicate

throwingRunnable

throwingSupplier

throwingFunction

throwingFunction

throwingFunction

throwingFunction

throwingFunction

throwingFunction

throwingFunction

throwingFunction

throwingConsumer

throwingConsumer

throwingConsumer

throwingConsumer

throwingConsumer

throwingConsumer

throwingConsumer

throwingConsumer

sneakyThrow

isFatal