com.leakyabstractions.result.lazy

Class LazyResults

java.lang.Object

com.leakyabstractions.result.lazy.LazyResults

public class LazyResults
extends Object

This class consists exclusively of static methods that return lazy Result instances.

Author:

Guillermo Calvo

See Also:

com.leakyabstractions.result, com.leakyabstractions.result.lazy

Method Summary

Modifier and Type	Method and Description
static <S,F> Result<S,F>	ofSupplier(Supplier<Result<S,F>> supplier) Creates a new lazy result based on the given result supplier.

Methods inherited from class java.lang.Object

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

Method Detail

ofSupplier

public static <S,F> Result<S,F> ofSupplier(Supplier<Result<S,F>> supplier)

Creates a new lazy result based on the given result supplier.

Type Parameters:

S - the success type of the result

F - the failure type of the result

Parameters:

supplier - the function that supplies the actual result

Returns:

the new lazy result

Throws:

NullPointerException - if supplier is null

See Also:

LazyConsumer.of(Consumer)

API Note:

The supplier is not allowed to return null or throw any exceptions. If it does, then the lazy result will relay the thrown exception (or NullPointerException) to its caller when/if it needs to be evaluated. If the lazy result needs to be evaluated again, it will throw NoSuchElementException (instead of trying to invoke supplier again). This ensures that supplier will be invoked at most once.