Try (vavr-champ 0.10.5 API)

java.lang.Object
- io.vavr.control.Try<T>

Type Parameters:

T - Value type in the case of success.

All Implemented Interfaces:

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

Direct Known Subclasses:

Try.Failure, Try.Success
```
public abstract class Try<T>
extends java.lang.Object
implements java.lang.Iterable<T>, Value<T>, java.io.Serializable
```
The Try control gives us the ability write safe code without focusing on try-catch blocks in the presence of exceptions.
The following exceptions are considered to be fatal/non-recoverable:
- InterruptedException
- LinkageError
- ThreadDeath
- VirtualMachineError (i.e. OutOfMemoryError or StackOverflowError)
Important note: Try may re-throw (undeclared) exceptions, e.g. on get(). From within a dynamic proxy InvocationHandler this will lead to an UndeclaredThrowableException. For more information, please read Dynamic Proxy Classes.
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Try.Failure<T>` Deprecated. will be removed from the public API
`static class`	`Try.Success<T>` Deprecated. will be removed from the public API
`static class`	`Try.WithResources1<T1 extends java.lang.AutoCloseable>` A `Try`-with-resources builder that operates on one `AutoCloseable` resource.
`static class`	`Try.WithResources2<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable>` A `Try`-with-resources builder that operates on two `AutoCloseable` resources.
`static class`	`Try.WithResources3<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable>` A `Try`-with-resources builder that operates on three `AutoCloseable` resources.
`static class`	`Try.WithResources4<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable>` A `Try`-with-resources builder that operates on four `AutoCloseable` resources.
`static class`	`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>` A `Try`-with-resources builder that operates on five `AutoCloseable` resources.
`static class`	`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>` A `Try`-with-resources builder that operates on six `AutoCloseable` resources.
`static class`	`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>` A `Try`-with-resources builder that operates on seven `AutoCloseable` resources.
`static class`	`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>` A `Try`-with-resources builder that operates on eight `AutoCloseable` resources.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`Try<T>`	`andFinally(java.lang.Runnable runnable)` Provides try's finally behavior no matter what the result of the operation is.
`Try<T>`	`andFinallyTry(CheckedRunnable runnable)` Provides try's finally behavior no matter what the result of the operation is.
`Try<T>`	`andThen(java.util.function.Consumer<? super T> consumer)` Shortcut for `andThenTry(consumer::accept)`, see `andThenTry(CheckedConsumer)`.
`Try<T>`	`andThen(java.lang.Runnable runnable)` Shortcut for `andThenTry(runnable::run)`, see `andThenTry(CheckedRunnable)`.
`Try<T>`	`andThenTry(CheckedConsumer<? super T> consumer)` Passes the result to the given `consumer` if this is a `Success`.
`Try<T>`	`andThenTry(CheckedRunnable runnable)` Runs the given runnable if this is a `Success`, otherwise returns this `Failure`.
`<R> Try<R>`	`collect(PartialFunction<? super T,? extends R> partialFunction)` Collects value that is in the domain of the given `partialFunction` by mapping the value to type `R`.
`Try<java.lang.Throwable>`	`failed()` Returns `Success(throwable)` if this is a `Failure(throwable)`, otherwise a `Failure(new NoSuchElementException("Success.failed()"))` if this is a Success.
`static <T> Try<T>`	`failure(java.lang.Throwable exception)` Creates a `Try.Failure` that contains the given `exception`.
`Try<T>`	`filter(java.util.function.Predicate<? super T> predicate)` Shortcut for `filterTry(predicate::test)`, see `filterTry(CheckedPredicate)`}.
`Try<T>`	`filter(java.util.function.Predicate<? super T> predicate, java.util.function.Function<? super T,? extends java.lang.Throwable> errorProvider)` Shortcut for `filterTry(predicate::test, errorProvider::apply)`, see `filterTry(CheckedPredicate, CheckedFunction1)`}.
`Try<T>`	`filter(java.util.function.Predicate<? super T> predicate, java.util.function.Supplier<? extends java.lang.Throwable> throwableSupplier)` Shortcut for `filterTry(predicate::test, throwableSupplier)`, see `filterTry(CheckedPredicate, Supplier)`}.
`Try<T>`	`filterNot(java.util.function.Predicate<? super T> predicate)` Contrary to filter, see `filter(Predicate)`.
`Try<T>`	`filterNot(java.util.function.Predicate<? super T> predicate, java.util.function.Function<? super T,? extends java.lang.Throwable> errorProvider)` Contrary to filter, see `filter(Predicate, Function)`.
`Try<T>`	`filterNot(java.util.function.Predicate<? super T> predicate, java.util.function.Supplier<? extends java.lang.Throwable> throwableSupplier)` Contrary to filter, see `filter(Predicate, Supplier)`.
`Try<T>`	`filterTry(CheckedPredicate<? super T> predicate)` Returns `this` if this is a Failure or this is a Success and the value satisfies the predicate.
`Try<T>`	`filterTry(CheckedPredicate<? super T> predicate, CheckedFunction1<? super T,? extends java.lang.Throwable> errorProvider)` Returns `this` if this is a Failure or this is a Success and the value satisfies the predicate.
`Try<T>`	`filterTry(CheckedPredicate<? super T> predicate, java.util.function.Supplier<? extends java.lang.Throwable> throwableSupplier)` Returns `this` if this is a Failure or this is a Success and the value satisfies the predicate.
`<U> Try<U>`	`flatMap(java.util.function.Function<? super T,? extends Try<? extends U>> mapper)` Shortcut for `flatMapTry(mapper::apply)`, see `flatMapTry(CheckedFunction1)`.
`<U> Try<U>`	`flatMapTry(CheckedFunction1<? super T,? extends Try<? extends U>> mapper)` FlatMaps the value of a Success or returns a Failure.
`<X> X`	`fold(java.util.function.Function<? super java.lang.Throwable,? extends X> ifFail, java.util.function.Function<? super T,? extends X> f)` Folds either the `Failure` or the `Success` side of the Try value.
`abstract T`	`get()` Gets the result of this Try if this is a `Success` or throws if this is a `Failure`.
`abstract java.lang.Throwable`	`getCause()` Gets the cause if this is a Failure or throws if this is a Success.
`T`	`getOrElseGet(java.util.function.Function<? super java.lang.Throwable,? extends T> other)`
`<X extends java.lang.Throwable> T`	`getOrElseThrow(java.util.function.Function<? super java.lang.Throwable,X> exceptionProvider)`
`boolean`	`isAsync()` A `Try`'s value is computed synchronously.
`abstract boolean`	`isEmpty()` Checks whether this Try has no result, i.e.
`abstract boolean`	`isFailure()` Checks if this is a Failure.
`boolean`	`isLazy()` A `Try`'s value is computed eagerly.
`boolean`	`isSingleValued()` A `Try` is a single-valued.
`abstract boolean`	`isSuccess()` Checks if this is a Success.
`Iterator<T>`	`iterator()` Returns a rich `io.vavr.collection.Iterator`.
`<U> Try<U>`	`map(java.util.function.Function<? super T,? extends U> mapper)` Shortcut for `mapTry(mapper::apply)`, see `mapTry(CheckedFunction1)`.
`Try<T>`	`mapFailure(API.Match.Case<? extends java.lang.Throwable,? extends java.lang.Throwable>... cases)` Maps the cause to a new exception if this is a `Failure` or returns this instance if this is a `Success`.
`Try<T>`	`mapFailure(java.util.function.Function<? super java.lang.Throwable,? extends java.lang.Throwable> mapper)` Maps the cause to a new exception if this is a `Failure` or returns this instance if this is a `Success`.
`<U> Try<U>`	`mapTry(CheckedFunction1<? super T,? extends U> mapper)` Runs the given checked function if this is a `Try.Success`, passing the result of the current expression to it.
`static <T> Try<T>`	`narrow(Try<? extends T> t)` Narrows a widened `Try<? extends T>` to `Try<T>` by performing a type-safe cast.
`static <T> Try<T>`	`of(CheckedFunction0<? extends T> supplier)` Creates a Try of a CheckedFunction0.
`static <T> Try<T>`	`ofCallable(java.util.concurrent.Callable<? extends T> callable)` Creates a Try of a Callable.
`static <T> Try<T>`	`ofSupplier(java.util.function.Supplier<? extends T> supplier)` Creates a Try of a Supplier.
`<X extends java.lang.Throwable> Try<T>`	`onFailure(java.lang.Class<X> exceptionType, java.util.function.Consumer<? super X> action)` Consumes the cause if this is a `Try.Failure` and the cause is instance of `X`.
`Try<T>`	`onFailure(java.util.function.Consumer<? super java.lang.Throwable> action)` Consumes the cause if this is a `Try.Failure`.
`Try<T>`	`onSuccess(java.util.function.Consumer<? super T> action)` Consumes the value if this is a `Try.Success`.
`Try<T>`	`orElse(java.util.function.Supplier<? extends Try<? extends T>> supplier)`
`Try<T>`	`orElse(Try<? extends T> other)`
`void`	`orElseRun(java.util.function.Consumer<? super java.lang.Throwable> action)`
`Try<T>`	`peek(java.util.function.Consumer<? super T> action)` Applies the action to the value of a Success or does nothing in the case of a Failure.
`Try<T>`	`peek(java.util.function.Consumer<? super java.lang.Throwable> failureAction, java.util.function.Consumer<? super T> successAction)` Applies the `successAction` to the value if this is a Success or applies the `failureAction` to the cause of failure.
`<X extends java.lang.Throwable> Try<T>`	`recover(java.lang.Class<X> exceptionType, java.util.function.Function<? super X,? extends T> f)` Returns `this`, if this is a `Success` or this is a `Failure` and the cause is not assignable from `cause.getClass()`.
`<X extends java.lang.Throwable> Try<T>`	`recover(java.lang.Class<X> exceptionType, T value)` Returns `this`, if this is a `Try.Success` or this is a `Failure` and the cause is not assignable from `cause.getClass()`.
`Try<T>`	`recover(java.util.function.Function<? super java.lang.Throwable,? extends T> f)` Returns `this`, if this is a `Success`, otherwise tries to recover the exception of the failure with `f`, i.e.
`<X extends java.lang.Throwable> Try<T>`	`recoverWith(java.lang.Class<X> exceptionType, java.util.function.Function<? super X,Try<? extends T>> f)` Returns `this`, if this is a `Success` or this is a `Failure` and the cause is not assignable from `cause.getClass()`.
`<X extends java.lang.Throwable> Try<T>`	`recoverWith(java.lang.Class<X> exceptionType, Try<? extends T> recovered)` Recovers this `Try` with the given `recovered`, if this is a `Try.Failure` and the given `exceptionType` is assignable to the underlying cause type.
`Try<T>`	`recoverWith(java.util.function.Function<? super java.lang.Throwable,? extends Try<? extends T>> f)` Returns `this`, if this is a Success, otherwise tries to recover the exception of the failure with `f`, i.e.
`static Try<java.lang.Void>`	`run(CheckedRunnable runnable)` Creates a Try of a CheckedRunnable.
`static Try<java.lang.Void>`	`runRunnable(java.lang.Runnable runnable)` Creates a Try of a Runnable.
`static <T> Try<Seq<T>>`	`sequence(java.lang.Iterable<? extends Try<? extends T>> values)` Reduces many `Try`s into a single `Try` by transforming an `Iterable<Try<? extends T>>` into a `Try<Seq<T>>`.
`static <T> Try<T>`	`success(T value)` Creates a `Try.Success` that contains the given `value`.
`Either<java.lang.Throwable,T>`	`toEither()` Converts this `Try` to an `Either`.
`Validation<java.lang.Throwable,T>`	`toValidation()` Converts this `Try` to a `Validation`.
`<U> Validation<U,T>`	`toValidation(java.util.function.Function<? super java.lang.Throwable,? extends U> throwableMapper)` Converts this `Try` to a `Validation`, converting the Throwable (if present) to another object using passed `Function`.
`<U> U`	`transform(java.util.function.Function<? super Try<T>,? extends U> f)` Transforms this `Try`.
`static <T,U> Try<Seq<U>>`	`traverse(java.lang.Iterable<? extends T> values, java.util.function.Function<? super T,? extends Try<? extends U>> mapper)` Maps the values of an iterable to a sequence of mapped values into a single `Try` by transforming an `Iterable<? extends T>` into a `Try<Seq<U>>`.
`static <T1 extends java.lang.AutoCloseable> Try.WithResources1<T1>`	`withResources(CheckedFunction0<? extends T1> t1Supplier)` Creates a `Try`-with-resources builder that operates on one `AutoCloseable` resource.
`static <T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable> Try.WithResources2<T1,T2>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier)` Creates a `Try`-with-resources builder that operates on two `AutoCloseable` resources.
`static <T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable> Try.WithResources3<T1,T2,T3>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier, CheckedFunction0<? extends T3> t3Supplier)` Creates a `Try`-with-resources builder that operates on three `AutoCloseable` resources.
`static <T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable> Try.WithResources4<T1,T2,T3,T4>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier, CheckedFunction0<? extends T3> t3Supplier, CheckedFunction0<? extends T4> t4Supplier)` Creates a `Try`-with-resources builder that operates on four `AutoCloseable` resources.
`static <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.WithResources5<T1,T2,T3,T4,T5>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier, CheckedFunction0<? extends T3> t3Supplier, CheckedFunction0<? extends T4> t4Supplier, CheckedFunction0<? extends T5> t5Supplier)` Creates a `Try`-with-resources builder that operates on five `AutoCloseable` resources.
`static <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.WithResources6<T1,T2,T3,T4,T5,T6>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier, CheckedFunction0<? extends T3> t3Supplier, CheckedFunction0<? extends T4> t4Supplier, CheckedFunction0<? extends T5> t5Supplier, CheckedFunction0<? extends T6> t6Supplier)` Creates a `Try`-with-resources builder that operates on six `AutoCloseable` resources.
`static <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.WithResources7<T1,T2,T3,T4,T5,T6,T7>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier, CheckedFunction0<? extends T3> t3Supplier, CheckedFunction0<? extends T4> t4Supplier, CheckedFunction0<? extends T5> t5Supplier, CheckedFunction0<? extends T6> t6Supplier, CheckedFunction0<? extends T7> t7Supplier)` Creates a `Try`-with-resources builder that operates on seven `AutoCloseable` resources.
`static <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> Try.WithResources8<T1,T2,T3,T4,T5,T6,T7,T8>`	`withResources(CheckedFunction0<? extends T1> t1Supplier, CheckedFunction0<? extends T2> t2Supplier, CheckedFunction0<? extends T3> t3Supplier, CheckedFunction0<? extends T4> t4Supplier, CheckedFunction0<? extends T5> t5Supplier, CheckedFunction0<? extends T6> t6Supplier, CheckedFunction0<? extends T7> t7Supplier, CheckedFunction0<? extends T8> t8Supplier)` Creates a `Try`-with-resources builder that operates on eight `AutoCloseable` resources.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.vavr.Value
collect, collect, contains, corresponds, eq, equals, exists, forAll, forEach, getOrElse, getOrElse, getOrElseThrow, getOrElseTry, getOrNull, hashCode, narrow, out, out, spliterator, stderr, stdout, stringPrefix, 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, toString, toTree, toTree, toTry, toTry, toValid, toValid, toValidation, toValidation, toVector

Method Detail

of

public static <T> Try<T> of(CheckedFunction0<? extends T> supplier)

Creates a Try of a CheckedFunction0.


 // Returns Success(String)
 Try.of(() -> Class.forName("java.lang.String"));

 // Returns Failure(ClassNotFoundException)
 Try.of(() -> Class.forName("not a class"));

Type Parameters:: T - Component type
Parameters:: supplier - A checked supplier
Returns:: Success(supplier.apply()) if no exception occurs, otherwise Failure(throwable) if an exception occurs calling supplier.apply().

ofSupplier

public static <T> Try<T> ofSupplier(java.util.function.Supplier<? extends T> supplier)

Creates a Try of a Supplier.


 // Returns Success(123)
 Try.ofSupplier(() -> Integer.parseInt("123"));

 // Returns Failure(NumberFormatException)
 Try.ofSupplier(() -> Integer.parseInt("not a number"));

Type Parameters:: T - Component type
Parameters:: supplier - A supplier
Returns:: Success(supplier.get()) if no exception occurs, otherwise Failure(throwable) if an exception occurs calling supplier.get().

ofCallable

public static <T> Try<T> ofCallable(java.util.concurrent.Callable<? extends T> callable)

Creates a Try of a Callable.


 // Returns Success("hello")
 Try.ofCallable(() -> "hello");

 // Returns Failure(Exception)
 Try.ofCallable(() -> {
   throw new Exception("An unknown error occurred.");
 });

Type Parameters:: T - Component type
Parameters:: callable - A callable
Returns:: Success(callable.call()) if no exception occurs, otherwise Failure(throwable) if an exception occurs calling callable.call().

run

public static Try<java.lang.Void> run(CheckedRunnable runnable)

Creates a Try of a CheckedRunnable.


 // Returns Success(null)
 Try.run(() -> doSomeAction());

 // Returns Failure(Exception)
 Try.run(() -> {
   throw new Exception("An unknown error occurred.");
 });

Parameters:: runnable - A checked runnable
Returns:: Success(null) if no exception occurs, otherwise Failure(throwable) if an exception occurs calling runnable.run().

runRunnable

public static Try<java.lang.Void> runRunnable(java.lang.Runnable runnable)

Creates a Try of a Runnable.


 // Returns Success(null)
 Try.runRunnable(() -> doSomeAction());

 // Returns Failure(RuntimeException)
 Try.runRunnable(() -> {
   throw new RuntimeException("An unknown error occurred.");
 });

Parameters:: runnable - A runnable
Returns:: Success(null) if no exception occurs, otherwise Failure(throwable) if an exception occurs calling runnable.run().

sequence

public static <T> Try<Seq<T>> sequence(java.lang.Iterable<? extends Try<? extends T>> values)

Reduces many Trys into a single Try by transforming an Iterable<Try<? extends T>> into a Try<Seq<T>>. If any of the Trys are Try.Failure, then this returns a Try.Failure.


 Try<String> first = Try.success("hello");
 Try<String> second = Try.success("world");
 Try<String> third = Try.failure(new Exception());

 // Returns Success(Vector("hello", "world"))
 Try<Seq<String>> success = Try.sequence(Arrays.asList(first, second));

 // Returns Failure(Exception)
 Try<Seq<String>> failure = Try.sequence(Arrays.asList(first, second, third));

Type Parameters:: T - type of the Trys
Parameters:: values - An Iterable of Trys
Returns:: A Try of a Seq of results
Throws:: java.lang.NullPointerException - if values is null

traverse

public static <T,U> Try<Seq<U>> traverse(java.lang.Iterable<? extends T> values,
                                         java.util.function.Function<? super T,? extends Try<? extends U>> mapper)

Maps the values of an iterable to a sequence of mapped values into a single Try by transforming an Iterable<? extends T> into a Try<Seq>.


 Function<String, Try<Integer>> mapper = number -> Try.of(() -> Integer.parseInt(number));

 // Returns Success(Vector(123, 456))
 Try<Seq<Integer>> success = Try.traverse(Arrays.asList("123", "456"), mapper);

 // Returns Failure(NumberFormatException)
 Try<Seq<Integer>> failure = Try.traverse(Arrays.asList("not", "a number"), mapper);

Type Parameters:: T - The type of the given values.; U - The mapped value type.
Parameters:: values - An Iterable of values.; mapper - A mapper of values to Trys
Returns:: A Try of a Seq of results.
Throws:: java.lang.NullPointerException - if values or f is null.

success
```
public static <T> Try<T> success(T value)
```
Creates a Try.Success that contains the given value.
```
 // Returns Success(123)
 Try<Integer> success = Try.success(123);
 
