Apache Commons Lang 3，一个超厉害的 Java 工具库

在软件开发中，Java 程序员经常会面临各种重复性的任务，例如字符串处理、日期的操作、文件管理等。这些任务虽然简单，但编写代码来实现它们却很繁琐。Apache Commons Lang 就是为了解决这些问题而生的。它是一个功能强大的 Java 类库，提供了大量用于处理文本、集合、文件、日期和数学运算等方面的实用工具类。今天，我们将重点探讨其中的 commons-lang3 模块，这个模块对于提升 Java 程序员的效率有着不可忽视的作用。

commons-lang3 是什么

commons-lang3 是 Apache Commons Lang 库中的一个模块，它为 Java 程序员提供了一系列非常实用的工具类，特别是在文本处理方面。这个库包含了大量用于处理字符串、数组、集合、日期的工具类，甚至还有一些用于随机数的工具类。简而言之，commons-lang3 能够让 Java 程序员编写更少、更好的代码，从而提高工作效率。

下一节，我们将介绍如何将 commons-lang3 集成到我们的 Java 项目中，无论是使用 Maven 还是直接添加 JAR 包。

如何引入 commons-lang3

Maven 依赖配置

要在您的 Java 项目中使用 commons-lang3，首先需要通过 Maven 将其添加到 文件中。以下是一个基本的 Maven 依赖配置示例：

<dependencies>
    <!-- 其他依赖项 -->

    <!-- 添加 commons-lang3 依赖 -->
    <dependency>
        <groupId></groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.12.0</version> <!-- 使用时请检查最新版本 -->
    </dependency>

    <!-- 其他依赖项 -->
</dependencies>

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

导入包

在您的 Java 源代码文件中，需要导入 commons-lang3 包以使用其提供的类和方法。例如：

import org.apache.commons.lang3.StringUtils;
import org.apache.commons.lang3.math.NumberUtils;
import org.apache.commons.lang3.time.DateUtils;
// 根据需要导入其他相关类

• 1
• 2
• 3
• 4

确保您的项目构建系统（如 Maven 或 Gradle）已经配置了正确的依赖项，这样在编译和运行时，commons-lang3 库中的类和接口就可以被正确识别和使用。

验证依赖

在添加了依赖并重新构建项目后，您可以通过在 IDE 中运行一个简单的测试来验证 commons-lang3 是否已经被正确引入项目。例如，在 IntelliJ IDEA 中，您可以创建一个新的 Java 类或方法，并尝试调用 StringUtils 类中的一个方法，如 isNotEmpty：

