tomap是stream api中将流转为map的核心收集器，需指定key/value函数，键冲突时须提供合并策略，可自定义map类型，但需防null值和线程安全问题。
Java 的 Stream API 中 toMap 是一个常用的收集器（Collector），用于将流中的元素按指定规则转换为 Map。它灵活但容易因键冲突或空值抛出异常，用对关键参数是核心。
基础用法：单参数键 + 单参数值
最常见场景是把对象列表转成以某个字段为 key、对象本身或某字段为 value 的映射表：
- 需要传入两个函数式参数：第一个是生成 key 的
Function，第二个是生成 value 的Function - 底层默认使用
HashMap::new创建 map，不保证顺序 - 若 key 重复，会直接抛
IllegalStateException
示例：
ListMap
.collect(Collectors.toMap(User::getId, User::getName));
// 结果：{1="Alice", 2="Bob"}
处理键冲突：提供合并策略
当多个元素生成相同 key 时（比如按状态分组但状态重复），必须显式传入第三个参数——BinaryOperator 合并函数：
- 该函数接收两个 value，返回“保留哪一个”或“如何合并”
- 常用写法：
(v1, v2) -> v1（保留前者）、(v1, v2) -> v2（保留后者）、String::concat等
示例（同名用户取 ID 较小者）：
.collect(Collectors.toMap(
User::getName,
User::getId,
(id1, id2) -> Math.min(id1, id2)
));
指定 Map 类型与并发安全
第四个参数可传入 Supplier<map></map>，用于自定义 map 实现：
- 想保持插入顺序？用
LinkedHashMap::new - 需要线程安全？用
ConcurrentHashMap::new（注意：仅容器线程安全，合并逻辑仍需自己保证） - 想用不可变 map？需配合
Collectors.collectingAndThen二次封装
示例（有序 map）：
Map.collect(Collectors.toMap(
User::getId,
Function.identity(),
(u1, u2) -> u1,
LinkedHashMap::new
));
注意事项与避坑点
toMap 表面简单，实际几个细节常导致运行时报错：
- key 或 value 为 null 会抛 NullPointerException：确保映射函数不返回 null，或提前 filter 掉空值
- 流为空时返回空 map：无需额外判空，但要注意 supplier 是否支持空构造
- 不要在 lambda 中修改外部变量：比如在 key 函数里 ++i 计数，会破坏函数式语义且结果不可预测
- 如果只是分组（一对多），优先用
Collectors.groupingBy，而非硬套toMap
不复杂但容易忽略。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
