Java Map 累計存儲一鍵多值：List 作為 Value 的標準模式

需求

遍歷 Map，將多個值按 Key 累計存入另一 Map，實現 **一個 Key 對應多個 Value**（如 Map>）。

標準實現

Map> multiMap = new HashMap<>();

// 方式 1：手動檢查
for (Map.Entry entry : sourceMap.entrySet()) {
    String key = entry.getKey();
    Object val = entry.getValue();
    multiMap.computeIfAbsent(key, k -> new ArrayList<>()).add(val);
}

// 方式 2：Java 8+ Stream
Map> multiMap = sourceMap.entrySet().stream()
    .collect(Collectors.groupingBy(
        Map.Entry::getKey,
        Collectors.mapping(Map.Entry::getValue, Collectors.toList())
    ));

// 方式 3：Guava Multimap（推薦生產環境）
Multimap multimap = ArrayListMultimap.create();
for (Map.Entry e : sourceMap.entrySet()) {
    multimap.put(e.getKey(), e.getValue());
}
// 轉回標準 Map
Map> standardMap = multimap.asMap();

關鍵 API 解析

設計建議

• 內部實現優先用 ArrayList（有序、允許重複），需去重改 LinkedHashSet。
• 高併發場景用 ConcurrentHashMap> + computeIfAbsent 或 ConcurrentLinkedQueue。
• 序列化/傳輸時，Multimap.asMap() 返回標準 Map>，兼容 JSON 庫。

核心模式：**Map<K, List<V>> + computeIfAbsent**，或直接用 **Guava Multimap**，一行代碼解決一鍵多值累計存儲。