de.flapdoodle.guava.monads

Class TryX<T>

java.lang.Object

de.flapdoodle.guava.monads.TryX<T>

public abstract class TryX<T>
extends Object

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TryX()

Method Summary

Methods

Modifier and Type	Method and Description
static <U> TryX<U>	failure(RuntimeException e) Factory method for failure.
abstract <U> TryX<U>	flatMap(com.google.common.base.Function<? super T,TryX<U>> f) Transform success or pass on failure, taking a Try as the result.
abstract T	get() Gets the value on Success or throws the cause of the failure.
abstract boolean	isSuccess()
abstract <U> TryX<U>	map(com.google.common.base.Function<? super T,? extends U> f) Transform success or pass on failure.
static <U> TryX<U>	ofFailable(com.google.common.base.Supplier<U> f)
abstract <F> TryX<T>	onFailure(com.google.common.base.Function<RuntimeException,F> f)
abstract T	orElse(T value) Return a value in the case of a failure.
abstract TryX<T>	orElseTry(com.google.common.base.Supplier<T> f) Return another try in the case of failure.
abstract T	recover(com.google.common.base.Function<? super RuntimeException,T> f) Specifies a result to use in case of failure.
abstract TryX<T>	recoverWith(com.google.common.base.Function<? super RuntimeException,TryX<T>> f) Try applying f(t) on the case of failure.
static <U> TryX<U>	successful(U x) Factory method for success.

Methods inherited from class java.lang.Object

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

Constructor Detail

TryX

protected TryX()

Method Detail

ofFailable

public static <U> TryX<U> ofFailable(com.google.common.base.Supplier<U> f)

map

public abstract <U> TryX<U> map(com.google.common.base.Function<? super T,? extends U> f)

Transform success or pass on failure. Takes an optional type parameter of the new type. You need to be specific about the new type if changing type

Try.ofFailable(() -> "1").map((x) -> Integer.valueOf(x))

Type Parameters:

U - new type (optional)

Parameters:

f - function to apply to successful value.

Returns:

Success or Failure

flatMap

public abstract <U> TryX<U> flatMap(com.google.common.base.Function<? super T,TryX<U>> f)

Transform success or pass on failure, taking a Try as the result. Takes an optional type parameter of the new type. You need to be specific about the new type if changing type.

Try.ofFailable(() -> "1").flatMap((x) -> Try.ofFailable(() ->Integer.valueOf(x))) returns Integer(1)

Type Parameters:

U - new type (optional)

Parameters:

f - function to apply to successful value.

Returns:

Success or Failure

recover

public abstract T recover(com.google.common.base.Function<? super RuntimeException,T> f)

Specifies a result to use in case of failure. Gives access to the exception which can be pattern matched on.

Try.ofFailable(() -> "not a number") .flatMap((x) -> Try.ofFailable(() ->Integer.valueOf(x))) .recover((t) -> 1) returns Integer(1)

Parameters:

f -

Returns:

recoverWith

public abstract TryX<T> recoverWith(com.google.common.base.Function<? super RuntimeException,TryX<T>> f)

Try applying f(t) on the case of failure.

Parameters:

f -

Returns:

a new Try in the case of failure, or the current Success.

orElse

public abstract T orElse(T value)

Return a value in the case of a failure. This is similar to recover but does not expose the exception type.

Parameters:

value -

Returns:

orElseTry

public abstract TryX<T> orElseTry(com.google.common.base.Supplier<T> f)

Return another try in the case of failure. Like recoverWith but without exposing the exception.

Parameters:

f -

Returns:

get

public abstract T get()

Gets the value on Success or throws the cause of the failure.

Returns:

isSuccess

public abstract boolean isSuccess()

onFailure

public abstract <F> TryX<T> onFailure(com.google.common.base.Function<RuntimeException,F> f)

failure

public static <U> TryX<U> failure(RuntimeException e)

Factory method for failure.

Type Parameters:

U -

Parameters:

e -

Returns:

a new Failure

successful

public static <U> TryX<U> successful(U x)

Factory method for success.

Type Parameters:

U -

Parameters:

x -

Returns:

a new Success