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></string> - 可链式组合: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 不承担判断、消费或供给职责,混淆用途会导致语义不清或编译错误。
- Predicate 用于 filter:决定“要不要这个元素”,返回 boolean
- Consumer 用于 forEach:执行副作用(如打印、入库),不返回结果
- Supplier 用于 generate:无输入,只产出新对象,常配合 Stream.generate 使用
- Function 是 map 的唯一合法参数,强行传入 Consumer 或 Predicate 会编译失败
实战中容易忽略的细节
看似简单的 Function,在复杂业务流中常因类型推导或副作用引入隐患。
- 泛型擦除可能导致运行时 ClassCastException,建议显式声明类型,如
Function<object string> f = o -> String.valueOf(o)</object> - 不要在 apply 中修改原对象状态(如 set 字段),违背 Stream 的不可变性原则
- 若转换逻辑较重(如查库、IO),应考虑异步封装或提前缓存,避免阻塞流处理
- 多个 map 调用可合并为一个 Function 组合,减少中间对象创建,提升性能
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











