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 }