异常教程

java map遍历（超详细）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 Java 开发中，Map 是一个常用的数据结构，它通过键值对（key-value）存储数据，广泛应用于缓存、配置管理、业务逻辑处理等场景。然而，当需要遍历 Map 中的所有元素时，开发者常常会遇到多种方法的选择困惑，甚至因操作不当引发异常。本文将从基础概念出发，逐步讲解 Java Map遍历 的核心方法，并通过实际案例和代码示例，帮助读者理解不同场景下的最佳实践。

一、Map 的基本概念与遍历需求

Map 是一种无序的键值对集合，其核心特性是通过唯一的键（key）快速查找对应的值（value）。例如，一个用户订单系统可能将订单号作为键，订单详情作为值存储在 Map 中。然而，当需要处理所有订单数据（如统计总金额、生成报表）时，就必须对 Map 进行遍历。

遍历 Map 的常见需求包括：

  1. 获取所有键：例如，列出所有订单号；
  2. 获取所有值：例如，提取所有订单金额；
  3. 同时操作键和值：例如，根据订单号更新订单状态。

二、基础遍历方法：通过 entrySet()

Map 接口提供了三种核心方法来支持遍历：

  • keySet()：返回所有键的集合；
  • values()：返回所有值的集合；
  • entrySet()：返回所有键值对的集合。

其中，entrySet() 是最常用且推荐的方式，因为它能同时访问键和值，且遍历效率更高。

示例代码 1：使用 entrySet() 遍历

Map<String, Double> orderMap = new HashMap<>();  
orderMap.put("order_001", 199.0);  
orderMap.put("order_002", 299.0);  

// 通过 entrySet() 遍历所有键值对  
for (Map.Entry<String, Double> entry : orderMap.entrySet()) {  
    String orderId = entry.getKey();  
    Double amount = entry.getValue();  
    System.out.println("订单号：" + orderId + "，金额：" + amount);  
}

为什么推荐 entrySet()？

  • 高效性：entrySet() 直接访问底层存储的键值对，避免了 keySet() 和 values() 分别遍历的两次操作；
  • 灵活性：可以同时操作键和值，适合需要关联处理的场景（如根据键修改值）。

三、其他遍历方法：keySet() 和 values()

虽然 entrySet() 是最常用的方式，但 keySet() 和 values() 在特定场景下也有其价值。

示例代码 2：使用 keySet() 遍历键

for (String key : orderMap.keySet()) {  
    System.out.println("订单号：" + key);  
}

示例代码 3：使用 values() 遍历值

for (Double value : orderMap.values()) {  
    System.out.println("金额：" + value);  
}

适用场景：

  • keySet()：仅需遍历键，例如统计订单数量；
  • values()：仅需遍历值，例如计算所有订单的总金额。

四、迭代器（Iterator）的高级用法

在遍历过程中，如果需要动态修改 Map（如删除元素），直接通过 for-each 循环会抛出 ConcurrentModificationException 异常。此时，应使用 迭代器 的 remove() 方法安全地操作集合。

示例代码 4：通过迭代器删除元素

Iterator<Map.Entry<String, Double>> iterator = orderMap.entrySet().iterator();  
while (iterator.hasNext()) {  
    Map.Entry<String, Double> entry = iterator.next();  
    if (entry.getValue() < 200.0) {  
        iterator.remove(); // 安全删除元素  
    }  
}

关键点：

  • 迭代器的 remove() 方法是唯一允许在遍历时修改集合的方式；
  • 切勿在遍历过程中直接调用 map.remove()，这会破坏迭代器的内部状态。

五、Java 8 Stream API 的优雅遍历

从 Java 8 开始，开发者可以通过 Stream API 以更简洁的方式遍历 Map，并结合函数式编程实现复杂操作。

示例代码 5：使用 Stream 遍历并过滤数据

orderMap.entrySet().stream()  
    .filter(entry -> entry.getValue() > 250.0) // 过滤金额大于250的订单  
    .forEach(entry -> System.out.println(entry.getKey()));

示例代码 6：并行流提升性能

double total = orderMap.values().parallelStream()  
    .mapToDouble(Double::doubleValue)  
    .sum();  
System.out.println("总金额：" + total);

优势：

  • 代码简洁：通过链式调用减少冗余代码；
  • 功能强大：支持过滤、映射、归约等操作；
  • 并行化：通过 parallelStream() 加速大数据量处理（需注意线程安全）。

六、实战案例：遍历配置参数

假设有一个系统配置类，使用 Map 存储键值对形式的配置参数，例如：

Map<String, String> configMap = new HashMap<>();  
configMap.put("server.port", "8080");  
configMap.put("database.url", "jdbc:mysql://localhost:3306/mydb");

需求：遍历所有配置项，将键和值拼接成 key=value 格式的字符串列表。

解决方案：

List<String> configList = new ArrayList<>();  
for (Map.Entry<String, String> entry : configMap.entrySet()) {  
    configList.add(entry.getKey() + "=" + entry.getValue());  
}

思考：为什么选择 entrySet()？

  • 需要同时访问键和值，且无需修改 Map，因此直接遍历是最简单的方式。

七、避免遍历中的常见陷阱

1. ConcurrentModificationException

当在遍历过程中修改 Map 时，若未使用迭代器的 remove() 方法，将抛出此异常。

2. 线程安全问题

在多线程环境下，若多个线程同时遍历和修改 Map，需使用线程安全的实现类（如 ConcurrentHashMap）。

3. 修改键或值的副作用

如果遍历过程中修改了键或值的对象状态（如 Map<String, MutableObject>），可能导致逻辑错误，需谨慎操作。

八、性能优化与选择建议

  • 小数据量：直接使用 entrySet() 或 for-each 循环；
  • 大数据量：考虑并行流（parallelStream()）或优化内存占用；
  • 动态修改需求：优先使用迭代器；
  • 代码简洁性：Stream API 是现代 Java 开发的首选。

结论

Java Map遍历 是开发者日常工作中不可或缺的技能，其方法选择直接影响代码的效率与可维护性。通过本文的讲解，读者可以掌握从基础到高级的遍历技术，并结合实际场景灵活运用。无论是统计订单金额、处理配置参数，还是实现复杂的业务逻辑，掌握这些技巧将帮助开发者写出更高效、更健壮的代码。

建议读者通过实际项目练习上述方法，并结合调试工具观察遍历过程中的内存变化，逐步提升对 Map 集合的驾驭能力。

最新发布

查看更多文章