Package de.treestack.throwing

Interface Supplier<R,E extends Exception>

Type Parameters:
R - the type of the result of the function
E - the type of the exception that may be thrown
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 Supplier<R,E extends Exception>
Represents a function that accepts no arguments, produces a result and (optionally) throws an Exception.

This is a functional interface whose functional method is get() )}.

Since:
1.0

  • Method Summary

    Modifier and Type
    Method
    Description
    R
    get()
    Applies this function to the given argument.
    default Supplier<Optional<R>>
    lift()
    Lifts this function that may throw an exception into a function that returns an Optional.
    static <R> Supplier<Optional<R>>
    lifted(Supplier<? extends R,?> function)
    Lifts a function that may throw an exception into a function that returns an Optional.
    default Supplier<R>
    unchecked()
    Wraps this function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.
    static <R> Supplier<R>
    unchecked(Supplier<? extends R,?> function)
    Wraps a function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.

  • Method Details

    • get

      R get() throws E
      Applies this function to the given argument.
      Returns:
      the function result
      Throws:
      E - if an exception occurs
      Since:
      1.0

    • lifted

      static <R> Supplier<Optional<R>> lifted(Supplier<? extends R,?> function)
      Lifts a function that may throw an exception into a function that returns an Optional. If the original function throws an exception, the returned function will return an empty Optional. Otherwise, the returned function will return an Optional containing the result of the original function.
      Type Parameters:
      R - the type of the result of the function
      Parameters:
      function - the function to lift
      Returns:
      a function that returns an Optional
      Since:
      1.0

    • unchecked

      static <R> Supplier<R> unchecked(Supplier<? extends R,?> function)
      Wraps a function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.
      Type Parameters:
      R - the type of the result of the function
      Parameters:
      function - the function to wrap
      Returns:
      a function that will throw a RuntimeException if the original function throws an exception
      Since:
      1.0

    • lift

      default Supplier<Optional<R>> lift()
      Lifts this function that may throw an exception into a function that returns an Optional. If the original function throws an exception, the returned function will return an empty Optional. Otherwise, the returned function will return an Optional containing the result of the original function.
      Returns:
      a function that returns an Optional
      Since:
      1.0
      See Also:

    • unchecked

      default Supplier<R> unchecked()
      Wraps this function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.
      Returns:
      a function that will throw a RuntimeException if the original function throws an exception
      Since:
      1.0
      See Also: