Package ch.powerunit.extensions.exceptions

Interface ObjLongConsumerWithException<T,E extends Exception>

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception of the operation

All Superinterfaces:

ExceptionHandlerSupport<ObjLongConsumer<T>,ObjLongConsumer<T>,ObjLongConsumerWithException<T,E>>, NoReturnExceptionHandlerSupport<ObjLongConsumer<T>,BiFunction<T,Long,CompletionStage<Void>>,ObjLongConsumerWithException<T,E>>

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 ObjLongConsumerWithException<T,E extends Exception>
extends NoReturnExceptionHandlerSupport<ObjLongConsumer<T>,BiFunction<T,Long,CompletionStage<Void>>,ObjLongConsumerWithException<T,E>>

Represents an operation that accepts an object-valued and a long-valued argument, and returns no result. This is the (reference, long) specialization of BiConsumerWithException. Unlike most other functional interfaces, ObjLongConsumerWithException is expected to operate via side-effects.

General contract

• void accept(T t, long value) throws E - The functional method.
• uncheck - Return a ObjLongConsumer<T>
• lift - Return a ObjLongConsumer<T>
• ignore - Return a ObjLongConsumer<T>

See Also:

ObjLongConsumer

Method Summary

Modifier and Type	Method	Description
void	accept(T t, long value)	Performs this operation on the given arguments.
static <T,E extends Exception> BiConsumerWithException<T,Long,E>	asBiConsumer(ObjLongConsumerWithException<T,E> operation)	Converts a ObjLongConsumerWithException to a BiConsumerWithException returning null.
static <T,E extends Exception> ObjLongConsumerWithException<T,E>	failing(Supplier<E> exceptionBuilder)	Returns an operation that always throw exception.
default ObjLongConsumer<T>	ignore()	Converts this ObjLongConsumerWithException to a lifted ObjLongConsumer ignoring exception.
static <T,E extends Exception> ObjLongConsumer<T>	ignored(ObjLongConsumerWithException<T,E> operation)	Converts a ObjLongConsumerWithException to a lifted ObjLongConsumer ignoring exception.
static <T,E extends Exception> ObjLongConsumer<T>	lifted(ObjLongConsumerWithException<T,E> operation)	Converts a ObjLongConsumerWithException to a lifted ObjLongConsumer ignoring exception.
default BiFunction<T,Long,CompletionStage<Void>>	stage()	Converts this ObjLongConsumerWithException to a staged BiFunction that return a CompletionStage.
static <T,E extends Exception> BiFunction<T,Long,CompletionStage<Void>>	staged(ObjLongConsumerWithException<T,E> operation)	Converts a ObjLongConsumerWithException to a staged BiFunction .
default ObjLongConsumer<T>	uncheck()	Converts this ObjLongConsumerWithException to a ObjLongConsumer that wraps exception to RuntimeException.
static <T,E extends Exception> ObjLongConsumer<T>	unchecked(ObjLongConsumerWithException<T,E> operation)	Converts a ObjLongConsumerWithException to a ObjLongConsumer that wraps exception to RuntimeException.
static <T,E extends Exception> ObjLongConsumer<T>	unchecked(ObjLongConsumerWithException<T,E> operation, Function<Exception,RuntimeException> exceptionMapper)	Converts a ObjLongConsumerWithException to a ObjLongConsumer that wraps exception to RuntimeException by using the provided mapping function.

Methods inherited from interface ch.powerunit.extensions.exceptions.ExceptionHandlerSupport

documented, exceptionMapper

Methods inherited from interface ch.powerunit.extensions.exceptions.NoReturnExceptionHandlerSupport

lift, notThrowingHandler, throwingHandler

Method Detail

accept

void accept(T t,
            long value)
     throws E extends Exception

Performs this operation on the given arguments.

Parameters:

t - the first input argument

value - the second input argument

Throws:

E - any exception

E extends Exception

See Also:

ObjLongConsumer.accept(Object,long)

uncheck

default ObjLongConsumer<T> uncheck()

Converts this ObjLongConsumerWithException to a ObjLongConsumer that wraps exception to RuntimeException.

Specified by:

uncheck in interface ExceptionHandlerSupport<ObjLongConsumer<T>,ObjLongConsumer<T>,ObjLongConsumerWithException<T,E extends Exception>>

Specified by:

