Consumer.java官方文档翻译

package java.util.function;

import java.util.Objects;

/**
* 表示接收单个参数但是不返回结果的操作。
* 与其它函数式接口不同的是，{@code Consumer} 通过副作用进行操作。
*
* <p>这是一个 <a href="package-summary.html">函数式 接口</a>
* 它的函数式方法是 {@link #accept(Object)}.
*
* @param <T> the type of the input to the operation
*
* @since 1.8
*/
@FunctionalInterface
public interface Consumer<T> {

    /**
     * 通过给定的参数执行操作
     *
     * @param t the input argument
     */
    void accept(T t);

    /**
     * 返回一个组合的 {@code Consumer}，串行执行，后面跟着{@code after}操作。
     * 如果执行任何操作时都抛出异常，将会传递给这个组合操作的调用者。
     * 如果在执行这个操作时抛出一个异常，那么{@code after}操作将不会被执行。
     *
     * @param after the operation to perform after this operation
     * @return a composed {@code Consumer} that performs in sequence this
     * operation followed by the {@code after} operation
     * @throws NullPointerException if {@code after} is null
     */
    default Consumer<T> andThen(Consumer<? super T> after) {
        Objects.requireNonNull(after);
        return (T t) -> { accept(t); after.accept(t); };
    }
}