org.jooby.funzy

Class Try.Value<V>

java.lang.Object

org.jooby.funzy.Try

org.jooby.funzy.Try.Value<V>

Enclosing class:

Try

public abstract static class Try.Value<V>
extends Try

Try with a value.

Nested Class Summary

Nested classes/interfaces inherited from class org.jooby.funzy.Try

Try.ResourceHandler<R extends AutoCloseable>, Try.ResourceHandler2<R1 extends AutoCloseable,R2 extends AutoCloseable>, Try.ResourceHandler3<R1 extends AutoCloseable,R2 extends AutoCloseable,R3 extends AutoCloseable>, Try.ResourceHandler4<R1 extends AutoCloseable,R2 extends AutoCloseable,R3 extends AutoCloseable,R4 extends AutoCloseable>, Try.Value<V>

Constructor Summary

Constructors

Constructor and Description
Value()

Method Summary

Modifier and Type	Method and Description
<T> Try.Value<T>	flatMap(Throwing.Function<V,Try.Value<T>> mapper) Flat map the success value.
abstract V	get() Gets the success result or Throwing.sneakyThrow(Throwable) the exception.
<T> Try.Value<T>	map(Throwing.Function<V,T> mapper) Map the success value.
Try.Value<V>	onComplete(Throwing.Consumer<Throwable> action) Always run the given action, works like a finally clause.
Try.Value<V>	onComplete(Throwing.Consumer2<V,Throwable> action) Always run the given action, works like a finally clause.
Try.Value<V>	onComplete(Throwing.Runnable action) Always run the given action, works like a finally clause.
Try.Value<V>	onFailure(Consumer<? super Throwable> action) Run the given action if and only if this is a failure.
Try.Value<V>	onSuccess(Consumer<V> action) Run the given action if and only if this is a success.
Try.Value<V>	onSuccess(Runnable action) Run the given action if and only if this is a success.
V	orElse(V value) Get the success value or use the given default value on failure.
V	orElseGet(Supplier<V> value) Get the success value or use the given function on failure.
V	orElseThrow(Throwing.Function<Throwable,Throwable> provider) Get the success value or throw an exception created by the exception provider.
<X extends Throwable> Try.Value<V>	recover(Class<X> exception, Throwing.Function<X,V> fn) Recover from failure if and only if the exception is a subclass of the given exception filter.
<X extends Throwable> Try.Value<V>	recover(Class<X> exception, V value) Recover from failure if and only if the exception is a subclass of the given exception filter.
Try.Value<V>	recover(Throwing.Function<Throwable,V> fn) Recover from failure.
<X extends Throwable> Try.Value<V>	recoverWith(Class<X> exception, Throwing.Function<X,Try.Value<V>> fn) Recover from failure if and only if the exception is a subclass of the given exception filter.
Try.Value<V>	recoverWith(Throwing.Function<Throwable,Try.Value<V>> fn) Recover from failure.
Optional<V>	toOptional() Get an empty optional in case of failure.
<X extends Throwable> Try.Value<V>	unwrap(Class<? extends X> type) In case of failure unwrap the exception provided by calling Throwable.getCause().
Try.Value<V>	unwrap(Throwing.Predicate<Throwable> predicate) In case of failure unwrap the exception provided by calling Throwable.getCause().
<X extends Throwable> Try.Value<V>	wrap(Class<? extends X> predicate, Throwing.Function<X,Throwable> wrapper) In case of failure wrap an exception matching the given predicate to something else.
Try.Value<V>	wrap(Throwing.Function<Throwable,Throwable> wrapper) In case of failure wrap an exception matching the given predicate to something else.
<X extends Throwable> Try.Value<V>	wrap(Throwing.Predicate<X> predicate, Throwing.Function<X,Throwable> wrapper) In case of failure wrap an exception matching the given predicate to something else.

Methods inherited from class org.jooby.funzy.Try

apply, call, failure, getCause, isFailure, isSuccess, of, of, of, of, run, success, throwException, with, with, with, with

Methods inherited from class java.lang.Object

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

Constructor Detail

Value

public Value()

Method Detail

get

public abstract V get()

Gets the success result or Throwing.sneakyThrow(Throwable) the exception.

Returns:

The success result or Throwing.sneakyThrow(Throwable) the exception.

orElseGet

public V orElseGet(Supplier<V> value)

Get the success value or use the given function on failure.

Parameters:

value - Default value provider.

Returns:

Success or default value.

orElse

public V orElse(V value)

Get the success value or use the given default value on failure.

Parameters:

value - Default value.

Returns:

Success or default value.

orElseThrow

public V orElseThrow(Throwing.Function<Throwable,Throwable> provider)

Get the success value or throw an exception created by the exception provider.

Parameters:

provider - Exception provider.

Returns:

Success value.

onComplete

public Try.Value<V> onComplete(Throwing.Runnable action)

Always run the given action, works like a finally clause.

Overrides:

onComplete in class Try

Parameters:

action - Finally action.

Returns:

This try result.

onComplete

public Try.Value<V> onComplete(Throwing.Consumer<Throwable> action)

Description copied from class: Try

Always run the given action, works like a finally clause. Exception will be null in case of success.

Overrides:

onComplete in class Try

Parameters:

action - Finally action.

Returns:

This try result.

onComplete

public Try.Value<V> onComplete(Throwing.Consumer2<V,Throwable> action)

Always run the given action, works like a finally clause. Exception and value might be null. Exception will be null in case of success.