uncheck in interface NoReturnExceptionHandlerSupport<ObjLongConsumer<T>,BiFunction<T,Long,CompletionStage<Void>>,ObjLongConsumerWithException<T,E extends Exception>>

Returns:

the unchecked operation

See Also:

unchecked(ObjLongConsumerWithException), unchecked(ObjLongConsumerWithException, Function)

ignore

default ObjLongConsumer<T> ignore()

Converts this ObjLongConsumerWithException to a lifted ObjLongConsumer ignoring exception.

Specified by:

ignore in interface ExceptionHandlerSupport<ObjLongConsumer<T>,ObjLongConsumer<T>,ObjLongConsumerWithException<T,E extends Exception>>

Specified by:

ignore in interface NoReturnExceptionHandlerSupport<ObjLongConsumer<T>,BiFunction<T,Long,CompletionStage<Void>>,ObjLongConsumerWithException<T,E extends Exception>>

Returns:

the operation that ignore error

See Also:

ignored(ObjLongConsumerWithException)

stage

default BiFunction<T,Long,CompletionStage<Void>> stage()

Converts this ObjLongConsumerWithException to a staged BiFunction that return a CompletionStage.

Specified by:

stage in interface NoReturnExceptionHandlerSupport<ObjLongConsumer<T>,BiFunction<T,Long,CompletionStage<Void>>,ObjLongConsumerWithException<T,E extends Exception>>

Returns:

the staged operation.

Since:

1.1.0

failing

static <T,E extends Exception> ObjLongConsumerWithException<T,E> failing(Supplier<E> exceptionBuilder)

Returns an operation that always throw exception.

Type Parameters:

T - the type of the object argument to the operation

E - the type of the exception

Parameters:

exceptionBuilder - the supplier to create the exception

Returns:

an operation that always throw exception

unchecked

static <T,E extends Exception> ObjLongConsumer<T> unchecked(ObjLongConsumerWithException<T,E> operation)

Converts a ObjLongConsumerWithException to a ObjLongConsumer that wraps exception to RuntimeException.

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception

Parameters:

operation - to be unchecked

Returns:

the unchecked operation

Throws:

NullPointerException - if operation is null

See Also:

uncheck(), unchecked(ObjLongConsumerWithException, Function)

unchecked

static <T,E extends Exception> ObjLongConsumer<T> unchecked(ObjLongConsumerWithException<T,E> operation,
                                                            Function<Exception,RuntimeException> exceptionMapper)

Converts a ObjLongConsumerWithException to a ObjLongConsumer that wraps exception to RuntimeException by using the provided mapping function.

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception

Parameters:

operation - the be unchecked

exceptionMapper - a function to convert the exception to the runtime exception.

Returns:

the unchecked operation

Throws:

NullPointerException - if operation or exceptionMapper is null

See Also:

uncheck(), unchecked(ObjLongConsumerWithException)

lifted

static <T,E extends Exception> ObjLongConsumer<T> lifted(ObjLongConsumerWithException<T,E> operation)

Converts a ObjLongConsumerWithException to a lifted ObjLongConsumer ignoring exception.

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception

Parameters:

operation - to be lifted

Returns:

the lifted operation

Throws:

NullPointerException - if operation is null

See Also:

NoReturnExceptionHandlerSupport.lift()

ignored

static <T,E extends Exception> ObjLongConsumer<T> ignored(ObjLongConsumerWithException<T,E> operation)

Converts a ObjLongConsumerWithException to a lifted ObjLongConsumer ignoring exception.

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception

Parameters:

operation - to be lifted

Returns:

the lifted operation

Throws:

NullPointerException - if operation is null

See Also:

ignore()

staged

static <T,E extends Exception> BiFunction<T,Long,CompletionStage<Void>> staged(ObjLongConsumerWithException<T,E> operation)

Converts a ObjLongConsumerWithException to a staged BiFunction .

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception

Parameters:

operation - to be staged

Returns:

the staged operation

Throws:

NullPointerException - if operation is null

Since:

1.1.0

asBiConsumer

static <T,E extends Exception> BiConsumerWithException<T,Long,E> asBiConsumer(ObjLongConsumerWithException<T,E> operation)

Converts a ObjLongConsumerWithException to a BiConsumerWithException returning null.

Type Parameters:

T - the type of the object argument to the operation

E - the type of the potential exception

Parameters:

operation - to be lifted

Returns:

the bi consumer

Throws:

NullPointerException - if operation is null