Interface Function1<A, R, X extends Throwable>

Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface Function1<A, R, X extends Throwable>

设计哲学与背景说明:

  1. 函数式接口的存在是 Java 语言的一个 "不得已而为之" 的产物. Java 本身对函数作为一等公民的支持远不如一些函数式语言, 因此需要通过函数式接口来模拟函数行为. 本接口力求在这种限制下尽可能的还原 "函数" 的本质.

  2. 命名哲学: 函数式接口的命名, 要么做到 "具体业务语义明确", 要么做到 "绝对中立且结构统一". JDK 自带的 Supplier, Consumer, Function 等接口, 既不够具体, 又不够中立, 命名语义模糊, 使用时需要人为推断含义, 增加了认知负担. 本接口选择保持绝对中立, 仅表达 "参数个数" 和 "返回值有无".

  3. 关于异常传播: JDK 的函数式接口不支持抛出受检异常 (Checked Exception), 这导致实际开发中, 处理受检异常会非常繁琐, 需要手动捕获或者强行转换为 RuntimeException. 本接口通过泛型参数 X extends Throwable 支持异常泛型, 让函数式接口能自然传播受检异常 避免异常封装与侵入式捕获. 这其实还原了 "函数" 的最本质的概念.

  4. 关于基本类型特化: 虽然基本类型特化 (如 IntFunction) 可以避免装箱拆箱的性能损耗, 但全面特化所有参数和返回值, 会导致类的数量呈指数级爆炸, 达到不可维护的规模 (理论上亿级别). 经过权衡, 我们放弃全面特化. 当然随着 Java 未来的发展, 可能会引入基本类型的泛型支持 (如 Project Valhalla). 届时本接口也能够自然支持, 无需做任何改动.

  5. 命名规则说明:

    • 接口名称采用统一格式: Function + 参数个数 + (Void 表示无返回值) 例如 Function2 表示两个参数有返回值的函数, Function3Void 表示三个参数无返回值的函数.
    • 泛型参数统一按字母顺序排列 (A, B, C, D...), 异常类型统一为 X extends Throwable.
    • 方法名固定为 apply, 保持接口简洁一致.

  6. 相比 Java 自带接口的优势:

    • 命名与结构完全中立, 仅表示 "函数" 这一概念, 避免了含糊不清的命名.
    • 支持受检异常传播, 提升异常处理能力.
    • 命名结构统一, 便于快速识别和使用.
    • 放弃不必要的类型特化, 保持代码库轻量.

  • Method Summary

    Modifier and Type
    Method
    Description
    R
    apply(A a)
     

  • Method Details

    • apply

      R apply(A a) throws X
      Throws:
      X