Java解决空引用_Java 匠人手法 - 优雅的处理空值
原标题:Java 匠人手法 - 优雅的处理空值
作者:Lrwin
导语
在笔者几年的开发经验中,经常看到项目中存在到处空值判断的情况,这些判断,会让人觉得摸不这头绪,它的出现很有可能和当前的业务逻辑并没有关系。但它会让你很头疼。
有时候,更可怕的是系统因为这些空值的情况,会抛出空指针异常,导致业务系统发生问题。
此篇文章,我总结了几种关于空值的处理手法,希望对读者有帮助。
业务中的空值
场景
存在一个UserSearchService用来提供用户查询的功能:
publicinterface UserSearchService{
List listUser;
User get(Integer id);
}
问题现场
对于面向对象语言来讲,抽象层级特别的重要。尤其是对接口的抽象,它在设计和开发中占很大的比重,我们在开发时希望尽量面向接口编程。
对于以上描述的接口方法来看,大概可以推断出可能它包含了以下两个含义:
listUser: 查询用户列表
get(Integer id): 查询单个用户
在所有的开发中,XP推崇的TDD模式可以很好的引导我们对接口的定义,所以我们将TDD作为开发代码的”推动者”。
对于以上的接口,当我们使用TDD进行测试用例先行时,发现了潜在的问题:
listUser 如果没有数据,那它是返回空集合还是null呢?
get(Integer id) 如果没有这个对象,是抛异常还是返回null呢?
深入listUser研究
我们先来讨论
listUser
这个接口,我经常看到如下实现:
publicList listUser{
List userList = userListRepostity.selectByExample( newUserExample);
if(CollectionUtils.isEmpty(userList)){ //spring util工具类
returnnull;
}
returnuserList;
}
这段代码返回是null,从我多年的开发经验来讲,对于集合这样返回值,最好不要返回null,因为如果返回了null,会给调用者带来很多麻烦。你将会把这种调用风险交给调用者来控制。
如果调用者是一个谨慎的人,他会进行是否为null的条件判断。如果他并非谨慎,或者他是一个面向接口编程的狂热分子(当然,面向接口编程是正确的方向),他会按照自己的理解去调用接口,而不进行是否为null的条件判断,如果这样的话,是非常危险的,它很有可能出现空指针异常!
根据墨菲定律来判断: “很有可能出现的问题,在将来一定会出现!”
基于此,我们将它进行优化:
publicList listUser{
List userList = userListRepostity.selectByExample( newUserExample);
if(CollectionUtils.isEmpty(userList)){
returnLists.newArrayList; //guava类库提供的方式
}
returnuserList;
}
对于接口(List listUser),它一定会返回List,即使没有数据,它仍然会返回List(集合中没有任何元素);
通过以上的修改,我们成功的避免了有可能发生的空指针异常,这样的写法更安全!
深入研究get方法
对于接口
User get(Integer id)
你能看到的现象是,我给出id,它一定会给我返回User.但事实真的很有可能不是这样的。
我看到过的实现:
publicUser get(Integer id){
returnuserRepository.selectByPrimaryKey(id); //从数据库中通过id直接获取实体对象
}
相信很多人也都会这样写。
通过代码的时候得知它的返回值很有可能是null! 但我们通过的接口是分辨不出来的!
这个是个非常危险的事情。尤其对于调用者来说!
我给出的建议是,需要在接口明明时补充文档,比如对于异常的说明,使用注解@exception:
publicinterface UserSearchService{
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体
* @exception UserNotFoundException
*/
User get(Integer id);
}
我们把接口定义加上了说明之后,调用者会看到,如果调用此接口,很有可能抛出“UserNotFoundException(找不到用户)”这样的异常。
这种方式可以在调用者调用接口的时候看到接口的定义,但是,这种方式是”弱提示”的!
如果调用者忽略了注释,有可能就对业务系统产生了风险,这个风险有可能导致一个亿!
除了以上这种”弱提示”的方式,还有一种方式是,返回值是有可能为空的。那要怎么办呢?
我认为我们需要增加一个接口,用来描述这种场景.
引入jdk8的Optional,或者使用guava的Optional.看如下定义:
publicinterface UserSearchService{
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体,此实体有可能是缺省值
*/
Optional getOptional(Integer id);
}
Optional有两个含义: 存在 or 缺省。
那么通过阅读接口getOptional,我们可以很快的了解返回值的意图,这个其实是我们想看到的,它去除了二义性。
它的实现可以写成:
publicOptional getOptional(Integer id){
returnOptional.ofNullable(userRepository.selectByPrimaryKey(id));
}
深入入参
通过上述的所有接口的描述,你能确定入参id一定是必传的吗?我觉得答案应该是:不能确定。除非接口的文档注释上加以说明。
那如何约束入参呢?
我给大家推荐两种方式:
强制约束
文档性约束(弱提示)
1.强制约束,我们可以通过jsr 303进行严格的约束声明:
publicinterface UserSearchService{
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体
* @exception UserNotFoundException
*/
User get(@NotNull Integer id);
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体,此实体有可能是缺省值
*/
Optional getOptional(@NotNull Integer id);
}
当然,这样写,要配合AOP的操作进行验证,但让spring已经提供了很好的集成方案,在此我就不在赘述了。
2.文档性约束
在很多时候,我们会遇到遗留代码,对于遗留代码,整体性改造的可能性很小。
我们更希望通过阅读接口的实现,来进行接口的说明。
jsr 305规范,给了我们一个描述接口入参的一个方式(需要引入库 com.google.code.findbugs:jsr305):
可以使用注解: @Nullable @Nonnull @CheckForNull 进行接口说明。
比如:
publicinterface UserSearchService{
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体
* @exception UserNotFoundException
*/
@ CheckForNull
User get(@NonNull Integer id);
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体,此实体有可能是缺省值
*/
Optional getOptional(@NonNull Integer id);
}
小结
通过 空集合返回值,Optional,jsr 303,jsr 305这几种方式,可以让我们的代码可读性更强,出错率更低!
空集合返回值 :如果有集合这样返回值时,除非真的有说服自己的理由,否则,一定要返回空集合,而不是null
Optional: 如果你的代码是jdk8,就引入它!如果不是,则使用Guava的Optional,或者升级jdk版本!它很大程度的能增加了接口的可读性!
jsr 303: 如果新的项目正在开发,不防加上这个试试!一定有一种特别爽的感觉!
jsr 305: 如果老的项目在你的手上,你可以尝试的加上这种文档型注解,有助于你后期的重构,或者新功能增加了,对于老接口的理解!
空对象模式
场景
我们来看一个DTO转化的场景,对象:
@Data
staticclassPersonDTO{
privateString dtoName;
privateString dtoAge;
}
@Data
staticclassPerson{
privateString name;
privateString age;
}
需求是将Person对象转化成PersonDTO,然后进行返回。
当然对于实际操作来讲,返回如果Person为空,将返回null,但是PersonDTO是不能返回null的(尤其Rest接口返回的这种DTO)。
在这里,我们只关注转化操作,看如下代码:
@ Test
publicvoidshouldConvertDTO{
PersonDTO personDTO = newPersonDTO;
Person person = newPerson;
if(!Objects.isNull(person)){
personDTO.setDtoAge(person.getAge);
personDTO.setDtoName(person.getName);
} else{
personDTO.setDtoAge( "");
personDTO.setDtoName( "");
}
}
优化修改
这样的数据转化,我们认识可读性非常差,每个字段的判断,如果是空就设置为空字符串(“”)
换一种思维方式进行思考,我们是拿到Person这个类的数据,然后进行赋值操作(setXXX),其实是不关系Person的具体实现是谁的。
那我们可以创建一个Person子类:
staticclassNullPerson extends Person{
@ Override
publicString getAge{
return"";
}
@ Override
publicString getName{
return"";
}
}
它作为Person的一种特例而存在,如果当Person为空的时候,则返回一些get*的默认行为.
所以代码可以修改为:
@ Test
publicvoidshouldConvertDTO{
PersonDTO personDTO = newPersonDTO;
Person person = getPerson;
personDTO.setDtoAge(person.getAge);
personDTO.setDtoName(person.getName);
}
privatePerson getPerson{
returnnewNullPerson; //如果Person是null ,则返回空对象
}
其中getPerson方法,可以用来根据业务逻辑获取Person有可能的对象(对当前例子来讲,如果Person不存在,返回Person的的特例NUllPerson),如果修改成这样,代码的可读性就会变的很强了。
使用Optional可以进行优化
空对象模式,它的弊端在于需要创建一个特例对象,但是如果特例的情况比较多,我们是不是需要创建多个特例对象呢,虽然我们也使用了面向对象的多态特性,但是,业务的复杂性如果真的让我们创建多个特例对象,我们还是要再三考虑一下这种模式,它可能会带来代码的复杂性。
对于上述代码,还可以使用Optional进行优化。
@ Test
publicvoidshouldConvertDTO{
PersonDTO personDTO = newPersonDTO;
Optional.ofNullable(getPerson).ifPresent(person -> {
personDTO.setDtoAge(person.getAge);
personDTO.setDtoName(person.getName);
});
}
privatePerson getPerson{
returnnull;
}
Optional对空值的使用,我觉得更为贴切,它只适用于”是否存在”的场景。
如果只对控制的存在判断,我建议使用Optional.
Optioanl的正确使用
Optional如此强大,它表达了计算机最原始的特性(0 or 1),那它如何正确的被使用呢!
Optional不要作为参数
如果你写了一个public方法,这个方法规定了一些输入参数,这些参数中有一些是可以传入null的,那这时候是否可以使用Optional呢?
我给的建议是: 一定不要这样使用!
举个例子:
publicinterface UserService{
List listUser(Optional username);
}
这个例子的方法 listUser,可能在告诉我们需要根据username查询所有数据集合,如果username是空,也要返回所有的用户集合.
当我们看到这个方法的时候,会觉得有一些歧义:
“如果username是absent,是返回空集合吗?还是返回全部的用户数据集合?”
Optioanl是一种分支的判断,那我们究竟是关注 Optional还是Optional.get呢?
我给大家的建议是,如果不想要这样的歧义,就不要使用它!
如果你真的想表达两个含义,就給它拆分出两个接口:
publicinterface UserService{
List listUser(String username);
List listUser;
}
我觉得这样的语义更强,并且更能满足 软件设计原则中的 “单一职责”。
如果你觉得你的入参真的有必要可能传null,那请使用jsr 303或者jsr 305进行说明和验证!
请记住! Optional不能作为入参的参数!
Optional作为返回值
当个实体的返回
那Optioanl可以做为返回值吗?
其实它是非常满足是否存在这个语义的。
你如说,你要根据id获取用户信息,这个用户有可能存在或者不存在。
你可以这样使用:
publicinterface UserService{
Optional get(Integer id);
}
当调用这个方法的时候,调用者很清楚get方法返回的数据,有可能不存在,这样可以做一些更合理的判断,更好的防止空指针的错误!
当然,如果业务方真的需要根据id必须查询出User的话,就不要这样使用了,请说明,你要抛出的异常.
只有当考虑它返回null是合理的情况下,才进行Optional的返回
集合实体的返回
不是所有的返回值都可以这样用的!如果你返回的是集合:
publicinterface UserService{
Optional> listUser;
}
这样的返回结果,会让调用者不知所措,是否我判断Optional之后,还用进行isEmpty的判断呢?
这样带来的返回值歧义!我认为是没有必要的。
我们要约定,对于List这种集合返回值,如果集合真的是null的,请返回空集合(Lists.newArrayList);
使用Optional变量
Optional userOpt = ...
如果有这样的变量userOpt,请记住 :
一定不能直接使用get ,如果这样用,就丧失了Optional本身的含义 ( 比如userOp.get )
不要直接使用getOrThrow ,如果你有这样的需求:获取不到就抛异常。那就要考虑,是否是调用的接口设计的是否合理
getter中的使用
对于一个java bean,所有的属性都有可能返回null,那是否需要改写所有的getter成为Optional类型呢?
我给大家的建议是,不要这样滥用Optional.
即便 我java bean中的getter是符合Optional的,但是因为java bean 太多了,这样会导致你的代码有50%以上进行Optinal的判断,这样便污染了代码。(我想说,其实你的实体中的字段应该都是由业务含义的,会认真的思考过它存在的价值的,不能因为Optional的存在而滥用)
我们应该更关注于业务,而不只是空值的判断。
请不要在getter中滥用Optional.
小结
可以这样总结Optional的使用:
当使用值为空的情况,并非源于错误时,可以使用Optional!
Optional不要用于集合操作!
不要滥用Optional,比如在java bean的getter中!
(点击标题可跳转阅读)返回搜狐,查看更多
责任编辑:
Java解决空引用_Java 匠人手法 - 优雅的处理空值相关推荐
- 一个空值_java匠人手法优雅的处理空值
点击上方☝SpringForAll社区 轻松关注!及时获取有趣有料的技术文章 来源: http://lrwinx.github.io/2018/08/30/java匠人手法-优雅的处理空值/ 导语 在 ...
- Java解决空引用_在java中检查空引用的乐观方法
本问题已经有最佳答案,请猛点这里访问. 任何Java精通/专家都能告诉我,在使用null来避免EDCOX1×0时,检查空引用或对象的乐观方式是什么? 在我的代码中,我有100多个字段,其中大部分是为了 ...
- java解决循环引用_Java 中如何避免循环引用,解决相互依赖的问题
spring中通过依赖注入的方法来解决类的相互依赖问题!!! spring中通过依赖注入的方法来解决类的相互依赖问题!!! spring中通过依赖注入的方法来解决类的相互依赖问题!!! 只要不是构造函 ...
- java 静态内部类 弱引用_Java基础 强引用、弱引用、软引用、虚引用
前言 在ThreadLocal源码中,其中嵌套类ThreadLocalMap中的Entry继承了WeakReferenc.Java中提供这四种引用类型主要有两个目的:第一是可以让程序员通过代码的方式决 ...
- java 解决内存泄露_Java内存泄露的理解与解决
Java内存管理机制 在C++语言中,如果需要动态分配一块内存,程序员需要负责这块内存的整个生命周期.从申请分配.到使用.再到最后的释放.这样的过程非常灵活,但是却十分繁琐,程序员很容易由于疏忽而忘记 ...
- java 无法取消引用_Java的新手,并出现错误“无法取消引用int” - java
我是java的新手,并且已经从事了一段时间,但是仍然收到错误消息:无法取消引用int.我看到了几个类似的问题,但仍然无法弄清自己的情况. 这是完整的代码: package inclass; class ...
- java reference 传引用_Java的引用(reference)---Roni
摘自<Java面向对象编程>一书,作者:孙卫琴 来源:www.javathinker.org 在JDK1.2以前的版本中,当一个对象不被任何变量引用,那么程序就无法再使用这个对象.也就是说 ...
- JAVA解决生产消费者_Java常用三种方式解决生产者消费者问题(详细)
package test; /** * Synchronized 版本解决生产者消费者 * wait() / notify()方法 */ import java.util.LinkedList; im ...
- java 不取空值_Java:如何更优雅的处理空值?
在笔者几年的开发经验中,经常看到项目中存在到处空值判断的情况,这些判断,会让人觉得摸不着头绪,它的出现很有可能和当前的业务逻辑并没有关系.但它会让你很头疼. 有时候,更可怕的是系统因为这些空值的情况, ...
最新文章
- nginx上传文件大小
- Redis 实战笔记
- 变量的命名规则与惯例
- 萌新分享打印当前目录下的所有文件和打印出里面java文件的代码
- 数学一年级应用题_一年级训练思维的数学应用题五十道,含答案解析
- 双目相机计算稠密深度点云详解教程
- Delmia做一些二次开发,实现虚拟场景漫游
- MySql获取某天是一年的第几周
- 基于8086方波锯齿波三角波发生器仿真、基于8086的LCD1602显示仿真设计、基于8086的LED点阵汉字流水显示设计、基于8086的LED中文显示屏显示设计-仿真设计资料【转发】
- K60 FTM定时器 定时中断
- IBM服务器raid5崩溃数据恢复方法
- 从荣耀V20看技术人怎么销售自己
- es拼音分词 大帅哥_8 种架构设计模式优缺点大曝光 | 原力计划
- ExoPlayer修改播放器UI
- Nature综述:微生物构成的氮循环网络(必读)
- Camera成像原理(raw图如何产生的)
- 少年歌行游戏一直显示连接服务器,少年歌行第二季无法上线的原因找到了,不是没做好,而是限制太多...
- 首席财务官如何看待云计算和人工智能的财务报告
- 论文“Matrix Formulation for Minimum Response of Undamped Structures”参考代码
- ai作文批改_网易有道词典上线AI作文批改功能 可自动批改雅思、四六级英语作文...
热门文章
- iscroll的使用
- mysql时间模糊查询_mysql中那些根据时间查询的sql语句
- 开启灯光就是近光吗_有用!科目三灯光模拟操作大全
- grep从文件末尾开始找_新人自学前端到什么程度才能找工作?
- qt中QList使用removeAt()删除元素
- 快速搭建Python+Selenium+Sublime 自动化测试环境方法
- BugkuCTF-WEB题前女友
- linux上修改html,linux进程名修改
- 征途2无法显示服务器列表,解决win10系统玩征途2提示“DriverCommlnit驱动加载失败”的方法...
- ios时间相差多少天_iOS 计算某个时间到现在是多少月/天/时