Predicate.java官方文档翻译

package java.util.function;

import java.util.Objects;

/**
* Represents a predicate (boolean-valued function) of one argument.
* 表示一个参数的谓词（booean值函数）
*
* <p>这是一个 <a href="package-summary.html">函数式接口</a>
* 它的函数式方法是 {@link #test(Object)}.
*
* @param <T> the type of the input to the predicate
*
* @since 1.8
*/
@FunctionalInterface
public interface Predicate<T> {

    /**
     * 在给定的参数上计算这个predicate
     *
     * @param t the input argument
     * @return {@code true} if the input argument matches the predicate,
     * otherwise {@code false}
     */
    boolean test(T t);

    /**
     * 返回一个predicate，它表示一个predicate与另一个predicate 短路的逻辑与。
     *评估组合的predicate时，如果第一个predicate是{@code false}，
     *那么第二个 {@code other}不会执行。
     *
     *
     * 在评估任一predicate时抛出的任何异常都传递给调用者，如果
     * 对该predicate的评估抛出异常，则不会对其他的 {@code other} predicate进行评估。
     *
     * @param other a predicate that will be logically-ANDed with this
     *              predicate
     * @return a composed predicate that represents the short-circuiting logical
     * AND of this predicate and the {@code other} predicate
     * @throws NullPointerException if other is null
     */
    default Predicate<T> and(Predicate<? super T> other) {
        Objects.requireNonNull(other);
        return (t) -> test(t) && other.test(t);
    }

    /**
     * 返回一个predicate。表示这个predicate的逻辑非
     *
     * @return a predicate that represents the logical negation of this
     * predicate
     */
    default Predicate<T> negate() {
        return (t) -> !test(t);
    }

    /**
       * 返回一个predicate，它表示一个predicate与另一个predicate 短路的逻辑或。
     *评估组合的predicate时，如果第一个predicate是{@code false}，
     *那么第二个 {@code other}不会执行。
     *
     *
     * 在评估任一predicate时抛出的任何异常都传递给调用者，如果
     * 对该predicate的评估抛出异常，则不会对其他的 {@code other} predicate进行评估。
     *
     * @param other a predicate that will be logically-ORed with this
     *              predicate
     * @return a composed predicate that represents the short-circuiting logical
     * OR of this predicate and the {@code other} predicate
     * @throws NullPointerException if other is null
     */
    default Predicate<T> or(Predicate<? super T> other) {
        Objects.requireNonNull(other);
        return (t) -> test(t) || other.test(t);
    }

    /**
     * 返回一个predicate测试两个参数是否相等通过
     *  {@link Objects#equals(Object, Object)}.
     *
     * @param <T> the type of arguments to the predicate
     * @param targetRef the object reference with which to compare for equality,
     *               which may be {@code null}
     * @return a predicate that tests if two arguments are equal according
     * to {@link Objects#equals(Object, Object)}
     */
    static <T> Predicate<T> isEqual(Object targetRef) {
        return (null == targetRef)
                ? Objects::isNull
                : object -> targetRef.equals(object);
    }
}