Package de.scravy.bedrock

Class Try<E>

java.lang.Object

de.scravy.bedrock.Try<E>

All Implemented Interfaces:

Iterable<E>

Direct Known Subclasses:

Try.Failure, Try.Success

@Immutable
public abstract class Try<E>
extends Object
implements Iterable<E>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Try.FailedRecoveringException
static class	Try.Failure<E>
static class	Try.RethrownException
static class	Try.Success<E>

Constructor Summary

Constructors

Constructor	Description
Try()

Method Summary

Modifier and Type	Method	Description
abstract void	consume(ThrowingConsumer<? super Exception> ifFailure, ThrowingConsumer<E> ifSuccess)
static <E> Try<E>	execute(Callable<E> callable)
static <E> Try<E>	failure(Exception exception)
abstract Try<E>	fallback(E value)
abstract Try<E>	fallbackWith(Supplier<E> value)
abstract Try<E>	filter(Predicate<? super E> predicate)
abstract <F> Try<F>	flatMap(ThrowingFunction<? super E,Try<F>> f)
<F> Try<F>	flatMapOptional(ThrowingFunction<? super E,Optional<F>> function)
abstract <F> F	fold(ThrowingFunction<? super Exception,F> ifFailure, ThrowingFunction<E,F> ifSuccess)
static <E> Try<E>	fromOptional(Optional<E> optional)
abstract E	get()
abstract Throwable	getException()
boolean	isFailure()
boolean	isSuccess()
static <A, R> Function<A,Try<R>>	lift(Function<A,R> function)
abstract <F> Try<F>	map(ThrowingFunction<? super E,? extends F> f)
abstract E	orElse(E value)
abstract E	orElseDo(ThrowingConsumer<Exception> block)
abstract E	orElseGet(Supplier<? extends E> supplier)
abstract E	orElseNull()
abstract E	orElseThrow()
abstract E	orElseThrowRuntime()
abstract Try<E>	otherwise(Try<E> alternative)
abstract <F> Try<F>	recover(ThrowingFunction<Exception,F> value)
abstract <F> Try<F>	recoverWith(ThrowingFunction<Exception,Try<F>> value)
static void	run(ThrowingRunnable runnable)	Tries to run the given ThrowingRunnable and throws a RuntimeException in case it fails.
static void	run(String message, ThrowingRunnable runnable)	Tries to run the given ThrowingRunnable and throws a RuntimeException with the given message in case it fails.
static <E> Try<E>	success(E element)
abstract Optional<E>	toOptional()
abstract Promise<E>	toPromise()
abstract <F> Try<F>	transform(ThrowingFunction<Exception,F> f, ThrowingFunction<E,F> g)
abstract <F> Try<F>	transformWith(ThrowingFunction<Exception,Try<F>> f, ThrowingFunction<E,Try<F>> g)
static void	unfailable(ThrowingRunnable runnable)	Runs the given ThrowingRunnable and catches all Exceptions, reporting them to the uncaught exception handler.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Constructor Details

Try

public Try()

Method Details

isSuccess

public boolean isSuccess()

isFailure

public boolean isFailure()

map

@Nonnull public abstract <F> Try<F> map(@Nonnull ThrowingFunction<? super E,? extends F> f)

flatMap

@Nonnull public abstract <F> Try<F> flatMap(@Nonnull ThrowingFunction<? super E,Try<F>> f)

flatMapOptional

@Nonnull public final <F> Try<F> flatMapOptional(@Nonnull ThrowingFunction<? super E,Optional<F>> function)

filter

@Nonnull public abstract Try<E> filter(@Nonnull Predicate<? super E> predicate)

recover

@Nonnull public abstract <F> Try<F> recover(@Nonnull ThrowingFunction<Exception,F> value)

recoverWith

@Nonnull public abstract <F> Try<F> recoverWith(@Nonnull ThrowingFunction<Exception,Try<F>> value)

orElse

public abstract E orElse(E value)

orElseDo

public abstract E orElseDo(ThrowingConsumer<Exception> block)

orElseGet

public abstract E orElseGet(@Nonnull Supplier<? extends E> supplier)

orElseNull

@Nullable public abstract E orElseNull()

orElseThrow

public abstract E orElseThrow() throws Try.RethrownException

Throws:

Try.RethrownException

orElseThrowRuntime

public abstract E orElseThrowRuntime()

get

public abstract E get()

getException

public abstract Throwable getException()

otherwise

@Nonnull public abstract Try<E> otherwise(@Nonnull Try<E> alternative)

transform

@Nonnull public abstract <F> Try<F> transform(@Nonnull ThrowingFunction<Exception,F> f, ThrowingFunction<E,F> g)

transformWith

@Nonnull public abstract <F> Try<F> transformWith(@Nonnull ThrowingFunction<Exception,Try<F>> f, ThrowingFunction<E,Try<F>> g)

fallback

@Nonnull public abstract Try<E> fallback(E value)

fallbackWith

@Nonnull public abstract Try<E> fallbackWith(@Nonnull Supplier<E> value)

fold

public abstract <F> F fold(@Nonnull ThrowingFunction<? super Exception,F> ifFailure, @Nonnull ThrowingFunction<E,F> ifSuccess)

consume

public abstract void consume(@Nonnull ThrowingConsumer<? super Exception> ifFailure, @Nonnull ThrowingConsumer<E> ifSuccess)

toOptional

@Nonnull public abstract Optional<E> toOptional()

toPromise

@Nonnull public abstract Promise<E> toPromise()

fromOptional

public static <E> Try<E> fromOptional(Optional<E> optional)

success

@Nonnull public static <E> Try<E> success(E element)

failure

@Nonnull public static <E> Try<E> failure(@Nonnull Exception exception)

execute

@Nonnull public static <E> Try<E> execute(@Nonnull Callable<E> callable)

run

public static void run(@Nonnull ThrowingRunnable runnable)

Tries to run the given ThrowingRunnable and throws a RuntimeException in case it fails.

If the given ThrowingRunnable throws a RuntimeException that Exception is rethrown.

Parameters:

runnable - A runnable which might throw a checked Exception.

run

public static void run(@Nonnull String message, @Nonnull ThrowingRunnable runnable)

Tries to run the given ThrowingRunnable and throws a RuntimeException with the given message in case it fails.

If the given ThrowingRunnable throws a RuntimeException it is not rethrown but wrapped in a new RuntimeException with the given message (just like a checked Exception).

Parameters:

message - The message to create the RuntimeException with in case it fails.

runnable - A runnable which might throw a checked Exception.

unfailable

public static void unfailable(@Nonnull ThrowingRunnable runnable)

Runs the given ThrowingRunnable and catches all Exceptions, reporting them to the uncaught exception handler.

Parameters:

runnable - A runnable which might throw a checked Exception.

lift

@Nonnull public static <A, R> Function<A,Try<R>> lift(@Nonnull Function<A,R> function)