Hutool 是一個開源的 Java 工具庫，提供了豐富且實(shí)用的功能，旨在減少 Java 程序員在日常開發(fā)中重復(fù)造輪子的工作。在 Hutool 中，Pair、Triple 和 Tuple 是三種用于組合和存儲不同數(shù)量相關(guān)聯(lián)數(shù)據(jù)的類。以下是這三個類的簡介：

1、添加依賴

<dependency><groupId>org.dromara.hutool</groupId><artifactId>hutool-all</artifactId><version>6.0.0-M12</version>
</dependency>

2、Pair、Triple 和 Tuple介紹

2.1、 Pair

Pair 用于存儲兩個元素的鍵值對，通常包含一個鍵和一個值。這種結(jié)構(gòu)在需要將兩個相關(guān)聯(lián)的數(shù)據(jù)項(xiàng)作為一個單元進(jìn)行操作時非常有用。

• 鍵值結(jié)構(gòu)：提供鍵（left）和值（right）兩種數(shù)據(jù)的存儲。
• 不可變性：一旦創(chuàng)建，Pair 中的值不能被修改，保證了數(shù)據(jù)的不可變性和線程安全。
• 使用場景：存儲用戶ID和名稱、記錄商品價格和庫存數(shù)量等。

2.2、 Triple

Triple 類似于 Pair并繼承于Pair，但它可以存儲三個元素。它同樣提供了不可變性，確保數(shù)據(jù)的穩(wěn)定性。

• 三個元素：可以看作是Pair 的組合。
• 不可變性：值不可修改。
• 使用場景：用于存儲更復(fù)雜的數(shù)據(jù)關(guān)系，如姓名、年齡和性別，或者訂單的ID、價格和狀態(tài)等。

2.3、 Tuple

Tuple 是一種在 Java 中使用的不可變數(shù)據(jù)結(jié)構(gòu)，用于存儲任意數(shù)量的元素。與 Pair 和 Triple 不同，Tuple 不強(qiáng)制要求有固定的元素?cái)?shù)量，可以存儲多個元素，但它不支持修改、添加或刪除元素。

• 不可變性：Tuple 對象創(chuàng)建后，其內(nèi)部的元素是不可變的，這意味著一旦創(chuàng)建，就不能更改 Tuple 中的任何元素。
• 可存儲的元素?cái)?shù)量：Tuple 可以存儲任意數(shù)量的元素，但創(chuàng)建 Tuple 時必須指定要存儲的元素?cái)?shù)量。
• 使用場景：適用于需要存儲多個值但不關(guān)心鍵值對結(jié)構(gòu)的情況，例如訂單詳情、配置參數(shù)等。

3、 Pair 的創(chuàng)建和修改

3.1、 創(chuàng)建 Pair

// 用戶名修改為 "Alice Smith"
userPair = Pair.of(userPair.getLeft(), "Alice Smith");
int userId = userPair.getLeft();
String userName = userPair.getRight();

3.2、修改 Pair 中的值

// 創(chuàng)建一個新的 Pair，值已被修改
Pair<Integer, String> newPair = Pair.of(pair.getLeft(), "banana");

3.3、 使用場景示例

Pair 類在以下場景下特別適用，因?yàn)樗峁┝艘粋€簡單的方式來組合和操作兩個相關(guān)聯(lián)的數(shù)據(jù)項(xiàng)，特別是方法需要返回兩個值得情況下特別好用，嘎嘎香：

1. 鍵值對操作：當(dāng)你需要將兩個數(shù)據(jù)項(xiàng)關(guān)聯(lián)起來，其中一個作為鍵（key），另一個作為值（value）時，Pair 類非常有用。例如，用戶ID和用戶姓名、商品ID和價格等。

   Pair<Integer, String> userIdAndName = Pair.of(1, "Alice");
   

2. 映射關(guān)系：Pair 類可以用來表示簡單的映射關(guān)系，如單詞和翻譯、文件路徑和描述等。

   Pair<String, String> wordTranslation = Pair.of("hello", "你好");
   

