经过调研和细致观察,我们发现空链对于初次接触或是对Stream和Optional不太熟悉的人来说,确实存在一定的上手难度,宛如开启了“地狱模式”。为了降低这一门槛,我们决定通过一系列由简入深的案例演示,来逐步引导大家掌握空链的用法。当然,由于空链功能丰富,这里无法涵盖全部内容,但足以帮助大家入门。入门之后,建议结合相应的接口API进行深入学习和实践。为了方便大家在使用时快速找到参考,我们会在源码包中为每个方法都配备一份demo,确保大家在实践中能够有据可依,快速上手。
💡命名解释
空链里的“is”、“non”和“of”,一开始是不是让你觉得有点像谜语,不太好懂?别急,咱们来简单解密一下!
“is”就像侦探在问:“你是不是那个NULL?” 就像在玩捉迷藏,侦探在找NULL,问“你藏好了吗?”
“non NULL”呢,就像一个人在说:“我不是NULL,别搞错了!” 就像在一群人中,有个人站出来说自己不是那个要找的人。
“of NULL”就像团队标志,说:“我是NULL团队的!” 就像穿队服的人,一看就知道是哪个团队的。
现在,把这些词放在一起,是不是觉得它们都有了自己的小故事?
“is NULL”就是侦探找到了NULL,说:“就是你!”
“non NULL”就是那个人在说:“不是我,你找错人了!”
“of NULL”就是那个人在说:“我是NULL团队的,我们团队很有特色!”
这样一来,是不是觉得这些命名都变得简单有趣了?
💡神奇的 of
在空链中of 是核心中的核心,万物都是有一个规律从生到死, 从开始到结束,有始有终, 在浩瀚无垠的数字宇宙中,存在着一条名为“空链”的神秘链条,它超越了时间与空间的界限,承载着万物生灭的奥秘。在这条链条上,“of”是至高无上的符号,它既是起点,也是归宿,象征着一切有始有终的宇宙法则。
当第一缕数据之光闪烁时,“of”作为最初的指令被激活。它不仅是空链的基石,更是万物诞生的催化剂。随着“of”的觉醒,空链上开始涌现出各式各样的任务,每个任务都代表着一个生命或事物的初始形态,它们带着“of”赋予的潜能,踏上了各自的旅程。
在空链的流转中,每个任务都遵循着“of”所设定的规律,经历着从生到死、从开始到结束的完整周期。它们或成长、或繁衍、或衰老,每一步都伴随着数据的交换与能量的转化。而“of”作为这一切的见证者,始终默默地守护着每一个生命的轨迹,确保它们能够按照既定的轨迹前行。
当任务达到生命的终点时,它们并不真正消逝,而是化作空链上的一抹数据尘埃,回归到“of”的怀抱中。在这里,它们经历了短暂的休憩与重组,然后再次被“of”唤醒,以全新的形态重新踏上空链的旅程。这就是“of”所赋予的轮回之力,它让万物在生与死之间循环往复,生生不息。
空链安装教程
Hello World
String var= "Hello World";
Null.of(var).ifPresent(System.out::println);
这句代码的意思: 当 var 不是空的时候将执行 System.out::println
打印出 Hello World
, 好了这只是小试牛刀,我们继续往下学习。
类型切换
类型切换在链式中非常重要,是最为核心和常用的操作,当一个对象是 User 其内部有一个 Role 对象,然后想获取 Role 的名称,那么我们该怎么操作呢?
//往常我们会这样处理
User user=...
if( user != null && user.getRole != null && user.getRole().getName != null ){
//xxxxxxxx
}
//如果用空链那么看看是怎么解决的
Null.of(user).map(User::getRole).map(Role::getName).ifPresent((name)->{
//xxxx
})
//或者
if(Null.of(user).map(User::getRole).map(Role::getName).non()){
//xxxx
}
看样子空链并没有节约多少代码,那么空链的优势是啥?
- 代码理解与编写效率:熟悉空链后,你会发现其在写代码的效率比传统的if语句更高且更准确。空链的设计使得代码逻辑更加清晰,便于理解和维护。
- 高度可拔插性:空链过程每个节点都支持Lambda方式直接替换,这意味着你可以轻松地用静态方法或类方法替换某个节点的逻辑,而无需担心影响整体逻辑结构。这种高度可拔插的特性极大地提高了系统的灵活性和可扩展性。
- 避免空指针遗漏:空链的设计有效避免了空指针遗漏的问题,使得系统在运行过程中更加稳定可靠,减少了因空指针异常而导致的崩溃或错误。
复杂场景的效果如下: 这块逻辑就是通过协议号取出来费率, 如果有就直接返回了, 没有就返回 success。
**注意: **
- 绿色字体是我 IDEA 的一个插件自动把内部注释给提取出来了
- 在使用
orElse
方法时,请注意其内部对默认值有限制。切勿将默认值设置为""
(空字符串)、null
、new ArrayList()
(空列表)等无效或可能引起问题的值。这些做法通常意味着代码存在逻辑问题。请仔细思考默认值的用途,并确保其合理且有效。如果无法确定合适的默认值,建议考虑使用ifPresent
或其他相关方法来处理。这些限制并非不合理,而是基于前人经验,旨在避免你陷入常见的编程陷阱。请遵守这些规范,以确保代码的健壮性和可靠性
多字段处理
需求: 当 user 对象内 a,b 字段不是空, 并且 c 是空的时候,并且 a==“123”, 才满足条件继续执行。
//往常我们会这样处理
User user=...
if( user != null && user.getA() != null && user.getB() !=null && user.getC() == null && "123".equals(user.getA())){
//xxxxxxxxxxx
}
// 如果涉及是字符串的场景那么复杂度*2 , 如果用空链那么看看是怎么解决的
if(Null.of(user).of(User::getA).of(User::getB).isNull(User::getC).map(User::getA).eq("123")){
//xxxxxxxxxxx
}
//简化写法
if(Null.of(user).ofAny(User::getA,User::getB).isNull(User::getC).map(User::getA).eq("123")){
//xxxxxxxxxxx
}
扩展案例: 支持定制化的个性逻辑处理
流处理
Java 中的 Stream API 想必大家都不陌生,也都在日常开发中频繁使用过。Stream API 在处理列表、集合等相关数据结构时,极大地简化了代码逻辑,减少了代码量,并降低了复杂度。通过提供声明式编程风格,它让开发者能够更加专注于业务逻辑,而无需过多关注底层实现的细节。
Stream API 提供了丰富的操作方法,如过滤(filter)、映射(map)、排序(sorted)、聚合(collect)等,使得数据处理变得更加直观和高效。此外,Stream 还支持并行处理,能够充分利用多核 CPU 的优势,进一步提升处理性能。
在实际应用中,Stream API 已经成为处理集合数据的首选方式之一。它不仅能够提高开发效率,还能够提升代码的可读性和可维护性。
在空链中完美的集成了Stream, 让你从一个 空链 -》 流处理 -》 空链
在这个过程中的使用体验与Stream API无差异,你无需改变已有的编程习惯或思维方式。无论是过滤、映射、排序还是聚合等操作,都可以轻松地在空链中实现。这种集成不仅简化了数据处理逻辑,还提高了代码的可读性和可维护性。你可以更加专注于业务逻辑的实现,而无需过多关注底层数据结构的转换和处理。
因为大家都对流比较了解了, 这里直接贴上稍微复杂点的场景提供参考和思路。
如果上面的代码比较难理解可以像我这样展开写
万能时间处理
在空链中,我们精心提供了三种强大的时间处理功能:时间偏移、时间比较和时间格式化。这三种功能不仅基本覆盖了我们在日常工作中所需处理时间的大部分场景,而且其兼容性之广、处理范围之全面,使得它们成为了时间处理的“万能工具”。更令人欣喜的是,这些功能使用起来极其简单,无需复杂的操作或深厚的编程功底,即可轻松上手,满足各种时间处理需求。无论是进行时间的加减运算、比较两个时间点的先后,还是将时间格式化成特定的字符串形式,空链都能提供便捷、高效的解决方案。
需求: 获取当前月初的时间 , 获取当前月初+1 年-1 天的时间 , 数据存储要求为数字格式yyyyMMdd
, 如果用空链实现效果如下:
//获取到月初的时间
Integer monthStart = Null.of(new Date()).dateOffset(DateOffsetEnum.START, TimeEnum.MONTHS).dateFormat(DateFormatEnum.NUM_DATE_PATTERN).map(Integer::parseInt).get();
System.out.println(monthStart); //20250301
//拿到月初的时间直接在此基础上+1年 -1天, 返回的是传入的格式 yyyyMMdd
Integer endStart = Null.of(monthStart)
.dateOffset(DateOffsetEnum.ADD, 1, TimeEnum.YEARS)
.dateOffset(DateOffsetEnum.SUB, 1, TimeEnum.DAYS).get();
System.out.println(endStart); //20260228
支持的时间格式:
-
Date
-
LocalDate
-
LocalDateTime
-
10位时间戳(数字或者字符串)
-
13位时间戳(数字或者字符串)
-
格式化的时间格式字符串,
DateFormatEnum
这里面有支持的全部类型
HTTP 化繁为简
在空链的 http 中所有的请求参数必须通过空链上个任务传递的, 不支持直接传递 , 兼容 Map
和 对象
请按照日常请求的规范来使用。
GET http://127.0.0.1:8798/user/userInfo/get?password=123456&username=admin
Map<String,String> from=new HashMap<>();
from.put("username","admin");
from.put("password","123456");
Null.of(from).http("http://127.0.0.1:8798/user/userInfo/get").get().toStr().ifPresent(System.out::println);
UserInfo userEntity = new UserInfo();
userEntity.setUsername("huanmin");
userEntity.setPassword("123456");
Null.of(userEntity).http("http://127.0.0.1:8798/user/userInfo/get").get().toStr().ifPresent(System.out::println);
String param = "username=admin&password=123456";
Null.of(param).http("http://127.0.0.1:8798/user/userInfo/get").get().toStr().ifPresent(System.out::println);
String param1 = "username=admin";
Null.of(param1).http("http://127.0.0.1:8798/user/userInfo/get?password=123456").get().toStr().ifPresent(System.out::println);
//参为Void.TYPE 表示没有参数
Null.of(Void.TYPE).http("http://www.baidu.com").get().toStr().ifPresent(System.out::println);
POST http://127.0.0.1:8798/user/userInfo/post/json
Map<String,Object> from=new HashMap<>();
from.put("username","admin");
from.put("password","123456");
Null.of(from).http("http://127.0.0.1:8798/user/userInfo/post/json").post(OkHttpPostEnum.JSON).toStr().ifPresent(System.out::println);
UserInfo userEntity = new UserInfo();
userEntity.setUsername("huanmin");
userEntity.setPassword("123456");
Null.of(userEntity).http("http://127.0.0.1:8798/user/userInfo/post/json").post(OkHttpPostEnum.JSON).toStr().ifPresent(System.out::println);
注意: 发送的是 application/json; charset=utf-8
协议, 数据会放入请求体中。
POST http://127.0.0.1:8798/user/login/post/form
Map<String,Object> from=new HashMap<>();
from.put("username","admin");
from.put("password","123456");
Null.of(from).http("http://127.0.0.1:8798/user/login/post/form").post(OkHttpPostEnum.FORM).toStr().ifPresent(System.out::println);
Null.of(userEntity).http("http://127.0.0.1:8798/user/login/post/form").post(OkHttpPostEnum.FORM).toStr().ifPresent(System.out::println);
注意: 发送的是application/x-www-form-urlencoded
协议, 数据会放入请求体中。
POST http://127.0.0.1:8798/upload/file 文件上传
Map<String,Object> from=new HashMap<>();
from.put("file", new File(filePatch));
Null.of(from).http("http://127.0.0.1:8798/upload/file").post(OkHttpPostEnum.FILE).toStr().ifPresent(System.out::println);
UserInfo userEntity = new UserInfo();
userEntity.setFile(new File(filePatch));
Null.of(userEntity).http("http://127.0.0.1:8798/upload/file").post(OkHttpPostEnum.FILE).toStr().ifPresent(System.out::println);
注意:
- 发送的是
multipart/form-data
协议。 - 自动识别
File 和 byte[]
,File[] 和 byte[][]
- 如果使用的是对象支持@JSONField 给属性起别名
POST http://127.0.0.1:8798/download/file 文件下载
String fileParam="filePath=test.nf";
Null.of(fileParam).http("http://127.0.0.1:8798/download/file").get().downloadFile("D:/test.nf").ifPresent(System.out::println);
Null.of(fileParam).http("http://127.0.0.1:8798/download/file").get().toBytes().ifPresent(System.out::println);
Null.of(fileParam).http("http://127.0.0.1:8798/download/file").get().toInputStream().ifPresent(System.out::println);
还有其他的各种操作这里就不演示了, 支持 GET POST DELETE PUT
这常用的 4 种协议, 以及一些常规的操作。
扩展
静态方法
目前空链中的静态方法, 后期可能会不断地增加, 静态方法在lambda 中是可以直接通过 类名::方法名
称表示的 ,这样可以在很多场景下非常容易直接嵌入到链式代码中。
上图可能不全可以自行到Null 和 NullUtil
里面查看
空链核心的 4 种接口
空链核心提供了四种接口,涵盖了其所有关键功能:
- NullChain:这是空链的过程方法接口,汇聚了所有处理流程中的核心方法。
- NullConvert:此接口专注于转换方法,提供了各种将数据类型进行转换的实用工具。
- NullTools:作为工具方法接口,它汇集了空链中所有辅助性和实用性的方法,便于日常开发使用。
- NullFinality:这是空链的终结方法接口,包含了所有用于结束处理流程或确定最终结果的方法。
通过这四种接口,您可以轻松找到空链的所有相关方法调用,以及深入探索其各种内部实现API。
更多高级特性
Java-空链手册