Java如何实现Map单个key对应多个不同值的功能？

在Java中创建标准Map非常简单：

Map<Integer, String> map = new HashMap<>();
map.put(1, "Name 1");
map.put(2, "Name 2");

你需要的单个键对应多个固定异构值的用法，和MultiValuedMap的单键映射同类型值集合的场景不同，目前没有直接匹配该用法的JDK标准实现，可通过以下方式实现：

方案1：自定义实体类（无第三方依赖，最推荐） #

将需要关联的多个值封装为自定义POJO类，再结合标准Map使用，类型安全且属性语义清晰，后续可灵活拓展字段：

// 自定义存储多值的实体类
class UserInfo {
    private String name;
    private String address;
    private String zipCode;

    public UserInfo(String name, String address, String zipCode) {
        this.name = name;
        this.address = address;
        this.zipCode = zipCode;
    }
    
    // 按需添加getter、setter方法
}

// 使用方式
Map<Integer, UserInfo> map = new HashMap<>();
map.put(1, new UserInfo("Name 1", "Address 1", "ZIP Code 1"));
map.put(2, new UserInfo("Name 2", "Address 2", "ZIP Code 2"));

方案2：使用第三方库的元组类型 #

如果不想单独定义实体类，可以引入支持元组的第三方库（比如Vavr、jOOλ等），直接将单键映射到固定长度的元组：

import io.vavr.Tuple;
import io.vavr.Tuple3;

// 使用方式
Map<Integer, Tuple3<String, String, String>> map = new HashMap<>();
map.put(1, Tuple.of("Name 1", "Address 1", "ZIP Code 1"));
map.put(2, Tuple.of("Name 2", "Address 2", "ZIP Code 2"));

// 取值示例
String name = map.get(1)._1;
String address = map.get(1)._2;
String zipCode = map.get(1)._3;

方案3：自定义Map封装实现 #

如果需要完全匹配你示例中的调用语法，可以自行对HashMap做简单拓展：

import io.vavr.Tuple;
import io.vavr.Tuple3;

public class FixedMultiValueMap<K, V1, V2, V3> extends HashMap<K, Tuple3<V1, V2, V3>> {
    public void put(K key, V1 v1, V2 v2, V3 v3) {
        super.put(key, Tuple.of(v1, v2, v3));
    }
}

// 调用方式和你的示例完全一致
FixedMultiValueMap<Integer, String, String, String> map = new FixedMultiValueMap<>();
map.put(1, "Name 1", "Address 1", "ZIP Code 1");
map.put(2, "Name 2", "Address 2", "ZIP Code 2");

内容的提问来源于stack exchange，提问作者Robert Strauch