Package io.vavr.control

Class Try.Success<T>

java.lang.Object

io.vavr.control.Try.Success<T>

Type Parameters:

T - the type of the contained value

All Implemented Interfaces:

Try<T>, Value<T>, java.io.Serializable, java.lang.Iterable<T>

Enclosing interface:

Try<T>

public static final class Try.Success<T>
extends java.lang.Object
implements Try<T>, java.io.Serializable

Represents a successful Try containing a value.

Instances of this class indicate that the computation completed successfully and hold the resulting value of type T.

 Try<Integer> success = new Try.Success<>(42);
 success.isSuccess(); // true
 success.get();       // 42
 

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface io.vavr.control.Try

Try.Failure<T>, Try.Success<T>, Try.WithResources1<T1 extends java.lang.AutoCloseable>, Try.WithResources2<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable>, Try.WithResources3<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable>, Try.WithResources4<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable>, Try.WithResources5<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable,T5 extends java.lang.AutoCloseable>, Try.WithResources6<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable,T5 extends java.lang.AutoCloseable,T6 extends java.lang.AutoCloseable>, Try.WithResources7<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable,T5 extends java.lang.AutoCloseable,T6 extends java.lang.AutoCloseable,T7 extends java.lang.AutoCloseable>, Try.WithResources8<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable,T5 extends java.lang.AutoCloseable,T6 extends java.lang.AutoCloseable,T7 extends java.lang.AutoCloseable,T8 extends java.lang.AutoCloseable>

Field Summary

Fields

Modifier and Type	Field	Description
private static long	serialVersionUID
private T	value

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Success(T value)	Constructs a Success.

Method Summary

Modifier and Type	Method	Description
boolean	equals(java.lang.Object obj)	Clarifies that values have a proper equals() method implemented.
T	get()	Returns the value of this Try if it is a Try.Success, or throws the underlying exception if it is a Try.Failure.
java.lang.Throwable	getCause()	Returns the cause of failure if this Try is a Try.Failure.
int	hashCode()	Clarifies that values have a proper hashCode() method implemented.
boolean	isEmpty()	Checks whether this Try contains no value, i.e., it is a Try.Failure.
boolean	isFailure()	Checks whether this Try is a Try.Failure.
boolean	isSuccess()	Checks whether this Try is a Try.Success.
java.lang.String	stringPrefix()	Returns the name of this Value type, which is used by toString().
java.lang.String	toString()	Clarifies that values have a proper toString() method implemented.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.vavr.control.Try

andFinally, andFinallyTry, andThen, andThen, andThenTry, andThenTry, collect, failed, filter, filter, filter, filterTry, filterTry, filterTry, flatMap, flatMapTry, fold, getOrElseGet, getOrElseThrow, isAsync, isLazy, isSingleValued, iterator, map, mapFailure, mapTo, mapToVoid, mapTry, onFailure, onFailure, onSuccess, orElse, orElse, orElseRun, peek, recover, recover, recover, recoverAllAndTry, recoverAndTry, recoverWith, recoverWith, recoverWith, toEither, toEither, toValidation, toValidation, transform

Methods inherited from interface io.vavr.Value

collect, collect, contains, corresponds, eq, exists, forAll, forEach, getOrElse, getOrElse, getOrElseThrow, getOrElseTry, getOrNull, out, out, spliterator, stderr, stdout, toArray, toCharSeq, toCompletableFuture, toEither, toEither, toInvalid, toInvalid, toJavaArray, toJavaArray, toJavaArray, toJavaCollection, toJavaList, toJavaList, toJavaMap, toJavaMap, toJavaMap, toJavaOptional, toJavaParallelStream, toJavaSet, toJavaSet, toJavaStream, toLeft, toLeft, toLinkedMap, toLinkedMap, toLinkedSet, toList, toMap, toMap, toOption, toPriorityQueue, toPriorityQueue, toQueue, toRight, toRight, toSet, toSortedMap, toSortedMap, toSortedMap, toSortedMap, toSortedSet, toSortedSet, toStream, toTree, toTree, toTry, toTry, toValid, toValid, toValidation, toValidation, toVector

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

value

private final T value

Constructor Detail

Success

private Success(T value)

Constructs a Success.

Parameters:

value - The value of this Success.

Method Detail

get

public T get()

Description copied from interface: Try

Returns the value of this Try if it is a Try.Success, or throws the underlying exception if it is a Try.Failure.

Important: If this Try is a Try.Failure, the exception thrown is exactly the Try.getCause() of this Failure. The underlying cause is thrown sneakily (without being declared in the method signature).

Specified by:

get in interface Try<T>

Specified by:

get in interface Value<T>

Returns:

the value contained in this Success

getCause

public java.lang.Throwable getCause()

Description copied from interface: Try

Returns the cause of failure if this Try is a Try.Failure.

Specified by:

getCause in interface Try<T>

Returns:

the throwable cause of this Try.Failure

isEmpty

public boolean isEmpty()

Description copied from interface: Try

Checks whether this Try contains no value, i.e., it is a Try.Failure.

Specified by:

isEmpty in interface Try<T>

Specified by:

isEmpty in interface Value<T>

Returns:

true if this is a Try.Failure, false if this is a Try.Success

isFailure

public boolean isFailure()

Description copied from interface: Try

Checks whether this Try is a Try.Failure.

Specified by:

isFailure in interface Try<T>

Returns:

true if this is a Try.Failure, false if this is a Try.Success

isSuccess

public boolean isSuccess()

Description copied from interface: Try

Checks whether this Try is a Try.Success.

Specified by:

isSuccess in interface Try<T>

Returns:

true if this is a Try.Success, false if this is a Try.Failure

equals

public boolean equals(java.lang.Object obj)

Description copied from interface: Value

Clarifies that values have a proper equals() method implemented.

See Object.equals(Object).

Specified by:

equals in interface Try<T>

Specified by:

equals in interface Value<T>

Overrides:

equals in class java.lang.Object

Parameters:

obj - An object

Returns:

true, if this equals o, false otherwise

hashCode

public int hashCode()

Description copied from interface: Value

Clarifies that values have a proper hashCode() method implemented.

See Object.hashCode().

Specified by:

hashCode in interface Try<T>

Specified by:

hashCode in interface Value<T>

Overrides:

hashCode in class java.lang.Object

Returns:

The hashcode of this object

stringPrefix

public java.lang.String stringPrefix()

Description copied from interface: Value

Returns the name of this Value type, which is used by toString().

Specified by:

stringPrefix in interface Value<T>

Returns:

This type name.

toString

public java.lang.String toString()

Description copied from interface: Value

Clarifies that values have a proper toString() method implemented.

See Object.toString().

Specified by:

toString in interface Try<T>

Specified by:

toString in interface Value<T>

Overrides:

toString in class java.lang.Object

Returns:

A String representation of this object