map.put

### Java 中 `Map` 的 `put()` 方法详解 #### 1. 基本概念 在 Java 集合框架中，`Map` 是一种键值对存储结构。其中，`put(K key, V value)` 方法用于向 `Map` 容器中插入一个新的键值对。如果指定的键已经存在于容器中，则会更新该键对应的值。 对于 `HashMap` 类型的具体实现，其内部通过哈希算法计算键的位置并完成数据存储操作[^1]。 --- #### 2. 使用说明 - **参数**: - `key`: 键对象，唯一标识一条记录。 - `value`: 对应于键的对象值。 - **返回值**: 如果插入成功且未覆盖原有值，则返回 `null`；如果键已存在，则返回旧值。 - **异常情况**: - 当尝试插入 `null` 键时（仅限单个），`HashMap` 支持一个 `null` 键，而某些子类如 `TreeMap` 不支持任何 `null` 键或值。 --- #### 3. 示例代码 以下是关于如何使用 `put()` 方法的一个简单示例： ```java import java.util.HashMap; public class Main { public static void main(String[] args) { // 创建 HashMap 实例 HashMap<Integer, String> map = new HashMap<>(); // 插入键值对 map.put(10, "C"); map.put(20, "C++"); map.put(30, "SFDC"); System.out.println("初始状态：" + map); // 更新已有键的值 map.put(20, "Python"); // 替换原有的 C++ System.out.println("更新后：" + map); // 尝试插入重复键 String oldValue = map.put(10, "GoLang"); // 返回被替换的原值"C" System.out.println("再次更新：" + map); System.out.println("被替换的原始值：" + oldValue); // 输出 "C" // 查看最终结果 System.out.println("最终状态：" + map); } } ``` 运行上述程序的结果如下： ``` 初始状态：{10=C, 20=C++, 30=SFDC} 更新后：{10=C, 20=Python, 30=SFDC} 再次更新：{10=GoLang, 20=Python, 30=SFDC} 被替换的原始值：C 最终状态：{10=GoLang, 20=Python, 30=SFDC} ``` --- #### 4. 扩展功能——批量插入 (`putAll`) 除了单独调用 `put(key, value)` 外，还可以利用 `putAll(Map<? extends K, ? extends V> m)` 方法一次性将另一个 `Map` 的全部内容复制到当前实例中[^2][^3]。 下面是一个演示案例： ```java import java.util.HashMap; import java.util.Map; public class PutAllExample { public static void main(String[] args) { // 初始化两个独立的 Map HashMap<Integer, String> firstMap = new HashMap<>(); firstMap.put(10, "C"); firstMap.put(20, "C++"); HashMap<Integer, String> secondMap = new HashMap<>(); secondMap.put(30, "Java"); secondMap.put(40, "JavaScript"); // 合并第二个 Map 到第一个 firstMap.putAll(secondMap); System.out.println("合并后的 Map：" + firstMap); } } ``` 执行此脚本可得： ``` 合并后的 Map：{10=C, 20=C++, 30=Java, 40=JavaScript} ``` 注意，在发生冲突的情况下（即两份映射中有相同键），后者的内容将会覆盖前者的数据项。 --- #### 5. 总结 `put()` 和 `putAll()` 是处理 `Map` 数据的核心工具之一。它们分别适用于单一元素的操作以及多组关联关系的整体迁移场景下。理解这些基础 API 及其实现细节有助于开发者更高效地构建基于键值对的应用逻辑。 ---