HashMap与ImmutableListMultimap的区别及示例

import com.google.common.collect.ListMultimap;
import com.google.common.collect.ImmutableListMultimap;
import org.bson.Document;

private ListMultimap<String, Document> metadatas = ImmutableListMultimap.of();

在Java中，`ImmutableListMultimap`和`HashMap`是两种不同的数据结构，它们在功能和用途上有明显的区别。

1. **HashMap**:
   - `HashMap`是Java集合框架中的一个接口实现，它基于哈希表的Map接口实现。
   - 它存储键值对（key-value pairs），其中键（key）是唯一的。
   - `HashMap`允许空键（null key）和空值（null value）。
   - 它不保证映射的顺序，即迭代顺序可能会在每次运行时都不同。
   - `HashMap`是非同步的，所以在多线程环境中需要外部同步。

   示例代码：

   Map<String, Integer> map = new HashMap<>();
   map.put("apple", 1);
   map.put("banana", 2);
   System.out.println(map.get("apple")); // 输出 1

2. **ImmutableListMultimap**:
   - `ImmutableListMultimap`是Google Guava库中的一个类，它实现了`ListMultimap`接口。
   - 它存储键到值列表的映射，允许一个键对应多个值。
   - `ImmutableListMultimap`是不可变的，意味着一旦创建，就不能更改其内容。
   - 它是同步的，可以在多线程环境中安全使用。
   - `ImmutableListMultimap`提供了一种方法来保持插入顺序，即当迭代键对应的值时，值的顺序与它们被插入的顺序相同。

   示例代码：

   ListMultimap<String, String> multimap = ImmutableListMultimap.of(
       "fruit", "apple",
       "fruit", "banana",
       "color", "red"
   );
   System.out.println(multimap.get("fruit")); // 输出 [apple, banana]

**区别**:
- **数据结构**: `HashMap`是键值对映射，而`ImmutableListMultimap`是键到值列表的映射。
- **不变性**: `HashMap`是可变的，可以添加、删除和修改条目；`ImmutableListMultimap`是不可变的，一旦创建就不能更改。
- **线程安全**: `HashMap`需要外部同步来保证线程安全，而`ImmutableListMultimap`是线程安全的。
- **顺序**: `HashMap`不保证迭代顺序，而`ImmutableListMultimap`保持插入顺序。

在你的代码片段中，`ImmutableListMultimap.of()`用于创建一个不可变的多值映射，其中每个键都映射到一个值列表。由于它是不可变的，所以一旦创建，就不能添加或删除键值对。这通常用于配置数据或在程序初始化时设置的常量数据。