CommonLang3-使用介绍

学习要带着目的,参照现实问题

本次目标:

  • 了解 CommonsLang3 API 文档,找对路后以后开发直接查询 API 文档,摈弃盲目的百度
  • 掌握基础的字符串、日期、数值等工具方法,初步替代手搓的工具类

为什么要用 CommonsLang3?

  • 比自己手写的工具方法安全性高,不易出 Bug
  • 第三方工具包,便于携带,开箱即用,一通百通,再也不用收集各种工具方法了

介绍

Common3Lang3官网

The standard Java libraries fail to provide enough methods for manipulation of its core classes. Apache Commons Lang provides these extra methods.

Apache Commons Lang provides a host of helper utilities for the java.lang API, notably String manipulation methods, basic numerical methods, object reflection, concurrency, creation and serialization and System properties. Additionally it contains basic enhancements to java.util.Date and a series of utilities dedicated to help with building methods, such as hashCode, toString and equals.

意:Java 标准库没有提供足够的方法去操作核心类,于是 Apache Commons Lang 就补充了这些方法。

Apache Commons Lang 为 java.lang 中的核心类提供了一系列辅助工具 API,尤其是字符串操作方法,基础数字方法,对象反射,并发,创建和序列化以及系统属性。另外它还包括对 java.util.Date 的基础增强,还有一系列实用工具用来辅助 building 方法,比如 hashCode,toString 和 equals。

CommonsLang3 和 CommonsLang 的区别:Lang3 可以看做是 Lang 的高阶版本,二者同源不同库,使用上并不兼容。建议使用 Lang3 库

CommonsLang3 API 文档

都是有些简单的英文,再加上翻译软件,有点耐心都能看懂。

字符串

文档中写的非常非常非常清楚,一定要看文档,看源码也行!!

日期实践

java 复制代码
String[] datePatterns = new String[] {"yyyy-MM-dd HH:mm:ss", "yyyy-MM-dd"};
String dateStr = "2025-02-18 11:06:20";
Date date = DateUtils.parseDate(dateStr, Locale.CHINESE, datePatterns);
log.info("字符串转为日期:{}", date);

String str = DateFormatUtils.format(date, datePatterns[0]);
log.info("日期转为字符串:{}", str);

对象工具类

在实际开发中,有大量嵌套属性的判空操作,比如以下:

java 复制代码
Employee employee = this.getEmployee();
// 如果员工不空,且员工所属部门也不空,则 do something
if (employee != null && employee.getDepartment() != null) {
	log.info("!=null:all not null");
}
// 使用 Objects 
if (Objects.nonNull(employee) && Objects.nonNull(employee.getDepartment())) {
	log.info("Objects.nonNull:all not null");
}
// 使用 CommangsLang3 ObjectUitis,等同于以上两种写法,但是更加简洁明了
if (ObjectUtils.allNotNull(employee, employee.getDepartment())) {
	log.info("ObjectUtils.allNotNull:all not null");
}

还有大量设置默认值的操作,比如【如果为空,则设置默认值】

java 复制代码
 Employee emp = new Employee("张三");
//emp.setDepartment(new Department("测试"));
// 条件判断:如果员工对象部门为空,则默认创建一个部门
Department depart0 = emp.getDepartment();
if (Objects.isNull(depart0)) {
	depart0 = new Department("开发0");
}
log.info("部门: {}", depart0.getName());
// Optional 新写法1
Department depart1 = Optional.ofNullable(emp.getDepartment()).orElse(new Department("开发1"));
log.info("部门: {}", depart1.getName());
// Optional 新写法2
Department depart2 = Optional.ofNullable(emp.getDepartment()).orElseGet(() -> new Department("开发2"));
log.info("部门: {}", depart2.getName());
// Lang3 defaultIfNull 等同于 Optional 新写法1
Department depart3 = ObjectUtils.defaultIfNull(emp.getDepartment(), new Department("开发3"));
log.info("部门: {}", depart3.getName());
// Lang3 getIfNull 等同于 Optional 新写法2
Department depart4 = ObjectUtils.getIfNull(emp.getDepartment(), () -> new Department("开发4"));
log.info("部门: {}", depart4.getName());
  • orElse 无论 Optional 的值是否为 null,都会计算 default 的值。
  • orElseGet 只有当 Optional 的值为 null 时,才会去计算函数表达式的值,类似于懒加载,功能上相当于短路。
    所以建议使用 Optional.orElseGet() 或 ObjectUtils.getIfNull() 方法。

StringUtils 中也有 defulatIfEmpty 这种带有简单逻辑判断的方法,这或许也是一种规律,将简单判断/逻辑封装为方法

相关推荐
AI_Gump31 分钟前
【AI阅读】20250717阅读输入
java·spring boot·spring
找不到、了1 小时前
Java排序算法之<插入排序>
java·算法·排序算法
设计师小聂!1 小时前
力扣热题100----------53最大子数组和
java·数据结构·算法·leetcode
笠码1 小时前
JVM Java虚拟机
java·开发语言·jvm·垃圾回收
thginWalker2 小时前
八股文之JVM
java
Cyanto2 小时前
MyBatis-Plus高效开发实战
java·开发语言·数据库
qhd吴飞2 小时前
mybatis 差异更新法
java·前端·mybatis
YuTaoShao2 小时前
【LeetCode 热题 100】51. N 皇后——回溯
java·算法·leetcode·职场和发展
null不是我干的3 小时前
基于黑马教程——微服务架构解析(一)
java·微服务·架构
Bonnie_12153 小时前
04-netty基础-Reactor三种模型
java·nio·jetty