```
Type Parameters:

T - Type of the given value.

Parameters:

value - A value.

Returns:

A new Success.

failure

public static <T> Try<T> failure(java.lang.Throwable exception)

Creates a Try.Failure that contains the given exception.


 // Returns Failure(NumberFormatException)
 Try<Integer> failure = Try.failure(new NumberFormatException());

Type Parameters:: T - Component type of the Try.
Parameters:: exception - An exception.
Returns:: A new Failure.

narrow
```
public static <T> Try<T> narrow(Try<? extends T> t)
```
Narrows a widened Try<? extends T> to Try<T> by performing a type-safe cast. This is eligible because immutable/read-only collections are covariant.
```
 // Returns Success(123)
 Try<Integer> number = Try.success(123);
 Try<Number> numberNumber = Try.narrow(number);
 
```
Type Parameters:

T - Component type of the Try.

Parameters:

t - A Try.

Returns:

the given t instance as narrowed type Try<T>.

andThen
```
public final Try<T> andThen(java.util.function.Consumer<? super T> consumer)
```
Shortcut for andThenTry(consumer::accept), see andThenTry(CheckedConsumer).

Parameters:

consumer - A consumer

Returns:

this Try if this is a Failure or the consumer succeeded, otherwise the Failure of the consumption.

Throws:

java.lang.NullPointerException - if consumer is null

andThenTry
```
public final Try<T> andThenTry(CheckedConsumer<? super T> consumer)
```
Passes the result to the given consumer if this is a Success.
The main use case is chaining checked functions using method references:
```
 
 Try.of(() -> 100)
 .andThen(i -> System.out.println(i));

 
 