3. 元數(shù)據(jù)存儲：當(dāng)你需要存儲與某個實(shí)體相關(guān)的兩個元數(shù)據(jù)項(xiàng)時，Pair 類可以用來封裝這些信息。

   Pair<String, String> metaData = Pair.of("title", "Example Title");
   

4. 返回結(jié)果：在函數(shù)或方法返回兩個相關(guān)結(jié)果時，Pair 類提供了一種比基本數(shù)據(jù)類型數(shù)組更具有描述性和類型安全的方式。

   Pair<Integer, Boolean> calculationResult = Pair.of(42, true);
   

5. 狀態(tài)封裝：在某些情況下，你可能需要將兩個狀態(tài)相關(guān)的字段封裝在一起，Pair 類可以用來實(shí)現(xiàn)這一點(diǎn)。

   Pair<String, String> statusPair = Pair.of("status", "active");
   

6. 篩選條件：在處理集合或列表時，Pair 類可以用來存儲篩選條件，例如在實(shí)現(xiàn)自定義的過濾邏輯時。

   Pair<String, String> filterCondition = Pair.of("field", "value");
   

7. 排序輔助：在需要對列表進(jìn)行排序，同時需要根據(jù)兩個條件進(jìn)行比較時，Pair 類可以用來封裝排序的鍵。

   List<Pair<String, Integer>> sortedList = lists.stream().map(name -> Pair.of(name, calculateScore(name))).sorted(Comparator.comparing(Pair::getRight)).collect(Collectors.toList());
   

8. 并發(fā)編程：由于 Pair 類是不可變的，它可以在并發(fā)環(huán)境中安全地共享，這在需要實(shí)現(xiàn)線程安全的程序時非常有用。

Pair 類的設(shè)計(jì)簡潔且易于使用，它為處理簡單的數(shù)據(jù)關(guān)聯(lián)提供了輕量級和類型安全的解決方案。在任何需要將兩個數(shù)據(jù)項(xiàng)作為一對進(jìn)行操作的場景中，Pair 類都是一個很好的選擇。

4、 Triple 的使用

riple 和 Tuple 的使用與 Pair 類似

• 獲取 Triple 中的值

Triple<String, Integer, Boolean> triple = Triple.of("name", 25, true);
String name = triple.getLeft();
int age = triple.getMiddle();
boolean isActive = triple.getRight();

Triple 類在以下場景下比較適用，因?yàn)樗试S你存儲和操作三個相關(guān)聯(lián)的數(shù)據(jù)項(xiàng)，這些數(shù)據(jù)項(xiàng)可能共同描述了一個完整的概念或?qū)嶓w：

1. 復(fù)雜實(shí)體描述：當(dāng)你需要表示一個包含三個不同屬性或狀態(tài)的實(shí)體時，Triple 非常有用。例如，一個學(xué)生的記錄可能包含姓名、年齡和成績。

   Triple<String, Integer, Integer> studentInfo = Triple.of("Alice", 20, 90);
   

2. 關(guān)聯(lián)數(shù)據(jù)集：在處理需要三個字段來關(guān)聯(lián)多個數(shù)據(jù)集時，Triple 類可以幫助你保持?jǐn)?shù)據(jù)的一致性和清晰性。例如，你可以使用 Triple 來存儲兩個日期（開始和結(jié)束）以及與這兩個日期相關(guān)的值。

   Triple<LocalDate, LocalDate, Double> salesData = Triple.of(startDate, endDate, salesAmount);
   

3. 業(yè)務(wù)規(guī)則參數(shù)：在某些業(yè)務(wù)邏輯中，你可能需要三個參數(shù)來定義一個規(guī)則或條件。Triple 可以用來封裝這些參數(shù)。

   Triple<Double, Double, Double> discountRule = Triple.of(minimumAmount, maximumAmount, discountRate);
   

4. 配置數(shù)據(jù)：如果你有一個配置文件或數(shù)據(jù)庫表，其中需要三個字段來存儲配置信息，Triple 可以用來封裝這些配置數(shù)據(jù)。

   Triple<String, String, Integer> databaseConfig = Triple.of("host", "localhost", 3306);
   

5. 數(shù)據(jù)聚合：在需要將三個相關(guān)數(shù)據(jù)項(xiàng)聚合為一個單元時，Triple 類可以簡化代碼并減少錯誤。

   Triple<Integer, Integer, Integer> scoreStats = Triple.of(minScore, maxScore, averageScore);
   

