Try (Java Scala Utils 1.2 API)

Type Parameters:

T - The type of the value represented by this Option

All Superinterfaces:

Iterable<T>

All Known Implementing Classes:

Failure, Success
```
public interface Try<T>
extends Iterable<T>
```
The 'Try' type represents a computation that may either result in an exception, or return a successfully computed value.
Typical use case is situations where parallel computation takes place resulting in more than one response where it's possible that one or more computations fail.
Though it might not be desirable to raise an exception for failed computations hence the Try acts a place holder for a response that is either failed or successful.
Instances of 'Try', are either an instance of Success or Failure.

Since:

1.0

Author:

Peter Nerg

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`static <T> Try<T>`	`apply(T value)` Creates an instance of Try. If a `null` or non-throwable value is provided then `Success` is returned containing the value, else `Failure` containing the provided throwable.
`default Option<T>`	`asOption()` Returns this `Try` as an `Option`.
`Try<Throwable>`	`failed()` Completes this 'Try' with an exception wrapped in a `Success`. The exception is either the exception that the 'Try' failed with (if a `Failure`) or an 'UnsupportedOperationException'.
`<R> Try<R>`	`flatMap(java.util.function.Function<T,Try<R>> function)` Maps the given function to the value from this `Success` or returns `this` if this is a `Failure`.
`T`	`get()` Returns the value from this `Success` or throws the exception if this is a `Failure`.
`T`	`getOrElse(java.util.function.Supplier<T> supplier)` Returns the value from this `Success` or the value provided by the supplier if this is a `Failure`.
`default boolean`	`isFailure()` Returns `true` if the 'Try' is a `Failure`, `false` otherwise.
`boolean`	`isSuccess()` Returns `true` if the 'Try' is a `Success`, `false` otherwise.
`default Iterator<T>`	`iterator()` Returns the Try's value in an `Iterator` if it is a `Success`, or an empty `Iterator` if it is Failure.
`<R> Try<R>`	`map(java.util.function.Function<T,R> function)` Maps the given function to the value from this `Success` or returns `this` if this is a `Failure`.
`Try<T>`	`orElse(java.util.function.Supplier<Try<T>> supplier)` Returns this 'Try' if it's a `Success` or the value provided by the supplier if this is a `Failure`.
`default T`	`orNull()` Returns the value if it is a `Success`, else `null`.
`default java.util.stream.Stream<T>`	`stream()` Returns the Try's value in a Stream if it is a `Success`, or an empty Stream if it is a `Failure`. Should it be a `Success` containing a `null` value then the stream will also be empty.

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Method Detail
  - apply
```
static <T> Try<T> apply(T value)
```
    Creates an instance of Try.
    If a null or non-throwable value is provided then Success is returned containing the value, else Failure containing the provided throwable.
    
    Type Parameters:
    
    T - The type for the Try
    
    Parameters:
    
    value - The value for this to create a Try
    
    Returns:
    
    The Try instance
  - isFailure
```
default boolean isFailure()
```
    Returns true if the 'Try' is a Failure, false otherwise.
    
    Returns:
    
    If the Try is a Failure
  - isSuccess
```
boolean isSuccess()
```
    Returns true if the 'Try' is a Success, false otherwise.
    
    Returns:
    
    If the Try is a Success
  - getOrElse
```
T getOrElse(java.util.function.Supplier<T> supplier)
```
    Returns the value from this Success or the value provided by the supplier if this is a Failure.
    
    Parameters:
    
    supplier - The supplier to return the value in case of a Failure
    
    Returns:
    
    The value from the Try or the supplier
  - orNull
```
default T orNull()
```
    Returns the value if it is a Success, else null.
    
    Returns:
    
    The value of the Try or null.
  - orElse
```
Try<T> orElse(java.util.function.Supplier<Try<T>> supplier)
```
    Returns this 'Try' if it's a Success or the value provided by the supplier if this is a Failure.
    
    Parameters:
    
    supplier - The supplier to return the value in case of a Failure
    
    Returns:
    
    This try or the value from the supplier
  - get
```
T get()
throws Throwable
```
    Returns the value from this Success or throws the exception if this is a Failure.
    
    Returns:
    
    The value of the Try
    
    Throws:
    
    Throwable - The Throwable in case of a Failure
  - failed
```
Try<Throwable> failed()
```
    Completes this 'Try' with an exception wrapped in a Success.
    The exception is either the exception that the 'Try' failed with (if a Failure) or an 'UnsupportedOperationException'.
    
    Returns:
    
    The value of the Failure in a Success
  - iterator
```
default Iterator<T> iterator()
```
    Returns the Try's value in an Iterator if it is a Success, or an empty Iterator if it is Failure.
    Should it be a Success containing a null value then the iterator will also be empty.
    
    Specified by:
    
    iterator in interface Iterable<T>
    
    Returns:
    
    The iterator for the Try
  - map
```
<R> Try<R> map(java.util.function.Function<T,R> function)
```
    Maps the given function to the value from this Success or returns this if this is a Failure.
    
    Type Parameters:
    
    R - The type for the return value from the function
    
    Parameters:
    
    function - The function to use
    
    Returns:
    
    The Option containing the mapped value
  - flatMap
```
<R> Try<R> flatMap(java.util.function.Function<T,Try<R>> function)
```
    Maps the given function to the value from this Success or returns this if this is a Failure.
    
    Type Parameters:
    
    R - The type for the return value from the function
    
    Parameters:
    
    function - The function to use
    
    Returns:
    
    The Option containing the mapped value
    
    Since:
    
    1.2
  - stream
```
default java.util.stream.Stream<T> stream()
```
    Returns the Try's value in a Stream if it is a Success, or an empty Stream if it is a Failure.
    Should it be a Success containing a null value then the stream will also be empty.
    
    Returns:
    
    The stream for the Try
  - asOption
```
default Option<T> asOption()
```
    Returns this Try as an Option.
    If it is a Success then the value is wrapped in Some else None is returned.
    Should the Success contain a null value the result will be None.
    
    Returns:
    
    The Option representing this Try

Interface Try<T>

Method Summary

Methods inherited from interface java.lang.Iterable

Method Detail

apply

isFailure

isSuccess

getOrElse

orNull

orElse

get

failed

iterator

map

flatMap

stream

asOption