```
Parameters:

consumer - A checked consumer

Returns:

this Try if this is a Failure or the consumer succeeded, otherwise the Failure of the consumption.

Throws:

java.lang.NullPointerException - if consumer is null

andThen
```
public final Try<T> andThen(java.lang.Runnable runnable)
```
Shortcut for andThenTry(runnable::run), see andThenTry(CheckedRunnable).

Parameters:

runnable - A runnable

Returns:

this Try if this is a Failure or the runnable succeeded, otherwise the Failure of the run.

Throws:

java.lang.NullPointerException - if runnable is null

andThenTry
```
public final Try<T> andThenTry(CheckedRunnable runnable)
```
Runs the given runnable if this is a Success, otherwise returns this Failure.
The main use case is chaining runnables using method references:
```
 
 Try.run(A::methodRef).andThen(B::methodRef).andThen(C::methodRef);
 
 
```
Please note that these lines are semantically the same:
```
 
 Try.run(this::doStuff)
 .andThen(this::doMoreStuff)
 .andThen(this::doEvenMoreStuff);

 Try.run(() -> {
 doStuff();
 doMoreStuff();
 doEvenMoreStuff();
 });
 
 
```
Parameters:

runnable - A checked runnable

Returns:

this Try if this is a Failure or the runnable succeeded, otherwise the Failure of the run.

Throws:

java.lang.NullPointerException - if runnable is null

collect
```
public final <R> Try<R> collect(PartialFunction<? super T,? extends R> partialFunction)
```
Collects value that is in the domain of the given partialFunction by mapping the value to type R.
```
 partialFunction.isDefinedAt(value)
 
