io.github.oliviercailloux.jaris.throwing.TBiConsumer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jaris Show documentation

Various utilities that complement those found in Guava.

There is a newer version: 0.0.38

package io.github.oliviercailloux.jaris.throwing;

import static com.google.common.base.Preconditions.checkNotNull;

/**
 * Generalization of {@link java.util.function.BiConsumer} that may throw instances of type
 * {@code X}, not just {@code RuntimeException} instances.
 *
 * @param  the type of the first argument to the operation
 * @param  the type of the second argument to the operation
 * @param  a sort of throwable that the {@code Throwing.BiConsumer} may throw
 */
@FunctionalInterface
public interface TBiConsumer {
  /**
   * Performs this operation on the given arguments.
   *
   * @param t the first input argument
   * @param u the second input argument
   * @throws X in generally unspecified circumstances
   */
  public void accept(T t, U u) throws X;

  /**
   * Returns a composed {@code Throwing.BiConsumer} that performs, in sequence, this operation
   * followed by the {@code after} operation.
   *
   * @param after the operation to perform after this operation
   * @return a composed {@code Throwing.BiConsumer} that performs in sequence this operation
   *         followed by the {@code after} operation
   * @see java.util.function.BiConsumer#andThen(java.util.function.BiConsumer)
   */
  default TBiConsumer andThen(TBiConsumer after) {
    checkNotNull(after);

    return (l, r) -> {
      accept(l, r);
      after.accept(l, r);
    };
  }
}