Exceptional (Lightweight-Stream-API 1.2.1 API)

java.lang.Object
- com.annimon.stream.Exceptional<T>

Type Parameters:: T - the type of the inner value

public class Exceptional<T>
extends Object

A container for values which provided by ThrowableSupplier. Stores value which provided by ThrowableSupplier or an exception which were thrown.


     Exceptional.of(new ThrowableSupplier<String, Throwable>() {
          @Override
          public String get() throws Throwable {
              return IOUtils.read(inputStream);
          }
      }).ifExceptionIs(IOException.class, new Consumer<IOException>() {
          @Override
          public void accept(IOException exception) {
              logger.log(Level.WARNING, "read file", exception);
          }
      }).getOrElse("default string");

      Exceptional.of(() -> IOUtils.readBytes(inputStream)).getOrElse(new byte[0]);

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<R> R`	`custom(Function<Exceptional<T>,R> function)` Applies custom operator on `Exceptional`.
`boolean`	`equals(Object obj)`
`T`	`get()` Returns inner value.
`Throwable`	`getException()` Returns exception.
`Optional<T>`	`getOptional()` Wraps inner value with `Optional` container
`T`	`getOrElse(Supplier<? extends T> other)` Returns inner value if there were no exceptions, otherwise returns value produced by supplier function.
`T`	`getOrElse(T other)` Returns inner value if there were no exceptions, otherwise returns `other`.
`T`	`getOrThrow()` Returns inner value if there were no exceptions, otherwise throws an exception.
`<E extends Throwable> T`	`getOrThrow(E exception)` Returns inner value if there were no exceptions, otherwise throws the given `exception`.
`T`	`getOrThrowRuntimeException()` Returns inner value if there were no exceptions, otherwise throws `RuntimeException`.
`int`	`hashCode()`
`Exceptional<T>`	`ifException(Consumer<Throwable> consumer)` Invokes consumer function if there were any exception.
`<E extends Throwable> Exceptional<T>`	`ifExceptionIs(Class<E> throwableClass, Consumer<? super E> consumer)` Invokes consumer function if exception class matches `throwableClass`.
`Exceptional<T>`	`ifPresent(Consumer<? super T> consumer)` Invokes consumer function with value if present.
`boolean`	`isPresent()` Checks value present (i.e. there were no exceptions).
`<U> Exceptional<U>`	`map(ThrowableFunction<? super T,? extends U,Throwable> mapper)` Invokes mapping function on inner value if there were no exceptions.
`static <T> Exceptional<T>`	`of(Throwable throwable)` Returns an `Exceptional` with throwable already set.
`static <T> Exceptional<T>`	`of(ThrowableSupplier<T,Throwable> supplier)` Returns an `Exceptional` with value provided by given `ThrowableSupplier` function.
`Exceptional<T>`	`or(Supplier<Exceptional<T>> supplier)` Returns current `Exceptional` if there were no exceptions, otherwise returns an `Exceptional` produced by supplier function.
`Exceptional<T>`	`recover(ThrowableFunction<Throwable,? extends T,Throwable> function)` Returns current `Exceptional` if there were no exceptions, otherwise calls `function` and wraps produced result with an `Exceptional`.
`Exceptional<T>`	`recoverWith(Function<Throwable,? extends Exceptional<T>> function)` Returns current `Exceptional` if there were no exceptions, otherwise returns an `Exceptional` produced by `function`.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - of
```
public static <T> Exceptional<T> of(ThrowableSupplier<T,Throwable> supplier)
```
    Returns an Exceptional with value provided by given ThrowableSupplier function.
    
    Type Parameters:
    
    T - the type of value
    
    Parameters:
    
    supplier - a supplier function
    
    Returns:
    
    an Exceptional
  - of
```
public static <T> Exceptional<T> of(Throwable throwable)
```
    Returns an Exceptional with throwable already set.
    
    Type Parameters:
    
    T - the type of value
    
    Parameters:
    
    throwable - throwable instance
    
    Returns:
    
    an Exceptional
  - get
```
public T get()
```
    Returns inner value.
    
    Returns:
    
    inner value.
  - isPresent
```
public boolean isPresent()
```
    Checks value present (i.e. there were no exceptions).
    
    Returns:
    
    true if a value present, false otherwise
  - getOrElse
```
public T getOrElse(T other)
```
    Returns inner value if there were no exceptions, otherwise returns other.
    
    Parameters:
    
    other - the value to be returned if there were any exception
    
    Returns:
    
    inner value if there were no exceptions, otherwise other
  - getOrElse
```
public T getOrElse(Supplier<? extends T> other)
```
    Returns inner value if there were no exceptions, otherwise returns value produced by supplier function.
    
    Parameters:
    
    other - the supplier function that produces value if there were any exception
    
    Returns:
    
    inner value if there were no exceptions, otherwise value produced by supplier function
    
    Since:
    
    1.1.9
  - getOptional
```
public Optional<T> getOptional()
```
    Wraps inner value with Optional container
    
    Returns:
    
    an Optional
  - getException
```
public Throwable getException()
```
    Returns exception.
    
    Returns:
    
    exception
  - getOrThrow
```
public T getOrThrow()
             throws Throwable