```
If the element makes it through that filter, the mapped instance is wrapped in Try
```
 R newValue = partialFunction.apply(value)
 
```
Type Parameters:

R - The new value type

Parameters:

partialFunction - A function that is not necessarily defined on value of this try.

Returns:

A new Try instance containing value of type R

Throws:

java.lang.NullPointerException - if partialFunction is null

failed
```
public final Try<java.lang.Throwable> failed()
```
Returns Success(throwable) if this is a Failure(throwable), otherwise a Failure(new NoSuchElementException("Success.failed()")) if this is a Success.

Returns:

a new Try

filter
```
public final Try<T> filter(java.util.function.Predicate<? super T> predicate,
 java.util.function.Supplier<? extends java.lang.Throwable> throwableSupplier)
```
Shortcut for filterTry(predicate::test, throwableSupplier), see filterTry(CheckedPredicate, Supplier)}.

Parameters:

predicate - A predicate

throwableSupplier - A supplier of a throwable

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate or throwableSupplier is null

filter
```
public final Try<T> filter(java.util.function.Predicate<? super T> predicate,
 java.util.function.Function<? super T,? extends java.lang.Throwable> errorProvider)
```
Shortcut for filterTry(predicate::test, errorProvider::apply), see filterTry(CheckedPredicate, CheckedFunction1)}.

Parameters:

predicate - A predicate

errorProvider - A function that provides some kind of Throwable for T

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate or errorProvider is null

filter
```
public final Try<T> filter(java.util.function.Predicate<? super T> predicate)
```
Shortcut for filterTry(predicate::test), see filterTry(CheckedPredicate)}.

Parameters:

predicate - A predicate

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate is null

filterNot
```
public final Try<T> filterNot(java.util.function.Predicate<? super T> predicate,
 java.util.function.Supplier<? extends java.lang.Throwable> throwableSupplier)