public class TestCommonsLang3 {
    public static void main(String[] args) {
        String str = "Hello";
        boolean result = StringUtils.isNotEmpty(str);
        System.out.println(result); // 应输出 true
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7

如果上述代码没有引发任何编译错误，并且运行结果为 true，那么说明 commons-lang3 已经成功引入到您的项目中。

commons-lang3 使用示例

字符串处理

commons-lang3 提供了一系列字符串处理工具，比如 StringUtils，它可以帮助你轻松地完成字符串的比较、修剪、填充等操作。

import org.apache.commons.lang3.StringUtils;

public class StringExample {
    public static void main(String[] args) {
        String str = "   Hello World   ";
        System.out.println(StringUtils.trim(str)); // 输出 "Hello World"
        System.out.println(StringUtils.trimToNull(str)); // 输出 null
        System.out.println(StringUtils.isBlank(str)); // 输出 false
        System.out.println(StringUtils.substring("Hello", 1, 3)); // 输出 "el"
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11

集合处理

CollectionUtils 是处理集合的字段，可以很方便地进行集合间的操作，如转换、过滤、合并等。

import org.apache.commons.lang3.Collections;
import java.util.Arrays;
import java.util.List;

public class CollectionExample {
    public static void main(String[] args) {
        List<String> list1 = Arrays.asList("a", "b", "c");
        List<String> list2 = Arrays.asList("d", "e", "f");
        
        List<String> mergedList = Collections.addAll(list1, list2);
        System.out.println(mergedList); // 输出 ["a", "b", "c", "d", "e", "f"]

        List<String> filteredList = Collections.filter(list1, s -> s.length() > 1);
        System.out.println(filteredList); // 输出 ["b", "c"]
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16

数字处理

NumberUtils 提供了对数字进行操作的工具方法，可以进行数字的转换、判断以及格式化等。

import org.apache.commons.lang3.math.NumberUtils;

public class NumberExample {
    public static void main(String[] args) {
        String numStr = "123.456";
        double num = NumberUtils.toDouble(numStr);
        System.out.println(num); // 输出 123.456
        
        int numInt = NumberUtils.toInt(numStr); // 自动转换为 int，会丢失小数部分
        System.out.println(numInt); // 输出 123
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

日期的处理

DateUtils 提供了丰富的日期处理方法，可以方便地进行日期的添加、格式化、比较等操作。

import org.apache.commons.lang3.time.DateUtils;

import java.util.Date;

public class DateExample {
    public static void main(String[] args) {
        Date date = new Date();
        
        Date newDate = DateUtils.addDays(date, 10); // 日期向后加10天
        System.out.println(newDate);
        
        String dateStr = DateUtils.format(date, "yyyy-MM-dd HH:mm:ss");
        System.out.println(dateStr); // 输出格式化的日期字符串
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15

正则表达式

RegexUtils 提供了正则表达式的相关工具方法，可以进行正则表达式的匹配、替换等操作。

import org.apache.commons.lang3.StringUtils;
import org.apache.commons.lang3.regex.RegexUtils;

public class RegexExample {
    public static void main(String[] args) {
        String text = "The quick brown fox jumps over the lazy dog.";
        
        boolean matches = RegexUtils.match("the dog", text); // 检查 "the dog" 是否匹配
        System.out.println(matches); // 输出 false
        
        String replacedText = RegexUtils.replace("the dog", text, "cat"); // 替换 "the dog" 为 "cat"
        System.out.println(replacedText); // 输出 "The quick brown fox jumps over the lazy cat."
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14

随机数生成

RandomStringUtils 可以生成随机字符串，这在一些需要生成唯一标识符的场景非常有用。

import org.apache.commons.lang3.RandomStringUtils;

public class RandomExample {
    public static void main(String[] args) {
        String randomStr = RandomStringUtils.randomAlphabetic(10); // 生成10个字母的随机字符串
        System.out.println(randomStr); // 输出一串随机字母字符串
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8

以上就是 commons-lang3 在日常编程中的一些典型使用示例，涵盖了字符串处理、集合处理、数字处理、日期处理、正则表达式和随机数生成等多个方面，可以看出 commons-lang3 是一个功能丰富且实用的工具库。

应用场景

代码示例：

下面我们将通过几个示例来展示 commons-lang3 的应用场景。

1. 字符串处理

字符串是编程中经常遇到的基础类型。commons-lang3 为字符串处理提供了很多实用工具方法，如：() 判断字符串是否为空，() 获取字符串的子串等。

import org.apache.commons.lang3.StringUtils;

public class StringExample {
    public static void main(String[] args) {
        String str = "Hello, World!";
        if (StringUtils.isEmpty(str)) {
            System.out.println("字符串为空");
        } else {
            System.out.println("字符串不为空，子串为：" + StringUtils.substring(str, 7, 12));
        }
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

2. 集合操作

在开发中经常需要对集合进行操作，如判断集合是否为空，获取集合的交集、并集等。commons-lang3 的 CollectionUtils 类提供了这些操作的便捷方法。

import org.apache.commons.collections4.CollectionUtils;
import org.apache.commons.collections4.Predicate;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

public class CollectionExample {
    public static void main(String[] args) {
        List<String> list1 = Arrays.asList("a", "b", "c");
        List<String> list2 = Arrays.asList("c", "d", "e");

        if (CollectionUtils.isEmpty(list1)) {
            System.out.println("list1 为空");
        } else {
            System.out.println("list1 非空，且与 list2 的交集为：" + CollectionUtils.intersection(list1, list2));
        }
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19

3. 数字处理

在开发中经常会遇到数字相关的操作，如判断数字是否为整数，数字四舍五入等。NumberUtils 类提供了这些操作的便捷方法。

import org.apache.commons.lang3.math.NumberUtils;

public class NumberExample {
    public static void main(String[] args) {
        double num = 3.14;
        if (NumberUtils.isNumber(num)) {
            System.out.println("num 是一个数字，四舍五入后为：" + NumberUtils.round(num, 2));
        } else {
            System.out.println("num 不是一个数字");
        }
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

4. 文件操作

文件操作是编程中常见的需求，如读取文件内容，获取文件扩展名等。FileUtils 类提供了这些操作的便捷方法。

import org.apache.commons.io.FileUtils;

import java.io.File;
import java.io.IOException;

public class FileExample {
    public static void main(String[] args) {
        try {
            File file = new File("");
            String content = FileUtils.readFileToString(file, "UTF-8");
            System.out.println("文件内容为：" + content);
            String extension = FileUtils.getFileExtension(file);
            System.out.println("文件扩展名为：" + extension);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18

以上就是 commons-lang3 在字符串处理、集合操作、数字处理和文件操作等方面的应用场景。通过这些示例，我们可以看到 commons-lang3 库为我们提供了很多方便的工具方法，可以大大提高我们的开发效率。

总结

在本文中，我们介绍了 Apache Commons Lang 3，一个强大的 Java 工具库，它为字符串操作、文本处理、日期时间、数学运算等多种常用的编程任务提供了额外的功能。通过引入和使用 Commons Lang 3，开发人员可以减少编写标准库代码的需求，提高开发效率，并专注于业务逻辑的实现。

我们学习了如何通过 Maven 将其添加到项目中，并且通过几个实用的代码示例，体验了 Commons Lang 3 在日常编程中的便捷之处。这个库在处理文本、数据验证、异常处理、文件操作以及临时数据结构等场景中特别有用。

尽管 Commons Lang 3 功能丰富，但使用时应注意不要过度依赖，以免代码变得难以维护。合理运用这一工具库，可以在保证代码简洁的同时，提升项目的整体质量。

编程资料包领取：/s/601cbea644ff
编程、AI、副业交流：/19zcqaJ2b
领【150 道精选 Java 高频面试题】请 go 公众号：码路向前 。