Stream.map是Java Stream API的中间操作，用于将流中元素通过Function函数转换为新类型。它返回新的流支持链式调用，不修改原始数据。常见应用场景包括字符串转大写、提取对象属性、数值类型转换及生成新对象。使用时需注意避免空值、副作用和类型不匹配问题，可结合filter或Optional处理null。该操作提升了集合处理的简洁性与可读性。
在Java中，Stream.map 是 Stream API 提供的核心转换操作之一，用于将流中的每个元素按照指定规则转换成另一种类型或形式。它属于中间操作，意味着调用后会返回一个新的流，可以继续进行链式操作。
map 方法的基本语法
map 方法定义在 java.util.stream.Stream 接口中，其方法签名为：
<R> Stream<R> map(Function<? super T, ? extends R> mapper)
其中：
立即学习“Java免费学习笔记（深入）”；
- T 是输入流中元素的类型
- R 是转换后元素的类型
- Function 是一个函数式接口，接收一个输入并返回一个结果
也就是说，map 接收一个 Function 函数，将每个元素传入该函数处理，然后收集返回值组成新的流。
常见使用场景与示例
下面通过几个典型例子说明 map 的实际应用方式。
1. 将字符串转为大写
有一个字符串列表，想把所有字符串转为大写形式：
List<String> words = Arrays.asList("hello", "world", "java");
List<String> upperCaseWords = words.stream()
.map(String::toUpperCase)
.collect(Collectors.toList());
// 结果：["HELLO", "WORLD", "JAVA"]
2. 提取对象属性
假设有一个用户类 User，想提取所有用户的姓名：
class User {
private String name;
private int age;
// 构造方法、getter 省略
}
List<User> users = Arrays.asList(
new User("Alice", 25),
new User("Bob", 30)
);
List<String> names = users.stream()
.map(User::getName)
.collect(Collectors.toList());
// 结果：["Alice", "Bob"]
3. 数值转换：将字符串数字转为整数
处理一串表示数字的字符串，转换为对应的 Integer 列表：
List<String> numberStrs = Arrays.asList("1", "2", "3", "4");
List<Integer> numbers = numberStrs.stream()
.map(Integer::parseInt)
.collect(Collectors.toList());
// 结果：[1, 2, 3, 4]
4. 复杂映射：生成新对象
可以根据原对象生成新的数据结构：
Map<String, Integer> nameToLength = users.stream()
.map(user -> Map.entry(user.getName(), user.getAge()))
.collect(Collectors.toMap(Map.Entry::getKey, Map.Entry::getValue));
注意事项与常见问题
使用 map 时需注意以下几点：
- map 不修改原始数据：它只是生成一个包含转换结果的新流，原始集合保持不变
- Function 不能返回 null（除非允许）：如果 mapper 返回 null，最终结果中也会包含 null，需谨慎处理空值
- 避免副作用：map 中的函数应尽量是无状态、无副作用的纯函数，以保证并发安全和逻辑清晰
- 类型匹配错误：确保 Function 的输入输出类型与流元素匹配，否则编译报错
如果需要处理可能为空的情况，可结合 filter 或 Optional 使用：
list.stream() .map(str -> str != null ? str.toUpperCase() : null) .filter(Objects::nonNull) .forEach(System.out::println);
基本上就这些。map 操作简洁高效，是数据转换中最常用的工具之一。掌握它能大幅提升集合处理代码的可读性和表达力。
