Package org.apache.juneau.commons.function

Interface ThrowingConsumer3<A,B,C>

Type Parameters:

A - The type of the first argument to the operation.

B - The type of the second argument to the operation.

C - The type of the third argument to the operation.

All Superinterfaces:

Consumer3<A,B,C>

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 ThrowingConsumer3<A,B,C>
extends Consumer3<A,B,C>

A functional interface representing an operation that accepts three arguments, returns no result, and may throw a checked exception.

This interface extends Consumer3 to allow the functional method to throw checked exceptions. The default apply(Object, Object, Object) method wraps any checked exceptions in a RuntimeException, making it compatible with standard Consumer3 usage while still allowing the implementation to throw checked exceptions via acceptThrows(Object, Object, Object).

Features:

• Functional interface - can be used with lambda expressions and method references
• Exception support - allows checked exceptions to be thrown via acceptThrows(Object, Object, Object)
• Compatible with Consumer3 - implements Consumer3.apply(Object, Object, Object) by wrapping exceptions
• Dual interface - can be used as both Consumer3 and ThrowingConsumer3

Use Cases:

• Three-argument operations that may throw I/O exceptions
• Validation operations that may throw validation exceptions
• Side-effect operations that may fail with checked exceptions
• Operations that need to propagate checked exceptions

Usage:

// Lambda with exception ThrowingConsumer3<String,Integer,Boolean> fileWriter = (path, content, append) -> { if (append) { Files.write(Paths.get(path), content.getBytes(), StandardOpenOption.APPEND); } else { Files.write(Paths.get(path), content.getBytes()); } }; // Using acceptThrows to get checked exception try { fileWriter.acceptThrows("/tmp/output.txt", "Hello World", true); } catch (IOException e) { // Handle checked exception } // Using apply wraps exception in RuntimeException fileWriter.apply("/tmp/output.txt", "Hello World", true); // May throw RuntimeException

Exception Handling:

• acceptThrows(Object, Object, Object) - Throws checked exceptions directly
• apply(Object, Object, Object) - Wraps checked exceptions in RuntimeException
• Use acceptThrows when you need to handle specific checked exceptions
• Use apply when you want standard Consumer3 behavior

See Also:

• ThrowingConsumer - Single-argument consumer that throws exceptions
• ThrowingConsumer2 - Two-argument consumer that throws exceptions
• ThrowingConsumer4 - Four-argument consumer that throws exceptions
• ThrowingConsumer5 - Five-argument consumer that throws exceptions
• juneau-commons Basics

Method Summary

Modifier and Type	Method	Description
void	acceptThrows(A a, B b, C c)	Performs this operation on the given arguments, potentially throwing a checked exception.
default ThrowingConsumer3<A,B,C>	andThen(ThrowingConsumer3<? super A,? super B,? super C> after)	Returns a composed ThrowingConsumer3 that performs, in sequence, this operation followed by the after operation.
default void	apply(A a, B b, C c)	Performs this operation on the given arguments, wrapping any checked exceptions in a RuntimeException.

Methods inherited from interface org.apache.juneau.commons.function.Consumer3

andThen

Method Details

apply

default void apply(A a,
 B b,
 C c)

Performs this operation on the given arguments, wrapping any checked exceptions in a RuntimeException.

This is the default implementation that makes this interface compatible with Consumer3. It calls acceptThrows(Object, Object, Object) and wraps any checked exceptions.

Specified by:

apply in interface Consumer3<A,B,C>

Parameters:

a - The first operation argument.

b - The second operation argument.

c - The third operation argument.

Throws:

RuntimeException - if acceptThrows(Object, Object, Object) throws a checked exception.

andThen

default ThrowingConsumer3<A,B,C> andThen(ThrowingConsumer3<? super A,? super B,? super C> after)

Returns a composed ThrowingConsumer3 that performs, in sequence, this operation followed by the after operation.

This method enables operation composition, allowing you to chain multiple operations together. 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. Must not be null.

Returns:

A composed ThrowingConsumer3 that performs in sequence this operation followed by the after operation.

Throws:

NullPointerException - if after is null.

acceptThrows

void acceptThrows(A a,
 B b,
 C c)
           throws Exception

Performs this operation on the given arguments, potentially throwing a checked exception.

This is the functional method that implementations must provide. It allows checked exceptions to be thrown directly, unlike the standard Consumer3.apply(Object, Object, Object) method.

Example:

ThrowingConsumer3<String,Integer,Boolean> validator = (name, age, active) -> { if (name == null || name.isEmpty()) { throw new ValidationException("Name cannot be empty"); } if (age < 0) { throw new ValidationException("Age cannot be negative"); } }; try { validator.acceptThrows("", -1, true); } catch (ValidationException e) { // Handle checked exception }

Parameters:

a - The first operation argument.

b - The second operation argument.

c - The third operation argument.

Throws:

Exception - If an error occurs during operation execution.