Module powerunit.exceptions

Package ch.powerunit.extensions.exceptions

Interface IntConsumerWithException<E extends Exception>

Type Parameters:

E - the type of the potential exception of the operation

All Superinterfaces:

ExceptionHandlerSupport<F,F>, NoReturnExceptionHandlerSupport<IntConsumer,IntFunction<CompletionStage<Void>>>

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 IntConsumerWithException<E extends Exception>
extends NoReturnExceptionHandlerSupport<IntConsumer,IntFunction<CompletionStage<Void>>>

Represents an operation that accepts a single int-valued argument, may throw exception and returns no result. This is the primitive type specialization of ConsumerWithException for int. Unlike most other functional interfaces, IntConsumerWithException is expected to operate via side-effects.

General contract

• void accept(int value) throws E - The functional method.
• uncheck - Return a IntConsumer
• lift - Return a IntConsumer
• ignore - Return a IntConsumer

See Also:

IntConsumer

Method Summary

Modifier and Type	Method	Description
void	accept(int value)	Performs this operation on the given argument.
default IntConsumerWithException<E>	andThen(IntConsumerWithException<? extends E> after)	Returns a composed IntConsumerWithException that performs, in sequence, this operation followed by the after operation.
static <E extends Exception> ConsumerWithException<Integer,E>	asConsumer(IntConsumerWithException<E> operation)	Converts a IntConsumerWithException to a ConsumerWithException.
static <E extends Exception> IntConsumerWithException<E>	failing(Supplier<E> exceptionBuilder)	Returns an operation that always throw exception.
default IntConsumer	ignore()	Converts this IntConsumerWithException to a lifted IntConsumer ignoring exception.
static <E extends Exception> IntConsumer	ignored(IntConsumerWithException<E> operation)	Converts a IntConsumerWithException to a lifted IntConsumer ignoring exception.
static <E extends Exception> IntConsumer	lifted(IntConsumerWithException<E> operation)	Converts a IntConsumerWithException to a lifted IntConsumer ignoring exception.
default IntFunction<CompletionStage<Void>>	stage()	Converts this IntConsumerWithException to a staged IntFunction that return a CompletionStage.
static <E extends Exception> IntFunction<CompletionStage<Void>>	staged(IntConsumerWithException<E> operation)	Converts a IntConsumerWithException to a staged IntFunction .
default IntConsumer	uncheck()	Converts this IntConsumerWithException to a IntConsumer that wraps exception to RuntimeException.
static <E extends Exception> IntConsumer	unchecked(IntConsumerWithException<E> operation)	Converts a IntConsumerWithException to a IntConsumer that wraps exception to RuntimeException.
static <E extends Exception> IntConsumer	unchecked(IntConsumerWithException<E> operation, Function<Exception,RuntimeException> exceptionMapper)	Converts a IntConsumerWithException to a IntConsumer that wraps exception to RuntimeException by using the provided mapping function.

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

exceptionMapper, exceptionMapperFor

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

lift, notThrowingHandler, staged, throwingHandler, unchecked

Method Detail

accept

void accept(int value)
     throws E extends Exception

Performs this operation on the given argument.

Parameters:

value - the input argument

Throws:

E - any exception

E extends Exception

See Also:

IntConsumer.accept(int)

uncheck

default IntConsumer uncheck()

Converts this IntConsumerWithException to a IntConsumer that wraps exception to RuntimeException.

Specified by:

uncheck in interface ExceptionHandlerSupport<F,F>

Specified by:

uncheck in interface NoReturnExceptionHandlerSupport<IntConsumer,IntFunction<CompletionStage<Void>>>

Returns:

the unchecked operation

See Also:

unchecked(IntConsumerWithException), unchecked(IntConsumerWithException, Function)

ignore

default IntConsumer ignore()

Converts this IntConsumerWithException to a lifted IntConsumer ignoring exception.

Specified by:

ignore in interface ExceptionHandlerSupport<F,F>

Specified by:

ignore in interface NoReturnExceptionHandlerSupport<IntConsumer,IntFunction<CompletionStage<Void>>>

Returns:

the operation that ignore error

See Also:

ignored(IntConsumerWithException)

stage

default IntFunction<CompletionStage<Void>> stage()

Converts this IntConsumerWithException to a staged IntFunction that return a CompletionStage.

Specified by:

stage in interface NoReturnExceptionHandlerSupport<IntConsumer,IntFunction<CompletionStage<Void>>>

Returns:

the staged operation.

Since:

1.1.0

andThen

default IntConsumerWithException<E> andThen(IntConsumerWithException<? extends E> after)

Returns a composed IntConsumerWithException that performs, in sequence, this operation followed by the after operation. If performing either operation throws an exception, it is relayed to the caller of the composed operation. If performing this operation throws an exception, the after operation will not be performed.

Parameters:

after - the operation to perform after this operation

Returns:

a composed IntConsumer that performs in sequence this operation followed by the after operation

Throws:

NullPointerException - if after is null

See Also:

IntConsumer.andThen(IntConsumer)

failing

static <E extends Exception> IntConsumerWithException<E> failing(Supplier<E> exceptionBuilder)

Returns an operation that always throw exception.

Type Parameters:

E - the type of the exception

Parameters:

exceptionBuilder - the supplier to create the exception

Returns:

an operation that always throw exception

unchecked

static <E extends Exception> IntConsumer unchecked(IntConsumerWithException<E> operation)

Converts a IntConsumerWithException to a IntConsumer that wraps exception to RuntimeException.

Type Parameters:

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(IntConsumerWithException, Function)

unchecked

static <E extends Exception> IntConsumer unchecked(IntConsumerWithException<E> operation,
                                                   Function<Exception,RuntimeException> exceptionMapper)

Converts a IntConsumerWithException to a IntConsumer that wraps exception to RuntimeException by using the provided mapping function.

Type Parameters:

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(IntConsumerWithException)

lifted

static <E extends Exception> IntConsumer lifted(IntConsumerWithException<E> operation)

Converts a IntConsumerWithException to a lifted IntConsumer ignoring exception.

Type Parameters:

E - the type of the potential exception

Parameters:

operation - to be lifted

Returns:

the lifted operation

See Also:

NoReturnExceptionHandlerSupport.lift()

ignored

static <E extends Exception> IntConsumer ignored(IntConsumerWithException<E> operation)

Converts a IntConsumerWithException to a lifted IntConsumer ignoring exception.

Type Parameters:

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 <E extends Exception> IntFunction<CompletionStage<Void>> staged(IntConsumerWithException<E> operation)

Converts a IntConsumerWithException to a staged IntFunction .

Type Parameters:

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

asConsumer

static <E extends Exception> ConsumerWithException<Integer,E> asConsumer(IntConsumerWithException<E> operation)

Converts a IntConsumerWithException to a ConsumerWithException.

Type Parameters:

E - the type of the potential exception

Parameters:

operation - to be converted

Returns:

the consumer

Throws:

NullPointerException - if operation is null