6. 映射和轉(zhuǎn)換：在數(shù)據(jù)處理和轉(zhuǎn)換過程中，當(dāng)需要將三個不同的源數(shù)據(jù)項(xiàng)映射到三個不同的目標(biāo)數(shù)據(jù)項(xiàng)時，Triple 類可以幫助你保持?jǐn)?shù)據(jù)的一致性。

   Triple<String, Integer, String> keyToValueMap = Triple.of("key1", 1, "value1");
   

總之，Triple 類在需要表示或操作三個獨(dú)立但相關(guān)聯(lián)的數(shù)據(jù)項(xiàng)時非常有用，它可以提供一種簡潔、類型安全的方式來處理這些數(shù)據(jù)。

5、 Tuple 的使用

Tuple 類在 Java 中用于存儲一組任意數(shù)量的元素

• 獲取 Tuple 中的值

Tuple tuple = Tuple.of(1, "apple", true);
int id = tuple.get(0);
String name = tuple.get(1);
boolean active = tuple.get(2);

1. 函數(shù)返回值：當(dāng)需要一個方法返回多個值，但這些值之間沒有明確的鍵值關(guān)系時，可以使用 Tuple。

   // 假設(shè) calculateSum 返回三個整數(shù)值：總和、最大值和最小值
   Tuple<Integer, Integer, Integer> sumMinMax = calculateSum(1, 2, 3, 4, 5);
   

2. 參數(shù)封裝：當(dāng)你需要將多個參數(shù)組合在一起傳遞給一個方法或構(gòu)造器時，Tuple 可以用來封裝這些參數(shù)。

   Tuple<String, Integer, Boolean> userInfo = Tuple.of("Alice", 25, true);
   

3. 事件或消息：在處理事件驅(qū)動或消息傳遞系統(tǒng)時，Tuple 可以用來封裝事件或消息的多個相關(guān)屬性。

   Tuple<String, String, Integer> messageInfo = Tuple.of("SMS", "Your order has been shipped", 123456);
   

4. 配置數(shù)據(jù)：在處理配置文件或系統(tǒng)設(shè)置時，Tuple 可以用來存儲多個配置項(xiàng)。

   Tuple<String, String, String> appConfig = Tuple.of("host", "http://localhost:8080", "username", "admin");
   

5. 復(fù)合統(tǒng)計(jì)：在需要進(jìn)行復(fù)雜的統(tǒng)計(jì)計(jì)算時，Tuple 可以用來封裝多個相關(guān)的統(tǒng)計(jì)結(jié)果。

   Tuple<Integer, Double, Double> stats = Tuple.of(count, average, standardDeviation);
   

6. 數(shù)據(jù)導(dǎo)出：在使用數(shù)據(jù)導(dǎo)出功能時，Tuple 可以用來封裝一行或多行數(shù)據(jù)。

   Tuple<String, String, String, String> exportRow = Tuple.of("id", "name", "email", "status");
   

7. 自定義對象：當(dāng)需要創(chuàng)建一個包含多個字段的自定義對象，但這些字段之間沒有直接的關(guān)聯(lián)關(guān)系時，Tuple 可以用來構(gòu)建這個對象。

   Tuple<Integer, Double, String> productDetails = Tuple.of(productId, price, description);
   

8. 通用數(shù)據(jù)結(jié)構(gòu)：在那些需要靈活存儲多個數(shù)據(jù)項(xiàng)，但不需要特定鍵值對結(jié)構(gòu)的場景中，Tuple 是一個通用且靈活的選擇。

   Tuple<String, Integer, Double, Boolean> complexData = Tuple.of("name", 123, 456.78, false);
   

Tuple 類的優(yōu)點(diǎn)在于它的靈活性和簡單的使用方式，它允許開發(fā)者以非常直觀的方式組合和傳遞多個數(shù)據(jù)項(xiàng)。然而，由于 Tuple 沒有提供明確的鍵名稱，因此在使用時可能需要更多的上下文信息或者通過位置索引來訪問內(nèi)部的元素。