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中!

(点击标题可跳转阅读)返回搜狐,查看更多

责任编辑:

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/534602.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

mysql 尝试读取超过流末尾的_MySql异常:尝试读取超出流末尾的内容

问题详细描述:2020-09-04 11:28:19,576 [DefaultQuartzScheduler_Worker-1] DEBUG MySql.Data.MySqlClient.MySqlException (0x80004005): Fatal error encountered during command execution. ---> MySql.Data.MySqlClient.MySqlException (0x80004005): Fatal …

mysql对称连接什么意思_对称加密与非对称加密的区别是什么

区别:1、对称加密中加密和解密使用的秘钥是同一个;非对称加密中采用两个密钥,一般使用公钥进行加密,私钥进行解密。2、对称加密解密的速度比较快,非对称加密和解密花费的时间长、速度相对较慢。3、对称加密的安全性相对…

php引号变量_下列PHP数据库insert语句中变量前后的点和双引号有什么作用?

这就要从双引号和单引号的作用讲起:双引号里面的字段会经过编译器解释然后再当作HTML代码输出,但是单引号里面的不需要解释,直接输出。例如:$abcI love u;echo $abc //结果是:I love uecho $abc //结果是:$abcecho "$abc&quo…

php excel 设置常规_php实现的操作excel类详解

本文实例讲述了php实现的操作excel类。分享给大家供大家参考,具体如下:class Excel{static $instancenull;private $excelnull;private $workbooknull;private $workbookaddnull;private $worksheetnull;private $worksheetaddnull;private $sheetnum1;p…

php析构函数使用,php析构函数__destruct()使用方法及实例讲解

通过上一篇文章《php 构造函数__construct()使用分析》的讲解,我们已经知道了什么叫构造方法。那么与构造方法对应的就是析构方法。析构方法允许在销毁一个类之前执行的一些操作或完成一些功能,比如说关闭文件、释放结果集等。析构方法是PHP5才引进的新内…

ubuntu创建php文件,ubuntu系统创建桌面快捷方式的方法

在ubuntu系统中,自己安装的程序往往没有创建桌面快捷方式,每次都通过终端然后输入绝对路去径执行命令比较繁琐,其实可以像windows那样自己在桌面程序创建程序的快捷方式,这样方便了每次的启动。这里以Navicat为例说明一下在linux(…

php设计模式及案例分析,一个案例来认识PHP经典设计模式 | 张先生博客

/*** 单例模式*/class Site{//属性public $siteName;//本类的静态实例public static $instance null;//禁用掉构造器private function __construct($siteName){$this->siteName $siteName;}//获取本类唯一实例public static function getInstance($siteNme 默认siteName值…

php如何加密图片,php实现图片加密解密,支持设置密码 (两年后版本!)

* by hello* 84587470** php 文件加密类,支持设置密码,图片,文件都可以!情侣们的福音!!!**/$from C:\Users\Administrator\Desktop\t\test.png;$to C:\Users\Administrator\Desktop\t\\;//加密…

php面向对象编程代码怎么写,php面向对象编程(一)

类与对象关系:类就像一个人类的群体 我们从类中实例化一个对象 就像是制定一个人。面向对象程序的单位就是对象,但对象又是通过类的实例化出来的,所以我们首先要做的就是如何来声明类, 做出来一个类很容易。类的格式class 类名 { …

雅马哈php mt7,雅马哈专业录音室监听耳机 HPH-MT7 正式发售!

从 NS-10M 监听音箱到 MSP 系列和 HS 系列,雅马哈始终秉持忠实的设计理念,聚焦声学精度,为音频专家提供出色的平台,构建并成就他们专属的专业之声。MT7录音室监听耳机承袭了这一基本研发理念,重现最为精细的声音,力求满…

php 支付签名验证失败,choosewxpay fail解决,微信支付签名验证错误解决

require_once("config.php"); //这个文件原来写过的博客有http://jipq1016.com/display.php?id9//统一下单$openid$_POST[openid];$arr[appid]$appid; //商户appid$arr[mch_id]$mch_id; //微信支付…

趣学java,编程趣学习app

编程趣学习在这里会有多种编程语言是可以去学习的Java或者是c,入门级的海鸥就是更加有难度的都是可以选择一个自己可以去学习的课程,跟着讲师一同开始及逆行语言基础知识的学习后面大家就是根据自己的的课后作业完成,去自己调试新的程序。编程…

cgi php脚本运行超时间,php超时 - php-cgi调用外部程序超时,但php在命令行模式下能完整运行外部程序...

运行环境为Ubuntu14.04php脚本无论用Apache还是nginx都会在R语言运行一半时终止运行(在需要等待运行3~5秒时的步骤停止)但用php在命令行模式php -f result.php却能完整运行。请问是否能通过修改php配置,解决这个问题回复内容:运行环境为Ubuntu14.04php脚…

oracle无法分区,oracle已存在的表添加新分区的方法

现在有一张表如下:create table WRITE_USER(area_code VARCHAR2(8),user_no VARCHAR2(20),user_name VARCHAR2(100),address VARCHAR2(100),mon NUMBER(6),mon_sn NUM…

oracle常用表查询,ORACLE EBS常用表及查询语句(最终整理版)

select * from ar_batches_all 事务处理批select * from ra_customer_trx_all 发票头select * from ra_customer_trx_lines_all 发票行select * from ra_cust_trx_line_gl_dist_all 发票分配select * from ar_cash_receipts_all 收…

aix升级新安装oracle,安装Oracle 11gR2 AIX 5.3 升级到TL11的一些小记录

Dep-app 需要locdevices.usbif.08025002.rtersct.compat.basic.sp打5300-11-00-0943时需要devices.usbif.08025002.rte 5.3.11.0 重启可以 或 删除 devices.usbif.08025002.rte 5.3.7.7打5300-11-04-1015时需要bos.sysmgt.sysbr 5.3.11.0 5.3.11.3bos.sysmgt.sysbr 需要bos…

oracle连续状态相同,数据库共有三种状态:quiesce、resrict、suspend

数据库共有三种状态:quiesce、resrict、suspend一、quiesce模式首先来说说数据库的静默状态静默状态是指数据库中只存在sys和system用户建立的活动会话。只有dba能继续操作数据库。此状态下可以进行一些在非静默状态下执行可能存在不安全因素的特殊操作。对于必须持…

oracle数据库连接名是什么,连接到Oracle数据库的几种命名方式

连接到Oracle数据库的几种命名方式从事 Oracle 相关工作的人,每天都会使用各种工具连接到 Oracle 数据库,比如:SQL*Plus、PL/SQL、TOAD、SQLDeveloper 等等,下面就列举了几种连接到 Oracle 的方式,本例中使用的是 SQL*…

jmeter无法释放oracle连接,jmeter 连接ORACLE数据库错误及解决方法

问题一:Response message: java.sql.SQLException:Cannot load JDBC driver class ‘oracle.jdbc.driver.OracleDriver‘未引入ojdbc14.jar包所致,2种解决方案,最好重启一下:1.在测试计划页面中,点击浏览,选…

oracle11g ora 12518,servlet执行update报错ORA-12518

ORA-12518: TNS:listener could not hand off client connection这种错误一般是在测试数据库并发性的,多个用户的,后台用servleORA-12518: TNS:listener could not hand off client connection这种错误一般是在测试数据库并发性的,多个用户的…