Apache Commons 工具包简述
用 Java 编程时，你可能会发现很多重复的工作：字符串处理、文件操作、集合操作……这些看似简单的任务，有时候却能花费大量的时间。而 Apache Commons，正是为了解决这些问题而诞生的，它是一个由 Apache Software Foundation 提供的一系列工具类库，专门用来简化 Java 开发中的常见任务。
Apache Commons 是什么？
Apache Commons 包含一系列功能丰富的工具类库，每个库专注于一个特定的领域，帮助你处理日常开发中经常遇到的常见问题。你可以把它们理解成“开箱即用”的解决方案，无需重复造轮子。即使你是 Java 新手，也能快速上手。
为什么要用 Apache Commons？
节省时间和精力：避免自己写重复的、常见的代码。高质量代码：Commons 提供的功能已经经过社区广泛的测试和优化，使用它们比自己写代码更加可靠。易于维护：它们的功能模块化、文档清晰，代码维护起来轻松。
1. Apache Commons Lang
这是最常用的一个包，提供了许多增强版的 Java 核心类，特别是 String、Object、Array、Date 等操作。
主要功能
StringUtils：用于字符串操作，特别是字符串的 null 值处理。ObjectUtils：提供对象的常见操作，比如比较、克隆等。NumberUtils：用于数字处理，特别是字符串转数字的安全操作。RandomStringUtils：生成随机字符串。
示例代码
import org.apache.commons.lang3.StringUtils;
public class CommonsLangExample {
public static void main(String[] args) {
String str = null;
// 使用 StringUtils 来避免 NullPointerException
if (StringUtils.isEmpty(str)) {
System.out.println("字符串为空或为null");
}
// 反转字符串
String reversed = StringUtils.reverse("abcd");
System.out.println("反转后的字符串: " + reversed); // 输出: "dcba"
}
}
StringUtils.isEmpty() 可以帮你处理 null 和空字符串问题，让代码更加健壮。
2. Apache Commons IO
操作文件和输入输出流是每个 Java 程序员都会遇到的场景，Commons IO 提供了简化这些操作的类。
主要功能
FileUtils：提供便捷的文件复制、删除、读写操作。IOUtils：帮助处理流和 Reader、Writer，比如流的读取、关闭。FilenameUtils：处理文件路径和扩展名的工具类。
示例代码
import org.apache.commons.io.FileUtils;
import java.io.File;
import java.io.IOException;
public class CommonsIoExample {
public static void main(String[] args) {
try {
// 读取文件内容为字符串
File file = new File("example.txt");
String content = FileUtils.readFileToString(file, "UTF-8");
System.out.println("文件内容: " + content);
// 复制文件
File destFile = new File("copy_example.txt");
FileUtils.copyFile(file, destFile);
System.out.println("文件复制完成");
} catch (IOException e) {
e.printStackTrace();
}
}
}
这个例子中，FileUtils.readFileToString() 和 FileUtils.copyFile() 大大简化了文件操作，让代码更加简洁。
3. Apache Commons Collections
集合是 Java 中非常常见的数据结构，但标准库中的集合功能有时并不够用。Commons Collections 提供了更多高级的集合操作功能。
主要功能
CollectionUtils：增强的集合操作，比如过滤、交集、并集等。Bag：一种允许重复元素的集合。MultiMap：一种可以让一个键对应多个值的 Map。
示例代码
import org.apache.commons.collections4.CollectionUtils;
import java.util.Arrays;
import java.util.List;
public class CommonsCollectionsExample {
public static void main(String[] args) {
List
List
// 取两个集合的交集
List
System.out.println("交集: " + intersection); // 输出: [b, c]
}
}
CollectionUtils.intersection() 让集合的交集操作变得非常方便，避免了手动遍历的繁琐代码。
4. Apache Commons BeanUtils
处理 Java Bean 属性时，常常会有对象间的属性复制、反射等需求。BeanUtils 正是为了解决这些问题而存在的。
主要功能
BeanUtils.copyProperties：从一个 Bean 复制属性到另一个 Bean。PropertyUtils：用于更高级的反射操作，读取或设置 Bean 的属性。
示例代码
import org.apache.commons.beanutils.BeanUtils;
public class CommonsBeanUtilsExample {
public static void main(String[] args) {
try {
User user1 = new User("John", 25);
User user2 = new User();
// 复制 user1 的属性到 user2
BeanUtils.copyProperties(user2, user1);
System.out.println(user2.getName() + ", " + user2.getAge()); // 输出: John, 25
} catch (Exception e) {
e.printStackTrace();
}
}
}
class User {
private String name;
private int age;
public User() {}
public User(String name, int age) {
this.name = name;
this.age = age;
}
// 忽略 getters and setters...
}
BeanUtils.copyProperties() 让两个对象间的属性复制变得简单且高效。
5. Apache Commons Codec
当你需要对数据进行编码、解码时，比如 Base64 编码，或者使用常见的加密算法，Codec 就是你最好的选择。
主要功能
Base64：用于 Base64 编码和解码。DigestUtils：常用的摘要算法工具类，比如 MD5、SHA-256 等。
示例代码
import org.apache.commons.codec.binary.Base64;
public class CommonsCodecExample {
public static void main(String[] args) {
String originalInput = "test input";
// Base64 编码
String encodedString = Base64.encodeBase64String(originalInput.getBytes());
System.out.println("编码后的字符串: " + encodedString);
// Base64 解码
byte[] decodedBytes = Base64.decodeBase64(encodedString);
String decodedString = new String(decodedBytes);
System.out.println("解码后的字符串: " + decodedString);
}
}
Base64.encodeBase64String() 和 Base64.decodeBase64() 让编码和解码操作轻松搞定，特别是在处理二进制数据时很有用。
扩展阅读：
Apache Commons 官方文档