Parameters:

action - Finally action.

Returns:

This try result.

onFailure

public Try.Value<V> onFailure(Consumer<? super Throwable> action)

Run the given action if and only if this is a failure.

Overrides:

onFailure in class Try

Parameters:

action - Failure action/listener.

Returns:

This try.

onSuccess

public Try.Value<V> onSuccess(Runnable action)

Run the given action if and only if this is a success.

Overrides:

onSuccess in class Try

Parameters:

action - Success listener.

Returns:

This try.

onSuccess

public Try.Value<V> onSuccess(Consumer<V> action)

Run the given action if and only if this is a success.

Parameters:

action - Success listener.

Returns:

This try.

recoverWith

public Try.Value<V> recoverWith(Throwing.Function<Throwable,Try.Value<V>> fn)

Recover from failure. The recover function will be executed in case of failure.

Parameters:

fn - Recover function.

Returns:

This try on success, a new success try from recover or a failure try in case of exception.

recoverWith

public <X extends Throwable> Try.Value<V> recoverWith(Class<X> exception,
                                                      Throwing.Function<X,Try.Value<V>> fn)

Recover from failure if and only if the exception is a subclass of the given exception filter. The recover function will be executed in case of failure.

Type Parameters:

X - Exception type.

Parameters:

exception - Exception filter.

fn - Recover function.

Returns:

This try on success, a new success try from recover or a failure try in case of exception.

recover

public Try.Value<V> recover(Throwing.Function<Throwable,V> fn)

Recover from failure. The recover function will be executed in case of failure.

Parameters:

fn - Recover function.

Returns:

This try on success, a new success try from recover or a failure try in case of exception.

recover

public <X extends Throwable> Try.Value<V> recover(Class<X> exception,
                                                  V value)

Recover from failure if and only if the exception is a subclass of the given exception filter. The recover function will be executed in case of failure.

Type Parameters:

X - Exception type.

Parameters:

exception - Exception filter.

value - Recover value.

Returns:

This try on success, a new success try from recover or a failure try in case of exception.

recover

public <X extends Throwable> Try.Value<V> recover(Class<X> exception,
                                                  Throwing.Function<X,V> fn)

Recover from failure if and only if the exception is a subclass of the given exception filter. The recover function will be executed in case of failure.

Type Parameters:

X - Exception type.

Parameters:

exception - Exception filter.

fn - Recover function.

Returns:

This try on success, a new success try from recover or a failure try in case of exception.

flatMap

public <T> Try.Value<T> flatMap(Throwing.Function<V,Try.Value<T>> mapper)

Flat map the success value.

Type Parameters:

T - New type.

Parameters:

mapper - Mapper.

Returns:

A new try value for success or failure.

map

public <T> Try.Value<T> map(Throwing.Function<V,T> mapper)

Map the success value.

Type Parameters:

T - New type.

Parameters:

mapper - Mapper.

Returns:

A new try value for success or failure.

toOptional

public Optional<V> toOptional()

Get an empty optional in case of failure.

Returns:

An empty optional in case of failure.

unwrap

public <X extends Throwable> Try.Value<V> unwrap(Class<? extends X> type)

Description copied from class: Try

In case of failure unwrap the exception provided by calling Throwable.getCause(). Useful for clean/shorter stackstrace. Example for InvocationTargetException:

 Try.run(() -> {
   Method m = ...;
   m.invoke(...); //might throw InvocationTargetException
 }).unwrap(InvocationTargetException.class)
   .throwException();
 

Overrides:

unwrap in class Try

Type Parameters:

X - Exception type.

Parameters:

type - Exception filter.

Returns:

This try for success or a new failure with exception unwrap.

unwrap

public Try.Value<V> unwrap(Throwing.Predicate<Throwable> predicate)

Description copied from class: Try

In case of failure unwrap the exception provided by calling Throwable.getCause(). Useful for clean/shorter stackstrace. Example for InvocationTargetException:

 Try.run(() -> {
   Method m = ...;
   m.invoke(...); //might throw InvocationTargetException
 }).unwrap(InvocationTargetException.class::isInstance)
   .throwException();
 

Overrides:

unwrap in class Try

Parameters:

predicate - Exception filter.

Returns:

This try for success or a new failure with exception unwrap.

wrap

public Try.Value<V> wrap(Throwing.Function<Throwable,Throwable> wrapper)

Description copied from class: Try

In case of failure wrap an exception matching the given predicate to something else.

Overrides:

wrap in class Try

Parameters:

wrapper - Exception mapper.

Returns:

This try for success or a new failure with exception wrapped.

wrap

public <X extends Throwable> Try.Value<V> wrap(Class<? extends X> predicate,
                                               Throwing.Function<X,Throwable> wrapper)

Description copied from class: Try

In case of failure wrap an exception matching the given predicate to something else.

Overrides:

wrap in class Try

Type Parameters:

X - Exception type.

Parameters:

predicate - Exception predicate.

wrapper - Exception mapper.

Returns:

This try for success or a new failure with exception wrapped.

wrap

public <X extends Throwable> Try.Value<V> wrap(Throwing.Predicate<X> predicate,
                                               Throwing.Function<X,Throwable> wrapper)

Description copied from class: Try

In case of failure wrap an exception matching the given predicate to something else.

Overrides:

wrap in class Try

Type Parameters:

X - Exception type.

Parameters:

predicate - Exception predicate.

wrapper - Exception mapper.

Returns:

This try for success or a new failure with exception wrapped.