一、简介

Java 8 引入了Map.of()方法，这使得创建不可变映射变得更加容易。Java 9 获得了Map.ofEntries()方法，其功能略有不同。

在本教程中，我们将仔细研究不可变映射的这两个静态工厂方法，并解释哪一个适用于哪个目的。

Map.of()

Map.of()方法将指定数量的键值对作为参数，并返回包含每个键值对的不可变映射。参数中对的顺序对应于将它们添加到地图的顺序。如果我们尝试添加具有重复键的键值对，它会抛出IllegalArgumentException。如果我们尝试添加null键或值，它将抛出NullPointerException。

作为重载的static工厂方法实现，第一个让我们创建一个空映射：

static <K, V> Map<K, V> of() {
 return (Map<K,V>) ImmutableCollections.EMPTY_MAP;
 }

让我们看看用法：

Map<Long, String> map = Map.of();

在Map<K, V>的接口中还定义了一个方法，它采用单个键和值：

static <K, V> Map<K, V> of(K k1, V v1) {
 return new ImmutableCollections.Map1<>(k1, v1);
 }

让我们称之为：

Map<Long, String> map = Map.of(1L, "value1");

这些工厂方法被重载了九次，最多接受十个键和十个值，正如我们在OpenJDK 17中所见：

static <K, V> Map<K, V> of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4, K k5, V v5, K k6, V v6, K k7, V v7, K k8, V v8, K k9, V v9, K k10, V v10) {
 return new ImmutableCollections.MapN<>(k1, v1, k2, v2, k3, v3, k4, v4, k5, v5, k6, v6, k7, v7, k8, v8, k9, v9, k10, v10);
 }

尽管这些方法非常有用，但创建更多它们将是一团糟。此外，我们不能使用Map.of()方法从现有键和值创建映射，因为此方法只接受未定义的键值对作为参数。这就是Map.ofEntries()方法的用武之地。

Map.ofEntries()

Map.ofEntries()方法将未指定数量的Map.Entry<K, V>对像作为参数，并返回一个不可变映射。同样，参数中对的顺序与它们添加到地图的顺序相同。如果我们尝试添加具有重复键的键值对，它会抛出IllegalArgumentException。

让我们看看根据OpenJDK 17的静态工厂方法实现：

static <K, V> Map<K, V> ofEntries(Entry<? extends K, ? extends V>... entries) {
 if (entries.length == 0) { // implicit null check of entries array
 var map = (Map<K,V>) ImmutableCollections.EMPTY_MAP;
 return map;
 } else if (entries.length == 1) {
 // implicit null check of the array slot
 return new ImmutableCollections.Map1<>(entries[0].getKey(), entries[0].getValue());
 } else {
 Object[] kva = new Object[entries.length << 1];
 int a = 0;
 for (Entry<? extends K, ? extends V> entry : entries) {
 // implicit null checks of each array slot
 kva[a++] = entry.getKey();
 kva[a++] = entry.getValue();
 }
 return new ImmutableCollections.MapN<>(kva);
 }
 }

可变参数实现允许我们传递可变数量的条目。

例如，我们可以创建一个空地图：

Map<Long, String> map = Map.ofEntries();

或者我们可以创建并填充地图：

Map<Long, String> longUserMap = Map.ofEntries(Map.entry(1L, "User A"), Map.entry(2L, "User B"));

Map.ofEntries()方法的一大优点是我们还可以使用它从现有的键和值创建映射。这对于Map.of()方法是不可能的，因为它只接受未定义的键值对作为参数。

4。结论

Map.of()方法只适用于最多10 个元素的地图。这是因为它被实现为11 个不同的重载方法，这些方法采用0 到10 个名称-值对作为参数。另一方面，Map.ofEntries()方法可用于任何大小的地图，因为它利用了特征变量参数。