当前位置：首页 > ds >正文

Hutool中的Pair类详解

ds 2025/7/5 0:35:23

1. Pair类概述

Hutool工具库中的Pair类是一个简单的键值对数据结构，用于存储两个相关联的对象。它类似于Map的Entry，但更加轻量级，适用于需要临时存储两个相关联数据的场景。

2. Pair类的主要特点

简单轻量：不依赖复杂的数据结构
不可变：一旦创建，键值不可修改（Hutool的Pair是不可变的）
泛型支持：可以存储任意类型的对象
实用方法：提供了一些便捷的操作方法

3. Pair类的使用场景

需要临时存储两个相关联的值时
方法需要返回两个相关结果时
替代简单的Map.Entry使用
需要将两个值作为单一对象传递时

4. Pair类的基本使用

创建Pair对象

// 使用of方法创建
Pair<String, Integer> pair = Pair.of("age", 25);// 使用构造方法创建（Hutool 5.x版本后推荐使用of方法）
Pair<String, Integer> pair = new Pair<>("age", 25);

获取键值

String key = pair.getKey();   // 获取键
Integer value = pair.getValue(); // 获取值

使用示例

// 返回两个相关值
public Pair<String, Integer> getUserInfo() {String name = "张三";int age = 30;return Pair.of(name, age);
}// 使用示例
Pair<String, Integer> userInfo = getUserInfo();
System.out.println("姓名: " + userInfo.getKey());
System.out.println("年龄: " + userInfo.getValue());

5. Pair类的实用方法

Hutool的Pair类还提供了一些实用方法：

equals()：比较两个Pair是否相等
hashCode()：获取Pair的哈希值
toString()：转换为字符串表示

Pair<String, Integer> pair1 = Pair.of("a", 1);
Pair<String, Integer> pair2 = Pair.of("a", 1);System.out.println(pair1.equals(pair2)); // true
System.out.println(pair1.toString());    // (a,1)

6. Pair与其他类似结构的比较

特性	Hutool Pair	Map.Entry	Apache Commons Pair	Java Record
可变性	不可变	通常可变	不可变	不可变
功能丰富度	简单	中等	中等	简单
是否需要Map上下文	不需要	需要	不需要	不需要
Java版本要求	无	无	无	Java 14+

7. 实际应用案例

案例1：返回多个值

public Pair<Boolean, String> validateUser(String username, String password) {if (StringUtil.isEmpty(username)) {return Pair.of(false, "用户名不能为空");}if (StringUtil.isEmpty(password)) {return Pair.of(false, "密码不能为空");}// 验证逻辑...return Pair.of(true, "验证成功");
}

案例2：简化临时数据存储

List<Pair<String, Integer>> nameAgePairs = new ArrayList<>();
nameAgePairs.add(Pair.of("张三", 25));
nameAgePairs.add(Pair.of("李四", 30));for (Pair<String, Integer> pair : nameAgePairs) {System.out.println(pair.getKey() + ": " + pair.getValue());
}