对于接口(List listUser())
,它一定会返回List,即使没有数据,它仍然会返回List(集合中没有任何元素);
通过以上的修改,我们成功的避免了有可能发生的空指针异常,这样的写法更安全!
深入研究get方法
对于接口
User get(Integer id)
你能看到的现象是,我给出id,它一定会给我返回User.但事实真的很有可能不是这样的。
我看到过的实现:
public User get(Integer id){
return userRepository.selectByPrimaryKey(id);//从数据库中通过id直接获取实体对象
}
相信很多人也都会这样写。
通过代码的时候得知它的返回值很有可能是null! 但我们通过的接口是分辨不出来的!
这个是个非常危险的事情。尤其对于调用者来说!
我给出的建议是,需要在接口明明时补充文档,比如对于异常的说明,使用注解@exception:
public interface UserSearchService{
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体
* @exception UserNotFoundException
*/
User get(Integer id);
}
我们把接口定义加上了说明之后,调用者会看到,如果调用此接口,很有可能抛出“UserNotFoundException(找不到用户)”这样的异常。
这种方式可以在调用者调用接口的时候看到接口的定义,但是,这种方式是”弱提示”的!
如果调用者忽略了注释,有可能就对业务系统产生了风险,这个风险有可能导致一个亿!
除了以上这种”弱提示”的方式,还有一种方式是,返回值是有可能为空的。那要怎么办呢?
我认为我们需要增加一个接口,用来描述这种场景.
引入jdk8的Optional,或者使用guava的Optional.看如下定义:
public interface UserSearchService{
/**
* 根据用户id获取用户信息
* @param id 用户id
* @return 用户实体,此实体有可能是缺省值
*/
Optional getOptional(Integer id);
}
Optional有两个含义: 存在 or 缺省。
那么通过阅读接口getOptional(),我们可以很快的了解返回值的意图,这个其实是我们想看到的,它去除了二义性。
它的实现可以写成:
public Optional getOptional(Integer id){
return Optional.ofNullable(userRepository.selectByPrimaryKey(id));
}
深入入参
通过上述的所有接口的描述,你能确定入参id一定是必传的吗?我觉得答案应该是:不能确定。除非接口的文档注释上加以说明。
那如何约束入参呢?
我给大家推荐两种方式:
-
强制约束
-
文档性约束(弱提示)
1.强制约束,我们可以通过jsr 303进行严格的约束声明:
public interface 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 进行接口说明。比如:
public interface 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
static class PersonDTO{
private String dtoName;
private String dtoAge;
}
@Data
static class Person{
private String name;
private String age;
}
需求是将Person对象转化成PersonDTO,然后进行返回。
当然对于实际操作来讲,返回如果Person为空,将返回null,但是PersonDTO是不能返回null的(尤其Rest接口返回的这种DTO)。
在这里,我们只关注转化操作,看如下代码:
@Test
public void shouldConvertDTO(){
PersonDTO personDTO = new PersonDTO();
Person person = new Person();
if(!Objects.isNull(person)){
personDTO.setDtoAge(person.getAge());
personDTO.setDtoName(person.getName());
}else{
personDTO.setDtoAge(“”);
personDTO.setDtoName(“”);
}
}
优化修改
这样的数据转化,我们认识可读性非常差,每个字段的判断,如果是空就设置为空字符串(“”)
换一种思维方式进行思考,我们是拿到Person这个类的数据,然后进行赋值操作(setXXX),其实是不关系Person的具体实现是谁的。
推荐:Java面试题阶段汇总
那我们可以创建一个Person子类:
static class NullPerson extends Person{
@Override
public String getAge() {
return “”;
}
@Override
public String getName() {
return “”;
}
}
它作为Person的一种特例而存在,如果当Person为空的时候,则返回一些get*的默认行为.
所以代码可以修改为:
@Test
public void shouldConvertDTO(){
PersonDTO personDTO = new PersonDTO();
Person person = getPerson();
personDTO.setDtoAge(person.getAge());
personDTO.setDtoName(person.getName());
}
private Person getPerson(){
return new NullPerson();//如果Person是null ,则返回空对象
}
其中getPerson()方法,可以用来根据业务逻辑获取Person有可能的对象(对当前例子来讲,如果Person不存在,返回Person的的特例NUllPerson),如果修改成这样,代码的可读性就会变的很强了。
使用Optional可以进行优化
空对象模式,它的弊端在于需要创建一个特例对象,但是如果特例的情况比较多,我们是不是需要创建多个特例对象呢,虽然我们也使用了面向对象的多态特性,但是,业务的复杂性如果真的让我们创建多个特例对象,我们还是要再三考虑一下这种模式,它可能会带来代码的复杂性。
对于上述代码,还可以使用Optional进行优化。
@Test
public void shouldConvertDTO(){
PersonDTO personDTO = new PersonDTO();
Optional.ofNullable(getPerson()).ifPresent(person -> {
personDTO.setDtoAge(person.getAge());
personDTO.setDtoName(person.getName());
});
}
private Person getPerson(){
return null;
}
Optional对空值的使用,我觉得更为贴切,它只适用于”是否存在”的场景。
如果只对控制的存在判断,我建议使用Optional.
Optioanl的正确使用
Optional如此强大,它表达了计算机最原始的特性(0 or 1),那它如何正确的被使用呢!
Optional不要作为参数
如果你写了一个public方法,这个方法规定了一些输入参数,这些参数中有一些是可以传入null的,那这时候是否可以使用Optional呢?
我给的建议是: 一定不要这样使用!
举个例子:
public interface UserService{
List listUser(Optional username);
}
这个例子的方法 listUser,可能在告诉我们需要根据username查询所有数据集合,如果username是空,也要返回所有的用户集合.
当我们看到这个方法的时候,会觉得有一些歧义:
“如果username是absent,是返回空集合吗?还是返回全部的用户数据集合?”
Optioanl是一种分支的判断,那我们究竟是关注 Optional还是Optional.get()呢?
我给大家的建议是,如果不想要这样的歧义,就不要使用它!
Docker步步实践
目录文档:
①Docker简介
②基本概念
③安装Docker
④使用镜像:
⑤操作容器:
⑥访问仓库:
⑦数据管理:
⑧使用网络:
⑨高级网络配置:
⑩安全:
⑪底层实现:
⑫其他项目:
(img-JGFWvGOE-1714401989715)]
[外链图片转存中…(img-H7JawxO8-1714401989716)]
①Docker简介
②基本概念
③安装Docker
[外链图片转存中…(img-PLfVgRTE-1714401989716)]
④使用镜像:
[外链图片转存中…(img-NxSPL7bT-1714401989716)]
⑤操作容器:
[外链图片转存中…(img-jB42axfC-1714401989717)]
⑥访问仓库:
[外链图片转存中…(img-EoR8wzRa-1714401989717)]
⑦数据管理:
[外链图片转存中…(img-Wvb8Rtp4-1714401989717)]
⑧使用网络:
[外链图片转存中…(img-mGNbnBXk-1714401989717)]
⑨高级网络配置:
[外链图片转存中…(img-Kq5IWwni-1714401989718)]
⑩安全:
[外链图片转存中…(img-M330InsM-1714401989718)]
⑪底层实现:
[外链图片转存中…(img-T75QMaJD-1714401989718)]
⑫其他项目:
[外链图片转存中…(img-1GHD0Xlt-1714401989719)]