```
Contrary to filter, see filter(Predicate, Supplier).

Parameters:

predicate - A predicate

throwableSupplier - A supplier of a throwable

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate or throwableSupplier is null

filterNot
```
public final Try<T> filterNot(java.util.function.Predicate<? super T> predicate,
 java.util.function.Function<? super T,? extends java.lang.Throwable> errorProvider)
```
Contrary to filter, see filter(Predicate, Function).

Parameters:

predicate - A predicate

errorProvider - A function that provides some kind of Throwable for T

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate or errorProvider is null

filterNot
```
public final Try<T> filterNot(java.util.function.Predicate<? super T> predicate)
```
Contrary to filter, see filter(Predicate).

Parameters:

predicate - A predicate

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate is null

filterTry
```
public final Try<T> filterTry(CheckedPredicate<? super T> predicate,
 java.util.function.Supplier<? extends java.lang.Throwable> throwableSupplier)
```
Returns this if this is a Failure or this is a Success and the value satisfies the predicate.
Returns a new Failure, if this is a Success and the value does not satisfy the Predicate or an exception occurs testing the predicate. The returned Failure wraps a Throwable instance provided by the given throwableSupplier.

Parameters:

predicate - A checked predicate

throwableSupplier - A supplier of a throwable

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate or throwableSupplier is null

filterTry
```
public final Try<T> filterTry(CheckedPredicate<? super T> predicate,
 CheckedFunction1<? super T,? extends java.lang.Throwable> errorProvider)
```
Returns this if this is a Failure or this is a Success and the value satisfies the predicate.
Returns a new Failure, if this is a Success and the value does not satisfy the Predicate or an exception occurs testing the predicate. The returned Failure wraps a Throwable instance provided by the given errorProvider.

Parameters:

predicate - A checked predicate

errorProvider - A provider of a throwable

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate or errorProvider is null

filterTry
```
public final Try<T> filterTry(CheckedPredicate<? super T> predicate)
```
Returns this if this is a Failure or this is a Success and the value satisfies the predicate.
Returns a new Failure, if this is a Success and the value does not satisfy the Predicate or an exception occurs testing the predicate. The returned Failure wraps a NoSuchElementException instance.

Parameters:

predicate - A checked predicate

Returns:

a Try instance

Throws:

java.lang.NullPointerException - if predicate is null

flatMap
```
public final  Try flatMap(java.util.function.Function<? super T,? extends Try<? extends U>> mapper)
```
Shortcut for flatMapTry(mapper::apply), see flatMapTry(CheckedFunction1).

Type Parameters:

U - The new component type

Parameters:

mapper - A mapper

Returns:

a Try

Throws:

java.lang.NullPointerException - if mapper is null

flatMapTry
```
public final  Try flatMapTry(CheckedFunction1<? super T,? extends Try<? extends U>> mapper)
```
FlatMaps the value of a Success or returns a Failure.

Type Parameters:

U - The new component type

Parameters:

mapper - A mapper

Returns:

a Try

Throws:

java.lang.NullPointerException - if mapper is null

get
```
public abstract T get()
```
Gets the result of this Try if this is a Success or throws if this is a Failure.
IMPORTANT! If this is a Try.Failure, the underlying cause of type Throwable is thrown.
The thrown exception is exactly the same as the result of getCause().

Specified by:

get in interface Value<T>

Returns:

The result of this Try.

getCause
```
public abstract java.lang.Throwable getCause()
```
Gets the cause if this is a Failure or throws if this is a Success.

Returns:

The cause if this is a Failure

Throws:

java.lang.UnsupportedOperationException - if this is a Success

isAsync
```
public final boolean isAsync()
```
A Try's value is computed synchronously.

Specified by:

isAsync in interface Value<T>

Returns:

false

isEmpty
```
public abstract boolean isEmpty()
```
Checks whether this Try has no result, i.e. is a Failure.

Specified by:

isEmpty in interface Value<T>

Returns:

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

isFailure
```
public abstract boolean isFailure()
```
Checks if this is a Failure.

Returns:

true, if this is a Failure, otherwise false, if this is a Success

isLazy
```
public final boolean isLazy()
```
A Try's value is computed eagerly.

Specified by:

isLazy in interface Value<T>

Returns:

false

isSingleValued
```
public final boolean isSingleValued()
```
A Try is a single-valued.

Specified by:

isSingleValued in interface Value<T>

Returns:

true

isSuccess
```
public abstract boolean isSuccess()
```
Checks if this is a Success.

Returns:

true, if this is a Success, otherwise false, if this is a Failure

iterator
```
public final Iterator<T> iterator()
```
Description copied from interface: Value

Returns a rich io.vavr.collection.Iterator.

Specified by:

iterator in interface Value<T>

Specified by:

iterator in interface java.lang.Iterable<T>

Returns:

A new Iterator

map
```
public final  Try map(java.util.function.Function<? super T,? extends U> mapper)
```
Shortcut for mapTry(mapper::apply), see mapTry(CheckedFunction1).

Specified by:

map in interface Value<T>

Type Parameters:

U - The new component type

Parameters:

mapper - A checked function

Returns:

a Try

Throws:

java.lang.NullPointerException - if mapper is null

mapFailure
```
@SafeVarargs
public final Try<T> mapFailure(API.Match.Case<? extends java.lang.Throwable,? extends java.lang.Throwable>... cases)
```
Maps the cause to a new exception if this is a Failure or returns this instance if this is a Success.
If none of the given cases matches the cause, the same Failure is returned.

Parameters:

cases - A not necessarily exhaustive sequence of cases that will be matched against a cause.

Returns:

A new Try if this is a Failure, otherwise this.

mapFailure
```
public final Try<T> mapFailure(java.util.function.Function<? super java.lang.Throwable,? extends java.lang.Throwable> mapper)
```
Maps the cause to a new exception if this is a Failure or returns this instance if this is a Success.

Parameters:

mapper - A function that maps the cause of a failure to another exception.

Returns:

A new Try if this is a Failure, otherwise this.

Throws:

java.lang.NullPointerException - if mapper is null.

mapTry
```
public final  Try mapTry(CheckedFunction1<? super T,? extends U> mapper)
```
Runs the given checked function if this is a Try.Success, passing the result of the current expression to it. If this expression is a Try.Failure then it'll return a new Try.Failure of type R with the original exception.
The main use case is chaining checked functions using method references:
```
 
 Try.of(() -> 0)
 .map(x -> 1 / x); // division by zero
 
 
