Java中如何实现可按索引访问的有序键值对集合

你需要填充包含*Language（语言）和Proficiency（熟练度）*两列的二维表，原有实现代码如下：

public void typeLanguages(@NotNull List<String> languages,
                          @NotNull List<SkillLevel> skillLevels) {

    if(languages.size() != skillLevels.size()) { throw new IllegalArgumentException(); }

    IntStream.range(0, skillLevels.size()).forEach(i -> {
        typeAndConfirm(languagesFld.get(i), languages.get(i));
        typeAndConfirm(skillFld.get(i), skillLevels.get(i).getLangSkill());
    });
}

原实现通过IntStream遍历索引，把第i组language-skillLevel配对插入表格第i行。其中SkillLevel是实现了getLangSkill()方法的枚举，调用该方法可返回四个熟练度等级对应的字符串值。
当前实现的风险很明确：即使加了两个入参列表的长度校验，还是可能因为传入的列表顺序错乱，导致语言和熟练度匹配错误。你之前尝试用Map存配对数据，但普通Map没有提供直接获取第i个元素的方法，满足不了按索引顺序存取键值对的需求。

按推荐优先级从高到低排列：

• 自定义业务专用类存储配对数据
  这是最符合Java编码规范的方案，没必要执着于找通用元组或者键值对结构，针对当前场景定义专用类语义最清晰，能从根源上避免参数错配问题：

  // Java 16及以上版本直接用record即可，低版本手写普通实体类加getter/构造方法就行
  public record LanguageProficiency(String language, SkillLevel level) {}
  
  // 方法改造后直接接收提前配对好的对象列表，不存在两个列表顺序对不上的可能
  public void typeLanguages(@NotNull List<LanguageProficiency> items) {
      IntStream.range(0, items.size()).forEach(i -> {
          LanguageProficiency current = items.get(i);
          typeAndConfirm(languagesFld.get(i), current.language());
          typeAndConfirm(skillFld.get(i), current.level().getLangSkill());
      });
  }
  

  调用方必须提前把语言和对应的熟练度组装成对象传入，从入参结构上就不可能出现两个列表传反、元素错位的问题。
• 用LinkedHashMap保留插入顺序
  如果不想单独定义类，可以用LinkedHashMap作为存储容器，它会严格保留键值对的插入顺序，不需要按索引获取元素，直接遍历EntrySet就能按插入顺序填充表格：

  public void typeLanguages(@NotNull LinkedHashMap<String, SkillLevel> languageSkillMap) {
      int rowIndex = 0;
      for (Map.Entry<String, SkillLevel> entry : languageSkillMap.entrySet()) {
          typeAndConfirm(languagesFld.get(rowIndex), entry.getKey());
          typeAndConfirm(skillFld.get(rowIndex), entry.getValue().getLangSkill());
          rowIndex++;
      }
  }
  

  注意不要用HashMap或者TreeMap，前者不保证插入顺序，后者会按键的自然排序重排元素，都会打乱你预设的配对顺序。
• 用JDK内置的简单键值对类做轻量容器
  如果只是临时使用、不想额外定义类，JDK本身就内置了轻量的二元键值对实现AbstractMap.SimpleEntry/AbstractMap.SimpleImmutableEntry，把这类对象放到List里，既能保留顺序，又能保证键值配对正确，不需要引入任何第三方依赖：

  public void typeLanguages(@NotNull List<Map.Entry<String, SkillLevel>> items) {
      IntStream.range(0, items.size()).forEach(i -> {
          Map.Entry<String, SkillLevel> current = items.get(i);
          typeAndConfirm(languagesFld.get(i), current.getKey());
          typeAndConfirm(skillFld.get(i), current.getValue().getLangSkill());
      });
  }
  

  组装数据时直接new AbstractMap.SimpleEntry<>("英语", SkillLevel.NATIVE)即可，使用成本很低。

不推荐在业务代码里使用第三方库提供的通用元组类（比如Apache Commons的Pair、Vavr的Tuple2），这类通用结构没有业务语义，后续维护时其他开发者无法直接从类型定义看懂这组配对的业务含义，维护成本远高于自定义专用类。

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