1 /*- 2 * #%L 3 * io.earcam.unexceptional 4 * %% 5 * Copyright (C) 2016 - 2017 earcam 6 * %% 7 * SPDX-License-Identifier: (BSD-3-Clause OR EPL-1.0 OR Apache-2.0 OR MIT) 8 * 9 * You <b>must</b> choose to accept, in full - any individual or combination of 10 * the following licenses: 11 * <ul> 12 * <li><a href="https://opensource.org/licenses/BSD-3-Clause">BSD-3-Clause</a></li> 13 * <li><a href="https://www.eclipse.org/legal/epl-v10.html">EPL-1.0</a></li> 14 * <li><a href="https://www.apache.org/licenses/LICENSE-2.0">Apache-2.0</a></li> 15 * <li><a href="https://opensource.org/licenses/MIT">MIT</a></li> 16 * </ul> 17 * #L% 18 */ 19 package io.earcam.unexceptional; 20 21 import java.util.Objects; 22 23 /** 24 * A checked exception version of {@link java.util.function.Consumer} 25 * 26 * @param <T> the input type of the {@link #accept(Object)} operation 27 * @param <E> the type of Throwable declared 28 * 29 * @see java.util.function.Consumer 30 */ 31 @FunctionalInterface 32 public interface CheckedConsumer<T, E extends Throwable> { 33 34 /** 35 * See {@link java.util.function.Consumer#accept(Object)} 36 * 37 * @param t the input argument 38 * @throws Exception a possible checked exception 39 */ 40 public abstract void accept(T t) throws E; 41 42 43 /** 44 * See {@link java.util.function.Consumer#andThen(Consumer)} 45 * 46 * @param after the operation to perform after this operation 47 * @return a composed {@code CheckedConsumer} that performs in sequence this 48 * operation followed by the {@code after} operation 49 * 50 * @throws NullPointerException if {@code after} is {@code null} 51 */ 52 public default CheckedConsumer<T, E> andThen(/* @Nonnull */ CheckedConsumer<? super T, ? extends E> after) 53 { 54 Objects.requireNonNull(after); 55 return (T t) -> { 56 accept(t); 57 after.accept(t); 58 }; 59 } 60 }