Package org.apache.juneau.commons.function

Interface Consumer3<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 Known Subinterfaces:
ThrowingConsumer3<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 Consumer3<A,B,C>
A functional interface representing an operation that accepts three arguments and returns no result.

This interface extends the standard Java Consumer pattern to support three-argument consumers. It's useful when you need to pass operations with three parameters to methods that expect functional interfaces, such as in iteration, builders, or callback patterns.

Features:
  • Functional interface - can be used with lambda expressions and method references
  • Composition support - provides andThen(Consumer3) for operation chaining
  • Side-effect operations - designed for operations that perform side effects rather than return values
Use Cases:
  • Three-argument operations in iteration patterns
  • Builder methods that accept three-parameter operations
  • Callback patterns with three parameters
  • Event handlers that process three values
Usage:

// Lambda expression Consumer3<String,Integer,Boolean> printer = (name, age, active) -> System.out.println(name + " is " + age + " (" + (active ? "active" : "inactive") + ")"); printer.apply("Alice", 30, true); // Prints "Alice is 30 (active)" // Operation composition Consumer3<String,Integer,Boolean> validate = (s, i, b) -> { if (i < 0) throw new IllegalArgumentException(); }; Consumer3<String,Integer,Boolean> process = (s, i, b) -> process(s, i, b); Consumer3<String,Integer,Boolean> validateAndProcess = validate.andThen(process); validateAndProcess.apply("data", 42, true); // Validates then processes

See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    default Consumer3<A,B,C>
    andThen(Consumer3<? super A,? super B,? super C> after)
    Returns a composed Consumer3 that performs, in sequence, this operation followed by the after operation.
    void
    apply(A a, B b, C c)
    Performs this operation on the given arguments.

  • Method Details

    • andThen

      default Consumer3<A,B,C> andThen(Consumer3<? super A,? super B,? super C> after)
      Returns a composed Consumer3 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.

      Example:

      Consumer3<String,Integer,Boolean> log = (s, i, b) -> logger.info(s + ": " + i + ", " + b); Consumer3<String,Integer,Boolean> store = (s, i, b) -> cache.put(s, i, b); Consumer3<String,Integer,Boolean> logAndStore = log.andThen(store); logAndStore.apply("data", 100, true); // Logs and stores

      Parameters:
      after - The operation to perform after this operation. Must not be null.
      Returns:
      A composed Consumer3 that performs in sequence this operation followed by the after operation.
      Throws:
      NullPointerException - if after is null.

    • apply

      void apply(A a, B b, C c)
      Performs this operation on the given arguments.
      Example:

      Consumer3<String,Integer,Boolean> handler = (key, value, flag) -> { map.put(key, value); if (flag) cache.invalidate(key); }; handler.apply("user", 12345, true);

      Parameters:
      a - The first operation argument.
      b - The second operation argument.
      c - The third operation argument.