Type Parameters:

T - see Supplier

All Superinterfaces:

Supplier<Optional<T>>

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
```
@FunctionalInterface
public interface OptionalSupplier<T>
extends Supplier<Optional<T>>
```
Variation of Supplier that returns Optional instead of the raw value. OptionalSupplier is typically obtained from ExceptionHandler.supplier(Supplier), in which case its return value is empty when the underlying Supplier throws an exception. See noexception tutorial.

See Also:

ExceptionHandler.supplier(Supplier), Supplier

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method	Description
`Optional<T>`	`get()`	Variation of `Supplier.get()` that returns `Optional`.
`default Supplier<T>`	`orElse(T result)`	Converts this `OptionalSupplier` to plain `Supplier` using default value.
`default Supplier<T>`	`orElseGet(Supplier<T> source)`	Converts this `OptionalSupplier` to plain `Supplier` using fallback `Supplier`.

- Method Detail
  - get
```
Optional<T> get()
```
    Variation of Supplier.get() that returns Optional. If this OptionalSupplier is obtained from ExceptionHandler.supplier(Supplier), the Optional will be empty only if the underlying Supplier throws. Otherwise the returned Optional just wraps the return value of underlying Supplier (possibly null).
    
    Specified by:
    
    get in interface Supplier<T>
    
    Returns:
    
    Optional typically wrapping return value of Supplier.get(), or an empty Optional (typically signifying an exception)
    
    See Also:
    
    ExceptionHandler.supplier(Supplier), Supplier.get()
  - orElse
```
default Supplier<T> orElse(T result)
```
    Converts this OptionalSupplier to plain Supplier using default value. The returned Supplier will unwrap present value from the Optional if possible, or return result if the Optional is empty.
    
    Parameters:
    
    result - default value to return instead of an empty Optional
    
    Returns:
    
    plain Supplier that either unwraps Optional or returns default value
    
    See Also:
    
    orElseGet(Supplier), Optional.orElse(Object)
  - orElseGet
```
default Supplier<T> orElseGet(Supplier<T> source)
```
    Converts this OptionalSupplier to plain Supplier using fallback Supplier. The returned Supplier will unwrap present value from the Optional if possible, or fall back to calling source if the Optional is empty.
    
    Parameters:
    
    source - Supplier to query for fallback value when Optional is empty
    
    Returns:
    
    plain Supplier that either unwraps Optional or falls back to source
    
    See Also:
    
    orElse(Object), Optional.orElseGet(Supplier)

Interface OptionalSupplier<T>

Method Summary

Method Detail

get

orElse

orElseGet