Package io.vavr.control

Control structures like the disjoint union type Either, the optional value type Option and Try for exception handling.

Either

The control package contains an implementation of the Either control which is either Left or Right. A given Either is projected to a Left or a Right. Both cases can be further processed with control operations map, flatMap, filter. If a Right is projected to a Left, the Left control operations have no effect on the Right value. If a Left is projected to a Right, the Right control operations have no effect on the Left value.

Option

The Option control is a replacement for Optional. An Option is either Option.Some value or Option.None. In contrast to Optional, Option supports null values, i.e. it is possible to call new Some(null). However, Option.of(null) results in None.

Try

Exceptions are handled with the Try control which is either a Try.Success, containing a result, or a Try.Failure, containing an Exception.

Interface Summary

Interface	Description
Either<L,R>	Either represents a value of two possible types.
HashCodes	Deprecated. Will be removed from public API
Option<T>	Replacement for Optional.
Try<T>	The Try control gives us the ability write safe code without focusing on try-catch blocks in the presence of exceptions.
TryModule
Validation<E,T>	An implementation similar to scalaz's Validation control.

Class Summary

Class	Description
Either.Left<L,R>	The Left version of an Either.
Either.LeftProjection<L,R>	Deprecated. Either is right-biased.
Either.Right<L,R>	The Right version of an Either.
Either.RightProjection<L,R>	Deprecated. Either is right-biased.
Option.None<T>	None is a singleton representation of the undefined Option.
Option.Some<T>	Some represents a defined Option.
Try.Failure<T>	A failed Try.
Try.Success<T>	A succeeded Try.
Try.WithResources1<T1 extends java.lang.AutoCloseable>	A Try-with-resources builder that operates on one AutoCloseable resource.
Try.WithResources2<T1 extends java.lang.AutoCloseable,T2 extends java.lang.AutoCloseable>	A Try-with-resources builder that operates on two AutoCloseable resources.
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.
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.
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.
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.
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.
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.
TryModule.ThreadDeathResolver
Validation.Builder<E,T1,T2>
Validation.Builder3<E,T1,T2,T3>
Validation.Builder4<E,T1,T2,T3,T4>
Validation.Builder5<E,T1,T2,T3,T4,T5>
Validation.Builder6<E,T1,T2,T3,T4,T5,T6>
Validation.Builder7<E,T1,T2,T3,T4,T5,T6,T7>
Validation.Builder8<E,T1,T2,T3,T4,T5,T6,T7,T8>
Validation.Invalid<E,T>	An invalid Validation
Validation.Valid<E,T>	A valid Validation

Annotation Types Summary

Annotation Type	Description
GwtIncompatible