```
Type Parameters:

U - The new component type

Parameters:

mapper - A checked function

Returns:

a Try

Throws:

java.lang.NullPointerException - if mapper is null

onFailure

public final Try<T> onFailure(java.util.function.Consumer<? super java.lang.Throwable> action)

Consumes the cause if this is a Try.Failure.


 // (does not print anything)
 Try.success(1).onFailure(System.out::println);

 // prints "java.lang.Error"
 Try.failure(new Error()).onFailure(System.out::println);

Parameters:: action - An exception consumer
Returns:: this
Throws:: java.lang.NullPointerException - if action is null

onFailure

public final <X extends java.lang.Throwable> Try<T> onFailure(java.lang.Class<X> exceptionType,
                                                              java.util.function.Consumer<? super X> action)

Consumes the cause if this is a Try.Failure and the cause is instance of X.


 // (does not print anything)
 Try.success(1).onFailure(Error.class, System.out::println);

 // prints "Error"
 Try.failure(new Error())
    .onFailure(RuntimeException.class, x -> System.out.println("Runtime exception"))
    .onFailure(Error.class, x -> System.out.println("Error"));

Type Parameters:: X - the exception type that should be handled
Parameters:: exceptionType - the exception type that is handled; action - an excpetion consumer
Returns:: this
Throws:: java.lang.NullPointerException - if exceptionType or action is null

onSuccess

public final Try<T> onSuccess(java.util.function.Consumer<? super T> action)

Consumes the value if this is a Try.Success.


 // prints "1"
 Try.success(1).onSuccess(System.out::println);

 // (does not print anything)
 Try.failure(new Error()).onSuccess(System.out::println);

Parameters:: action - A value consumer
Returns:: this
Throws:: java.lang.NullPointerException - if action is null

orElse

public final Try<T> orElse(Try<? extends T> other)

orElse

public final Try<T> orElse(java.util.function.Supplier<? extends Try<? extends T>> supplier)

getOrElseGet

public final T getOrElseGet(java.util.function.Function<? super java.lang.Throwable,? extends T> other)

orElseRun

public final void orElseRun(java.util.function.Consumer<? super java.lang.Throwable> action)

getOrElseThrow

public final <X extends java.lang.Throwable> T getOrElseThrow(java.util.function.Function<? super java.lang.Throwable,X> exceptionProvider)
                                                       throws X extends java.lang.Throwable

Throws:: X extends java.lang.Throwable

fold
```
public final <X> X fold(java.util.function.Function<? super java.lang.Throwable,? extends X> ifFail,
 java.util.function.Function<? super T,? extends X> f)
```
Folds either the Failure or the Success side of the Try value.

Type Parameters:

X - type of the folded value

Parameters:

ifFail - maps the left value if this is a Failure

f - maps the value if this is a Success

Returns:

A value of type X

peek
```
public final Try<T> peek(java.util.function.Consumer<? super java.lang.Throwable> failureAction,
 java.util.function.Consumer<? super T> successAction)
```
Applies the successAction to the value if this is a Success or applies the failureAction to the cause of failure.

Parameters:

failureAction - A Consumer for the Failure case

successAction - A Consumer for the Success case

Returns:

this Try

peek
```
public final Try<T> peek(java.util.function.Consumer<? super T> action)
```
Applies the action to the value of a Success or does nothing in the case of a Failure.

Specified by:

peek in interface Value<T>

Parameters:

action - A Consumer

Returns:

this Try

Throws:

java.lang.NullPointerException - if action is null

recover

public final <X extends java.lang.Throwable> Try<T> recover(java.lang.Class<X> exceptionType,
                                                            java.util.function.Function<? super X,? extends T> f)

Returns this, if this is a Success or this is a Failure and the cause is not assignable from cause.getClass(). Otherwise tries to recover the exception of the failure with f, i.e. calling Try.of(() -> f.apply((X) getCause()).


 // = Success(13)
 Try.of(() -> 27/2).recover(ArithmeticException.class, x -> Integer.MAX_VALUE);

 // = Success(2147483647)
 Try.of(() -> 1/0)
    .recover(Error.class, x -> -1)
    .recover(ArithmeticException.class, x -> Integer.MAX_VALUE);

 // = Failure(java.lang.ArithmeticException: / by zero)
 Try.of(() -> 1/0).recover(Error.class, x -> Integer.MAX_VALUE);

Type Parameters:: X - Exception type
Parameters:: exceptionType - The specific exception type that should be handled; f - A recovery function taking an exception of type X
Returns:: a Try
Throws:: java.lang.NullPointerException - if exception is null or f is null

recoverWith
```
public final <X extends java.lang.Throwable> Try<T> recoverWith(java.lang.Class<X> exceptionType,
 java.util.function.Function<? super X,Try<? extends T>> f)
```
Returns this, if this is a Success or this is a Failure and the cause is not assignable from cause.getClass(). Otherwise tries to recover the exception of the failure with f which returns Try. If isFailure() returned by f function is true it means that recovery cannot take place due to some circumstances.
```
 // = Success(13)
 Try.of(() -> 27/2).recoverWith(ArithmeticException.class, x -> Try.success(Integer.MAX_VALUE));

 // = Success(2147483647)
 Try.of(() -> 1/0)
 .recoverWith(Error.class, x -> Try.success(-1))
 .recoverWith(ArithmeticException.class, x -> Try.success(Integer.MAX_VALUE));

 // = Failure(java.lang.ArithmeticException: / by zero)
 Try.of(() -> 1/0).recoverWith(Error.class, x -> Try.success(Integer.MAX_VALUE));
 
