Function接口是Stream API中用于“输入一个值、输出一个新值”的核心映射接口,泛型T为输入、R为输出,通过apply(T)实现转换,支持compose/andThen链式组合,专用于map操作,不可与Predicate、Consumer等混用。

Function 接口是 Stream API 中最核心的映射型函数式接口,用于定义“输入一个值,输出一个新值”的转换逻辑。它不改变原始数据,只负责描述如何把元素从一种形式转为另一种形式。
Function 的基本用法与关键点
Function
- 必须返回值,不能 void;若需无返回动作,应改用 Consumer
- Lambda 表达式直接对应 apply 方法体,例如
s -> s.length()就是一个Function<String, Integer> - 可链式组合:compose() 先执行前置函数,andThen() 后执行后续函数,适合分步处理场景
在 Stream.map() 中如何正确使用 Function
map 方法接收 Function 实例,将流中每个元素按规则转换为新类型或新值。关键是确保输入类型与流元素类型匹配,输出类型符合业务目标。
- 常见写法:
stream.map(String::toUpperCase),等价于stream.map(s -> s.toUpperCase()) - 复合转换示例:先截取前3字符再转大写 →
stream.map(s -> s.substring(0, Math.min(3, s.length()))).map(String::toUpperCase) - 避免空指针:若源数据可能为 null,应在 Function 内部做判空,或提前用 filter 过滤
Function 与其他函数式接口的协作边界
Function 不承担判断、消费或供给职责,混淆用途会导致语义不清或编译错误。
立即学习“Java免费学习笔记(深入)”;
- Predicate 用于 filter:决定“要不要这个元素”,返回 boolean
- Consumer 用于 forEach:执行副作用(如打印、入库),不返回结果
- Supplier 用于 generate:无输入,只产出新对象,常配合 Stream.generate 使用
- Function 是 map 的唯一合法参数,强行传入 Consumer 或 Predicate 会编译失败
实战中容易忽略的细节
看似简单的 Function,在复杂业务流中常因类型推导或副作用引入隐患。
- 泛型擦除可能导致运行时 ClassCastException,建议显式声明类型,如
Function<Object, String> f = o -> String.valueOf(o) - 不要在 apply 中修改原对象状态(如 set 字段),违背 Stream 的不可变性原则
- 若转换逻辑较重(如查库、IO),应考虑异步封装或提前缓存,避免阻塞流处理
- 多个 map 调用可合并为一个 Function 组合,减少中间对象创建,提升性能


















