org.apache.archiva.common

Class Try<V>

java.lang.Object

org.apache.archiva.common.Try<V>

public abstract class Try<V>
extends Object

This is a class that can be used for the Try monad The Try monad is able to collect exceptions during processing of a stream.

Method Summary

Modifier and Type	Method and Description
static <V> Try<V>	failure(String message)
static <V> Try<V>	failure(String message, Throwable e)
static <V> Try<V>	failure(Throwable e) If you need type coercion, you should call this method as Try.
<U> Try<U>	flatMap(Function<? super V,Try<U>> fn) This is the bind method.
abstract V	get() Returns the value if this is a success instance.
abstract Throwable	getError() Returns the throwable that is stored in the failure.
abstract Boolean	isFailure()
abstract Boolean	isSuccess()
<U> Try<U>	map(Function<? super V,U> fn) A mapping method for mapping the current instance to a new type.
static <V> Try<V>	success(V value) Returns a instance for the success case.
abstract void	throwException()
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

isSuccess

public abstract Boolean isSuccess()

isFailure

public abstract Boolean isFailure()

throwException

public abstract void throwException()

get

public abstract V get()

Returns the value if this is a success instance. Otherwise throws a runtime exception with the stored throwable as cause.

Returns:

The value

getError

public abstract Throwable getError()

Returns the throwable that is stored in the failure.

Returns:

The Throwable or null.

map

public <U> Try<U> map(Function<? super V,U> fn)

A mapping method for mapping the current instance to a new type.

Type Parameters:

U -

Parameters:

fn -

Returns:

flatMap

public <U> Try<U> flatMap(Function<? super V,Try<U>> fn)

This is the bind method. If this instance is success the function will be applied. If any error occurs a failure instance will be returned. If this instance is failure a new failure will be returned.

Type Parameters:

U -

Parameters:

fn -

Returns:

failure

public static <V> Try<V> failure(String message)

failure

public static <V> Try<V> failure(String message,
                                 Throwable e)

failure

public static <V> Try<V> failure(Throwable e)

If you need type coercion, you should call this method as Try.<YOUR_TYPE>failure(e)

Type Parameters:

V - The generic type this monad keeps

Parameters:

e - The exception that is thrown

Returns:

A new Try instance that represents a failure.

success

public static <V> Try<V> success(V value)

Returns a instance for the success case.

Type Parameters:

V - The return type

Parameters:

value - The value that should be stored.

Returns:

A new Try instance with the given value

toString

public String toString()

Overrides:

toString in class Object