```
Type Parameters:

X - Exception type

Parameters:

exceptionType - The specific exception type that should be handled

f - A recovery function taking an exception of type X and returning Try as a result of recovery. If Try is isSuccess() then recovery ends up successfully. Otherwise the function was not able to recover.

Returns:

a Try

Throws:

java.lang.NullPointerException - if exceptionType or f is null

recoverWith

public final <X extends java.lang.Throwable> Try<T> recoverWith(java.lang.Class<X> exceptionType,
                                                                Try<? extends T> recovered)

Recovers this Try with the given recovered, if this is a Try.Failure and the given exceptionType is assignable to the underlying cause type.


 // = Success(13)
 Try.of(() -> 27/2).recoverWith(ArithmeticException.class, Try.success(Integer.MAX_VALUE));

 // = Success(2147483647)
 Try.of(() -> 1/0)
    .recoverWith(Error.class, Try.success(-1))
    .recoverWith(ArithmeticException.class, Try.success(Integer.MAX_VALUE));

 // = Failure(java.lang.ArithmeticException: / by zero)
 Try.of(() -> 1/0).recoverWith(Error.class, Try.success(Integer.MAX_VALUE));

Type Parameters:: X - type of the exception that should be recovered
Parameters:: exceptionType - the exception type that is recovered; recovered - the substitute for a matching Failure
Returns:: the given recovered if this is a Try.Failure and the cause is of type X, else this
Throws:: java.lang.NullPointerException - if exceptionType or recovered is null

recover

public final <X extends java.lang.Throwable> Try<T> recover(java.lang.Class<X> exceptionType,
                                                            T value)

Returns this, if this is a Try.Success or this is a Failure and the cause is not assignable from cause.getClass(). Otherwise returns a Try.Success containing the given value.


 // = Success(13)
 Try.of(() -> 27/2).recover(ArithmeticException.class, Integer.MAX_VALUE);

 // = Success(2147483647)
 Try.of(() -> 1/0)
    .recover(Error.class, -1);
    .recover(ArithmeticException.class, Integer.MAX_VALUE);

 // = Failure(java.lang.ArithmeticException: / by zero)
 Try.of(() -> 1/0).recover(Error.class, Integer.MAX_VALUE);

Type Parameters:: X - Exception type
Parameters:: exceptionType - The specific exception type that should be handled; value - A value that is used in case of a recovery
Returns:: a Try
Throws:: java.lang.NullPointerException - if exception is null

recover
```
public final Try<T> recover(java.util.function.Function<? super java.lang.Throwable,? extends T> f)
```
Returns this, if this is a Success, otherwise tries to recover the exception of the failure with f, i.e. calling Try.of(() -> f.apply(throwable)).
```
 // = Success(13)
 Try.of(() -> 27/2).recover(x -> Integer.MAX_VALUE);

 // = Success(2147483647)
 Try.of(() -> 1/0).recover(x -> Integer.MAX_VALUE);
 
```
Parameters:

f - A recovery function taking a Throwable

Returns:

a Try

Throws:

java.lang.NullPointerException - if f is null

recoverWith
```
public final Try<T> recoverWith(java.util.function.Function<? super java.lang.Throwable,? extends Try<? extends T>> f)
```
Returns this, if this is a Success, otherwise tries to recover the exception of the failure with f, i.e. calling f.apply(cause.getCause()). If an error occurs recovering a Failure, then the new Failure is returned.
```
 // = Success(13)
 Try.of(() -> 27/2).recoverWith(x -> Try.success(Integer.MAX_VALUE));

 // = Success(2147483647)
 Try.of(() -> 1/0).recoverWith(x -> Try.success(Integer.MAX_VALUE));
 
```
Parameters:

f - A recovery function taking a Throwable

Returns:

a Try

Throws:

java.lang.NullPointerException - if f is null

toEither

public final Either<java.lang.Throwable,T> toEither()

Converts this Try to an Either.

Returns:: A new Either

toValidation
```
public final Validation<java.lang.Throwable,T> toValidation()
```
Converts this Try to a Validation.

Returns:

A new Validation

toValidation
```
public final  Validation<U,T> toValidation(java.util.function.Function<? super java.lang.Throwable,? extends U> throwableMapper)
```
Converts this Try to a Validation, converting the Throwable (if present) to another object using passed Function.
```
 Validation<String, Integer> = Try.of(() -> 1/0).toValidation(Throwable::getMessage));
 
