Module com.github.robtimus.function.throwing
Package com.github.robtimus.function.throwing

Interface ThrowingLongSupplier<X extends Throwable>

  • Type Parameters:
    X - The type of checked exception that can 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 ThrowingLongSupplier<X extends Throwable>
    Represents a supplier of long-valued results. This is a checked-exception throwing equivalent of LongSupplier.

    • Method Detail

      • getAsLong

        long getAsLong()
        throws X extends Throwable
        Gets a result.
        Returns:
        A result.
        Throws:
        X - If an error occurs.
        X extends Throwable

      • onErrorThrowAsChecked

        default <E extends Throwable> ThrowingLongSupplier<E> onErrorThrowAsChecked​(Function<? super X,​? extends E> errorMapper)
        Returns a supplier that calls this supplier. Any checked exception thrown by this supplier is transformed using the given error mapper, and the returned supplier throws the transformation result.
        Type Parameters:
        E - The type of checked exception to transform to.
        Parameters:
        errorMapper - The function to use to transform any checked exception thrown by this supplier.
        Returns:
        A supplier that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorMapper is null.

      • onErrorThrowAsUnchecked

        default <E extends RuntimeException> LongSupplier onErrorThrowAsUnchecked​(Function<? super X,​? extends E> errorMapper)
        Returns a supplier that calls this supplier. Any checked exception thrown by this supplier is transformed using the given error mapper, and the returned supplier throws the transformation result.
        Type Parameters:
        E - The type of unchecked exception to transform to.
        Parameters:
        errorMapper - The function to use to transform any checked exception thrown by this supplier.
        Returns:
        A supplier that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorMapper is null.

      • onErrorHandleChecked

        default <E extends Throwable> ThrowingLongSupplier<E> onErrorHandleChecked​(ThrowingToLongFunction<? super X,​? extends E> errorHandler)
        Returns a supplier that calls this supplier. Any checked exception thrown by this supplier is transformed using the given error handler, and the returned supplier returns the transformation result.
        Type Parameters:
        E - The type of checked exception that can be thrown by the given error handler.
        Parameters:
        errorHandler - The function to use to transform any checked exception thrown by this supplier.
        Returns:
        A supplier that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorHandler is null.

      • onErrorHandleUnchecked

        default LongSupplier onErrorHandleUnchecked​(ToLongFunction<? super X> errorHandler)
        Returns a supplier that calls this supplier. Any checked exception thrown by this supplier is transformed using the given error handler, and the returned supplier returns the transformation result.
        Parameters:
        errorHandler - The function to use to transform any checked exception thrown by this supplier.
        Returns:
        A supplier that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorHandler is null.

      • onErrorGetCheckedAsLong

        default <E extends Throwable> ThrowingLongSupplier<E> onErrorGetCheckedAsLong​(ThrowingLongSupplier<? extends E> fallback)
        Returns a supplier that calls this supplier. If this supplier throws any checked exception, it is discarded and the given fallback supplier is invoked.
        Type Parameters:
        E - The type of checked exception that can be thrown by the given fallback supplier.
        Parameters:
        fallback - The supplier to produce the value to return if this supplier throws any checked exception.
        Returns:
        A supplier that invokes the fallback supplier if this supplier throws any checked exception.
        Throws:
        NullPointerException - If fallback is null.

      • onErrorGetUncheckedAsLong

        default LongSupplier onErrorGetUncheckedAsLong​(LongSupplier fallback)
        Returns a supplier that calls this supplier. If this supplier throws any checked exception, it is discarded and the given fallback supplier is invoked.
        Parameters:
        fallback - The supplier to produce the value to return if this supplier throws any checked exception.
        Returns:
        A supplier that invokes the fallback supplier if this supplier throws any checked exception.
        Throws:
        NullPointerException - If fallback is null.

      • onErrorReturn

        default LongSupplier onErrorReturn​(long fallback)
        Returns a supplier that calls this supplier. If this supplier throws any checked exception, it is discarded and the given fallback value is returned.
        Parameters:
        fallback - The value to return if this supplier throws any checked exception.
        Returns:
        A supplier that returns the fallback value if this supplier throws any checked exception.

      • of

        static <X extends Throwable> ThrowingLongSupplier<X> of​(ThrowingLongSupplier<X> supplier)
        Factory method for turning ThrowingLongSupplier-shaped lambdas into ThrowingLongSuppliers.
        Type Parameters:
        X - The type of checked exception that can be thrown.
        Parameters:
        supplier - The lambda to return as ThrowingLongSupplier.
        Returns:
        The given lambda as a ThrowingLongSupplier.
        Throws:
        NullPointerException - If supplier is null.

      • checked

        static <X extends Throwable> ThrowingLongSupplier<X> checked​(LongSupplier supplier)
        Returns a supplier that calls the supplier supplier. Any unchecked exception thrown by the supplier supplier is relayed to the caller. This method allows existing LongSupplier instances to be used where ThrowingLongSupplier is expected.
        Type Parameters:
        X - The type of checked exception that can be thrown.
        Parameters:
        supplier - The supplier to call when the returned function is invoked.
        Returns:
        A supplier that wraps any checked exception in an UncheckedException.
        Throws:
        NullPointerException - If supplier is null.

      • checked

        static <X extends Throwable> ThrowingLongSupplier<X> checked​(LongSupplier supplier,
                                                             Class<X> errorType)
        Returns a supplier that calls the supplier supplier. Any UncheckedException thrown by the supplier supplier is unwrapped if its cause is an instance of errorType, otherwise it is relayed to the caller.
        Type Parameters:
        X - The type of checked exception that can be thrown.
        Parameters:
        supplier - The supplier to call when the returned supplier is invoked.
        errorType - The type of checked exception that can be thrown.
        Returns:
        A supplier that wraps any checked exception in an UncheckedException.
        Throws:
        NullPointerException - If supplier or errorType is null.