BiFunction接口源码理解

---

前言

本文章帮助大家对BiFunction接口的理解。

---

一、概述

BiFunction意为二元函数式。顾名思义，提供两个参数的有结果函数的接口。它是Function接口的两个参数的一个“特例化”。参考Function接口。

它是一个函数式接口，它可作为一个两个参数的有结果lambda表达式的接口类型。

二、源码理解

包

package java.util.BiFunction;

import java.util.function.BiFunction;

使用BiFunction接口时，需引入此包。

BiFunction接口

public interface BiFunction<T, U, R> { /*...*/ }

使用接口时传入泛型T、U、R。T、U为函数式的参数类型，R为函数式的返回结果类型。

BiFunction方法

apply

R apply(T t, U u);

重点：将参数t、u应用于此方法，返回一个R类型的结果，即提供函数逻辑。通常可以这样使用：

Map<String, Integer> map = new HashMap<>();
map.put("A", 1);
map.put("AA", 2);
map.put("AAA", 3);
map.replaceAll(new BiFunction<String, Integer, Integer>() {
    @Override
    public Integer apply(String s, Integer integer) {
        return s.length() + integer;
    }
});

以下为精简写法：

Map<String, Integer> map = new HashMap<>();
map.put("A", 1);
map.put("AA", 2);
map.put("AAA", 3);
map.replaceAll((s, integer) -> s.length() + integer);

例子中map值为{ “A”: 2, “AA”: 4. “AAA”: 6 }。参考Map接口的default void replaceAll(BiFunction<? super K, ? super V, ? extends V> function)方法。

andThen

default <V> BiFunction<T, U, V> andThen(Function<? super R, ? extends V> after) {
    Objects.requireNonNull(after);
    return (T t, U u) -> after.apply(apply(t, u));
}

传入泛型V，为after函数式的结果及返回函数式的结果的类型。组合此函数式和after函数式的函数逻辑（返回二元函数式），即返回的函数式的参数先作为此函数式的参数，此函数式的结果作为after函数式的参数，after函数式的结果作为返回函数式的结果，具有“传递性”的意味。default关键字给出默认实现。

若after为空，则抛出NullPointerException异常，参考Objects.requireNonNull方法。

注意：返回函数式参数中泛型T、U为此函数式的参数泛型，after函数式参数的泛型R为此函数式的结果泛型。若返回函数式中出现异常，那么这些异常会交给返回函数式的调用方处理。

---

总结

新人源码理解，望大家多多指点。