```
Type Parameters:

U - result type of the throwable mapper

Parameters:

throwableMapper - A transformation from throwable to desired invalid type of new Validation

Returns:

A new Validation

Throws:

java.lang.NullPointerException - if the given throwableMapper is null.

transform
```
public final  U transform(java.util.function.Function<? super Try<T>,? extends U> f)
```
Transforms this Try.

Type Parameters:

U - Type of transformation result

Parameters:

f - A transformation

Returns:

An instance of type U

Throws:

java.lang.NullPointerException - if f is null

andFinally
```
public final Try<T> andFinally(java.lang.Runnable runnable)
```
Provides try's finally behavior no matter what the result of the operation is.

Parameters:

runnable - A runnable

Returns:

this Try.

Throws:

java.lang.NullPointerException - if runnable is null

andFinallyTry
```
public final Try<T> andFinallyTry(CheckedRunnable runnable)
```
Provides try's finally behavior no matter what the result of the operation is.

Parameters:

runnable - A runnable

Returns:

this Try.

Throws:

java.lang.NullPointerException - if runnable is null

withResources
```
public static <T1 extends java.lang.AutoCloseable> Try.WithResources1<T1> withResources(CheckedFunction0<? extends T1> t1Supplier)
```
Creates a Try-with-resources builder that operates on one AutoCloseable resource.

Type Parameters:

T1 - Type of the 1st resource.

Parameters:

t1Supplier - The supplier of the first resource.

Returns:

a new Try.WithResources1 instance.

withResources

public static <T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable> Try.WithResources2<T1,T2> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                              CheckedFunction0<? extends T2> t2Supplier)

Creates a Try-with-resources builder that operates on two AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.
Returns:: a new Try.WithResources2 instance.

withResources

public static <T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable> Try.WithResources3<T1,T2,T3> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                                                                    CheckedFunction0<? extends T2> t2Supplier,
                                                                                                                                                                    CheckedFunction0<? extends T3> t3Supplier)

Creates a Try-with-resources builder that operates on three AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.; T3 - Type of the 3rd resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.; t3Supplier - The supplier of the 3rd resource.
Returns:: a new Try.WithResources3 instance.

withResources

public static <T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable,T3 extends java.lang.AutoCloseable,T4 extends java.lang.AutoCloseable> Try.WithResources4<T1,T2,T3,T4> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                                                                                                          CheckedFunction0<? extends T2> t2Supplier,
                                                                                                                                                                                                          CheckedFunction0<? extends T3> t3Supplier,
                                                                                                                                                                                                          CheckedFunction0<? extends T4> t4Supplier)

Creates a Try-with-resources builder that operates on four AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.; T3 - Type of the 3rd resource.; T4 - Type of the 4th resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.; t3Supplier - The supplier of the 3rd resource.; t4Supplier - The supplier of the 4th resource.
Returns:: a new Try.WithResources4 instance.

withResources

public static <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.WithResources5<T1,T2,T3,T4,T5> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                                                                                                                                                CheckedFunction0<? extends T2> t2Supplier,
                                                                                                                                                                                                                                                CheckedFunction0<? extends T3> t3Supplier,
                                                                                                                                                                                                                                                CheckedFunction0<? extends T4> t4Supplier,
                                                                                                                                                                                                                                                CheckedFunction0<? extends T5> t5Supplier)

Creates a Try-with-resources builder that operates on five AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.; T3 - Type of the 3rd resource.; T4 - Type of the 4th resource.; T5 - Type of the 5th resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.; t3Supplier - The supplier of the 3rd resource.; t4Supplier - The supplier of the 4th resource.; t5Supplier - The supplier of the 5th resource.
Returns:: a new Try.WithResources5 instance.

withResources

public static <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.WithResources6<T1,T2,T3,T4,T5,T6> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                                                                                                                                                                                      CheckedFunction0<? extends T2> t2Supplier,
                                                                                                                                                                                                                                                                                      CheckedFunction0<? extends T3> t3Supplier,
                                                                                                                                                                                                                                                                                      CheckedFunction0<? extends T4> t4Supplier,
                                                                                                                                                                                                                                                                                      CheckedFunction0<? extends T5> t5Supplier,
                                                                                                                                                                                                                                                                                      CheckedFunction0<? extends T6> t6Supplier)

Creates a Try-with-resources builder that operates on six AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.; T3 - Type of the 3rd resource.; T4 - Type of the 4th resource.; T5 - Type of the 5th resource.; T6 - Type of the 6th resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.; t3Supplier - The supplier of the 3rd resource.; t4Supplier - The supplier of the 4th resource.; t5Supplier - The supplier of the 5th resource.; t6Supplier - The supplier of the 6th resource.
Returns:: a new Try.WithResources6 instance.

withResources

public static <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.WithResources7<T1,T2,T3,T4,T5,T6,T7> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                                                                                                                                                                                                                            CheckedFunction0<? extends T2> t2Supplier,
                                                                                                                                                                                                                                                                                                                            CheckedFunction0<? extends T3> t3Supplier,
                                                                                                                                                                                                                                                                                                                            CheckedFunction0<? extends T4> t4Supplier,
                                                                                                                                                                                                                                                                                                                            CheckedFunction0<? extends T5> t5Supplier,
                                                                                                                                                                                                                                                                                                                            CheckedFunction0<? extends T6> t6Supplier,
                                                                                                                                                                                                                                                                                                                            CheckedFunction0<? extends T7> t7Supplier)

Creates a Try-with-resources builder that operates on seven AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.; T3 - Type of the 3rd resource.; T4 - Type of the 4th resource.; T5 - Type of the 5th resource.; T6 - Type of the 6th resource.; T7 - Type of the 7th resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.; t3Supplier - The supplier of the 3rd resource.; t4Supplier - The supplier of the 4th resource.; t5Supplier - The supplier of the 5th resource.; t6Supplier - The supplier of the 6th resource.; t7Supplier - The supplier of the 7th resource.
Returns:: a new Try.WithResources7 instance.

withResources

public static <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> Try.WithResources8<T1,T2,T3,T4,T5,T6,T7,T8> withResources(CheckedFunction0<? extends T1> t1Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T2> t2Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T3> t3Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T4> t4Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T5> t5Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T6> t6Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T7> t7Supplier,
                                                                                                                                                                                                                                                                                                                                                                  CheckedFunction0<? extends T8> t8Supplier)

Creates a Try-with-resources builder that operates on eight AutoCloseable resources.

Type Parameters:: T1 - Type of the 1st resource.; T2 - Type of the 2nd resource.; T3 - Type of the 3rd resource.; T4 - Type of the 4th resource.; T5 - Type of the 5th resource.; T6 - Type of the 6th resource.; T7 - Type of the 7th resource.; T8 - Type of the 8th resource.
Parameters:: t1Supplier - The supplier of the 1st resource.; t2Supplier - The supplier of the 2nd resource.; t3Supplier - The supplier of the 3rd resource.; t4Supplier - The supplier of the 4th resource.; t5Supplier - The supplier of the 5th resource.; t6Supplier - The supplier of the 6th resource.; t7Supplier - The supplier of the 7th resource.; t8Supplier - The supplier of the 8th resource.
Returns:: a new Try.WithResources8 instance.

Class Try<T>

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface io.vavr.Value

Method Detail

of

ofSupplier

ofCallable

run

runRunnable

sequence

traverse

success

failure

narrow

andThen

andThenTry

andThen

andThenTry

collect

failed

filter

filter

filter

filterNot

filterNot

filterNot

filterTry

filterTry

filterTry

flatMap

flatMapTry

get

getCause

isAsync

isEmpty

isFailure

isLazy

isSingleValued

isSuccess

iterator

map

mapFailure

mapFailure

mapTry

onFailure

onFailure

onSuccess

orElse

orElse

getOrElseGet

orElseRun

getOrElseThrow

fold

peek

peek

recover

recoverWith

recoverWith

recover

recover

recoverWith

toEither

toValidation

toValidation

transform

andFinally

andFinallyTry

withResources

withResources

withResources

withResources

withResources

withResources

withResources

withResources