此示例演示如何使用新的Java9集合工厂方法创建不可变映射

随着Java9的发布，Oracle在获取其他流行的JVM语言(如Kotlin、Guava、Scala等)的工作实践方面迈出了一步。这是在适当考虑JDK的向后兼容性和语法一致性的前提下完成的。Java9的新特性之一是创建 不可变(不可修改)映射。

Java9不可变映射示例

在Java9之前，不可变映射的创建是一项冗长的任务。例如，为了使用Java 9之前的版本创建一个空的不可变映射，我们使用了以下代码：

package theitroad.local;

import java.util.Collections;
import java.util.HashMap;
import java.util.Map;

public class UnmodifiableMapExample {

	public static void main(String[] args) {
		Map<Integer, String> emptyMap = new HashMap<>();
		Map<Integer, String> immutableEmptyMap = Collections.unmodifiableMap(emptyMap);
	}

}

什么是不变映射

一旦在Java中创建了不可变的对象就不能更改值。不可变映射也不例外。你可以 不能：

无法添加、删除或者更新键和值。如果你尝试这样做，这将在

java.lang.UnsupportedOperationException

修改地图条目。这样做会导致

java.lang.UnsupportedOperationException

使用

null

地图中的键和值。如果我们试图向映射中添加一个空键或者空值，那么我们将得到一个

java.lang.NullPointerException

在Java9中创建空的不可变映射

要在Java9中创建一个空映射，我们只需调用factory Map方法

of()

，请参阅下面的示例

package theitroad.local;

import java.util.Map;

public class Java9EmptyImmutableMapExample {
	public static void main(String[] args) {
		Map<Integer,String> emptyImmutableMap = Map.of();
	}
}

用java9创建不可变的映射

有10种工厂方法来创建不可变映射，最多10个键值对(来源：Java 9 Map interface Javadoc)：

static <K,V> Map<K,V>	of(K k1, V v1)	
Returns an immutable map containing a single mapping.

static <K,V> Map<K,V>	of(K k1, V v1, K k2, V v2)	
Returns an immutable map containing two mappings.

static <K,V> Map<K,V>	of(K k1, V v1, K k2, V v2, K k3, V v3)	
Returns an immutable map containing three mappings.

static <K,V> Map<K,V>	of(K k1, V v1, K k2, V v2, K k3, V v3, K k4, V v4)	
Returns an immutable map containing four mappings.

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)	
Returns an immutable map containing five mappings.

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)	
Returns an immutable map containing six mappings.

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)	
Returns an immutable map containing seven mappings.

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)	
Returns an immutable map containing eight mappings.

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)	
Returns an immutable map containing nine mappings.

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)	
Returns an immutable map containing ten mappings.

以下示例创建一个包含3个条目的不可变映射：

package theitroad.local;

import java.util.Map;

public class Java9ImmutableMapExample {
	public static void main(String[] args) {
		Map<Integer,String> map = Map.of(1, "A", 2, "B", 3, "C");
	}
}

使用说明入口地图()在Java9中创建不可变映射的方法

Java9中的Map接口提供了另一种实用方法来创建不可变的映射——条目。方法的签名如下所示：

static <K,V> Map<K,V>	ofEntries(Map.Entry<? extends K,? extends V>... entries)

这允许我们在映射中插入任意数量的条目。下面的示例在ofEntries()方法的帮助下创建了3个条目并用它们创建了一个不可变的映射：

package theitroad.local;

import java.util.Map;

public class Java9ImmutableMapOfEntriesExample {
	public static void main(String[] args) {
		Map.Entry<Integer,String> e1 = Map.entry(1, "A");
		Map.Entry<Integer,String> e2 = Map.entry(2, "B");
		Map.Entry<Integer,String> e3 = Map.entry(3, "C");

		Map<Integer,String> map = Map.ofEntries(e1, e2, e3);
	}
}

可以通过静态导入显著缩短代码

java.util.Map.entry

，见下例：

package theitroad.local;

import static java.util.Map.entry;
import java.util.Map;

public class Java9ImmutableMapOfEntriesExample {
	public static void main(String[] args) {
		Map<Integer,String> map = Map.ofEntries(entry(1,"A"), entry(2,"B"), entry(3,"C"));
	}
}