在 Java 以及許多其他程式語言中，物件比較是至關重要的基礎操作之一。無論是排序、搜尋，還是資料篩選，這一功能始終貫穿於程式設計的核心流程。在 Java 中，我們既可以透過手動編寫邏輯實現物件比較，也可以藉助功能強大的第三方庫來簡化這一過程。本文將為大家詳細解析如何使用 Apache Commons Lang 3 庫高效地比較 Java 物件。
Apache Commons Lang 3 簡介
在 Java 生態系統中，Apache Commons Lang 3 是一個廣受歡迎的開源工具庫，為開發者提供多種便捷功能，幫助簡化日常程式設計任務，減少程式碼複雜度。無論是字串處理、物件操作還是日期與時間管理，它都能為開發者提供高效的解決方案，是提升工作效率的 “瑞士軍刀”。核心功能包括：
- StringUtils 提供全面的字串操作工具，支援空安全方法、字串修剪、拼接、拆分和填充等操作，廣泛應用於使用者輸入驗證和資料格式化；
-
ObjectUtils 提供物件操作工具，支援空安全的
equals、hashCode和toString方法，適合實現比較器或排序邏輯，並便於在日誌中輸出物件狀態； - DateUtils 提供日期與時間處理工具，如解析、格式化和時間差計算，幫助生成易讀的時間戳或計算活動剩餘時間；
- RandomStringUtils 可生成多種型別的隨機字串，適用於驗證碼、唯一識別符號或密碼生成；
- WordUtils 提供單詞處理功能，如首字母大寫、自動換行等，適合文字輸出和格式化。
Apache Commons Lang 3 的主要特點是簡化開發流程，避免重複造輪子，同時透過高度抽象的 API 提高程式碼可讀性和可維護性，設計中的空安全機制有效減少潛在錯誤。作為一個成熟的開源專案，它擁有豐富的文件和社群資源，適用於從企業級應用到輕量級工具開發的各種場景，是提升開發效率、減少冗餘程式碼的首選工具庫。
code 實踐
在 Maven 專案中引入 Apache Commons Lang 3，需要在專案的 pom.xml 檔案中新增以下依賴：
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.12.0</version>
</dependency>
構建專案時，Maven 會自動從中央倉庫下載 Apache Commons Lang 3 及其依賴並加入專案的類路徑中。
DiffBuilder
DiffBuilder 是 Apache Commons Lang 3 中一個類，用於比較兩個物件並生成詳細的差異報告。以下是使用步驟：
- 匯入所需的 Apache Commons Lang 3 類。
- 建立需要比較的物件例項。
- 使用
DiffBuilder構建差異報告。 - 檢查生成的
Diff物件以識別差異。
示例程式碼如下：
package com.example;
import org.apache.commons.lang3.builder.DiffBuilder;
import org.apache.commons.lang3.builder.DiffResult;
// 定義 Person 類
class Person {
private String name;
private int age;
// 構造器、Getter 和 Setter 方法
}
// 主類
public class Main {
public static void main(String[] args) {
// 建立兩個 Person 物件
Person person1 = new Person("Alice", 30);
Person person2 = new Person("Bob", 35);
// 構建差異報告
DiffResult diffResult = new DiffBuilder(person1, person2)
.append("name", person1.getName(), person2.getName())
.append("age", person1.getAge(), person2.getAge())
.build();
// 輸出差異
System.out.println("物件差異：");
diffResult.getDiffs().forEach(diff ->
System.out.println(diff.getFieldName() + ": " + diff.getLeft() + " != " + diff.getRight())
);
}
}
此示例中，DiffBuilder 根據欄位名稱逐一比較物件的 name 和 age，並輸出它們的差異。
ReflectionDiffBuilder
ReflectionDiffBuilder 透過反射機制自動比較物件的所有欄位，省去了逐欄位指定的麻煩，適合複雜物件比較。以下是使用步驟：
- 匯入必要的 Apache Commons Lang 類。
- 建立需要比較的物件例項。
- 使用
ReflectionDiffBuilder構建差異報告。 - 檢查生成的
DiffResult物件以識別差異。
示例程式碼如下：
package com.example;
import org.apache.commons.lang3.builder.EqualsBuilder;
import org.apache.commons.lang3.builder.HashCodeBuilder;
import org.apache.commons.lang3.builder.ReflectionDiffBuilder;
import org.apache.commons.lang3.builder.ToStringBuilder;
// 定義 Person 類
class Person {
private String name;
private int age;
// 構造器、Getter 和 Setter 方法
@Override
public boolean equals(Object obj) {
return EqualsBuilder.reflectionEquals(this, obj);
}
@Override
public int hashCode() {
return HashCodeBuilder.reflectionHashCode(this);
}
@Override
public String toString() {
return ToStringBuilder.reflectionToString(this);
}
}
// 主類
public class Main {
public static void main(String[] args) {
// 建立兩個 Person 物件
Person person1 = new Person("Alice", 30);
Person person2 = new Person("Bob", 35);
// 構建差異報告
DiffResult diffResult = new ReflectionDiffBuilder(person1, person2).build();
// 輸出差異
System.out.println("物件差異：");
diffResult.getDiffs().forEach(diff ->
System.out.println(diff.getFieldName() + ": " + diff.getLeft() + " != " + diff.getRight())
);
}
}
ReflectionDiffBuilder 會自動比較兩個物件的所有欄位，包括巢狀欄位或私有欄位，生成全面的比較報告。
總結
Apache Commons Lang 3 為 Java 開發者提供了一套強大的工具集，幫助簡化日常程式設計任務。在物件比較方面，DiffBuilder 提供了直觀、易用的解決方案，允許開發者快速定位物件之間的差異，大幅提升除錯效率。對於更復雜的物件，ReflectionDiffBuilder 透過反射技術深入分析物件的欄位，實現自動化的比較，無需手動列出每個欄位。
透過使用這些工具，開發者能夠最佳化開發流程，減少程式碼冗餘，提高程式碼質量，進而構建更可靠、更健壯的 Java 應用程式。
FunTester 原創精華
【連載】從 Java 開始效能測試
- 混沌工程、故障測試、Web 前端
- 服務端功能測試
- 效能測試專題
- Java、Groovy、Go
- 白盒、工具、爬蟲、UI 自動化
- 理論、感悟、影片