```
    Returns inner value if there were no exceptions, otherwise throws an exception.
    
    Returns:
    
    inner value if there were no exceptions
    
    Throws:
    
    Throwable - that was thrown in supplier function
  - getOrThrowRuntimeException
```
public T getOrThrowRuntimeException()
                             throws RuntimeException
```
    Returns inner value if there were no exceptions, otherwise throws RuntimeException.
    
    Returns:
    
    inner value if there were no exceptions
    
    Throws:
    
    RuntimeException - with wrapped exception which was thrown in supplier function
  - getOrThrow
```
public <E extends Throwable> T getOrThrow(E exception)
                                   throws E extends Throwable
```
    Returns inner value if there were no exceptions, otherwise throws the given exception.
    
    Type Parameters:
    
    E - the type of exception
    
    Parameters:
    
    exception - an exception to be thrown
    
    Returns:
    
    inner value if there were no exceptions
    
    Throws:
    
    E - if there were exceptions in supplier function
    
    E extends Throwable
  - or
```
public Exceptional<T> or(Supplier<Exceptional<T>> supplier)
```
    Returns current Exceptional if there were no exceptions, otherwise returns an Exceptional produced by supplier function.
    
    Parameters:
    
    supplier - supplier function that produced an Exceptional to be returned
    
    Returns:
    
    this Exceptional if there were no exceptions, otherwise an Exceptional produced by supplier function
    
    Throws:
    
    NullPointerException - if supplier or its result is null
  - custom
```
public <R> R custom(Function<Exceptional<T>,R> function)
```
    Applies custom operator on Exceptional.
    
    Type Parameters:
    
    R - the type of the result
    
    Parameters:
    
    function - a transforming function
    
    Returns:
    
    a result of the transforming function
    
    Throws:
    
    NullPointerException - if function is null
    
    Since:
    
    1.1.9
  - map
```
public <U> Exceptional<U> map(ThrowableFunction<? super T,? extends U,Throwable> mapper)
```
    Invokes mapping function on inner value if there were no exceptions.
    
    Type Parameters:
    
    U - the type of result value
    
    Parameters:
    
    mapper - mapping function
    
    Returns:
    
    an Exceptional with transformed value if there were no exceptions
    
    Throws:
    
    NullPointerException - if mapper is null
  - ifPresent
```
public Exceptional<T> ifPresent(Consumer<? super T> consumer)
```
    Invokes consumer function with value if present.
    
    Parameters:
    
    consumer - a consumer function
    
    Returns:
    
    this Exceptional
    
    Since:
    
    1.1.2
  - ifException
```
public Exceptional<T> ifException(Consumer<Throwable> consumer)
```
    Invokes consumer function if there were any exception.
    
    Parameters:
    
    consumer - a consumer function
    
    Returns:
    
    an Exceptional
  - ifExceptionIs
```
public <E extends Throwable> Exceptional<T> ifExceptionIs(Class<E> throwableClass,
                                                          Consumer<? super E> consumer)
```
    Invokes consumer function if exception class matches throwableClass.
    
    Type Parameters:
    
    E - the type of exception
    
    Parameters:
    
    throwableClass - the class of an exception to be compared
    
    consumer - a consumer function
    
    Returns:
    
    an Exceptional
  - recover
```
public Exceptional<T> recover(ThrowableFunction<Throwable,? extends T,Throwable> function)
```
    Returns current Exceptional if there were no exceptions, otherwise calls function and wraps produced result with an Exceptional.
    
    Parameters:
    
    function - recovering function
    
    Returns:
    
    this Exceptional if there were no exceptions, otherwise an Exceptional with wrapped recovering function result
    
    Throws:
    
    NullPointerException - if function is null
    
    Since:
    
    1.1.2
  - recoverWith
```
public Exceptional<T> recoverWith(Function<Throwable,? extends Exceptional<T>> function)
```
    Returns current Exceptional if there were no exceptions, otherwise returns an Exceptional produced by function.
    
    Parameters:
    
    function - recovering function
    
    Returns:
    
    this Exceptional if there were no exceptions, otherwise an Exceptional produced by recovering function
    
    Throws:
    
    NullPointerException - if function or produced result is null
    
    Since:
    
    1.1.2
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class Exceptional<T>

Method Summary

Methods inherited from class java.lang.Object

Method Detail

of

of

get

isPresent

getOrElse

getOrElse

getOptional

getException

getOrThrow

getOrThrowRuntimeException

getOrThrow

or

custom

map

ifPresent

ifException

ifExceptionIs

recover

recoverWith

equals

hashCode

toString