Java:如何更優雅地處理空值?

2020-12-15 酷扯兒

本文轉載自【微信公眾號:java進階架構師,ID:java_jiagoushi】經微信公眾號授權轉載,如需轉載與原文作者聯繫

導語

在筆者幾年的開發經驗中,經常看到項目中存在到處空值判斷的情況,這些判斷,會讓人覺得摸不著頭緒,它的出現很有可能和當前的業務邏輯並沒有關係。但它會讓你很頭疼。

有時候,更可怕的是系統因為這些空值的情況,會拋出空指針異常,導致業務系統發生問題。

此篇文章,我總結了幾種關於空值的處理手法,希望對讀者有幫助。

業務中的空值

場景

存在一個UserSearchService用來提供用戶查詢的功能:

public interface UserSearchService{List<User> listUser(); User get(Integer id);}

問題現場

對於面向對象語言來講,抽象層級特別的重要。尤其是對接口的抽象,它在設計和開發中佔很大的比重,我們在開發時希望儘量面向接口編程。

對於以上描述的接口方法來看,大概可以推斷出可能它包含了以下兩個含義:

listUser(): 查詢用戶列表get(Integer id): 查詢單個用戶在所有的開發中,XP推崇的TDD模式可以很好的引導我們對接口的定義,所以我們將TDD作為開發代碼的」推動者」。

對於以上的接口,當我們使用TDD進行測試用例先行時,發現了潛在的問題:

listUser() 如果沒有數據,那它是返回空集合還是null呢?get(Integer id) 如果沒有這個對象,是拋異常還是返回null呢?深入listUser研究

我們先來討論

listUser()

這個接口,我經常看到如下實現:

public List<User> listUser(){List<User> userList = userListRepostity.selectByExample(new UserExample()); if(CollectionUtils.isEmpty(userList)){//spring util工具類 return null; } return userList;}

這段代碼返回是null,從我多年的開發經驗來講,對於集合這樣返回值,最好不要返回null,因為如果返回了null,會給調用者帶來很多麻煩。你將會把這種調用風險交給調用者來控制。

如果調用者是一個謹慎的人,他會進行是否為null的條件判斷。如果他並非謹慎,或者他是一個面向接口編程的狂熱分子(當然,面向接口編程是正確的方向),他會按照自己的理解去調用接口,而不進行是否為null的條件判斷,如果這樣的話,是非常危險的,它很有可能出現空指針異常!

根據墨菲定律來判斷: 「很有可能出現的問題,在將來一定會出現!」

基於此,我們將它進行優化:

public List<User> listUser(){List<User> userList = userListRepostity.selectByExample(new UserExample()); if(CollectionUtils.isEmpty(userList)){ return Lists.newArrayList();//guava類庫提供的方式 } return userList;}

對於接口

(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<User> getOptional(Integer id);}

Optional有兩個含義: 存在 or 預設。

那麼通過閱讀接口getOptional(),我們可以很快的了解返回值的意圖,這個其實是我們想看到的,它去除了二義性。

它的實現可以寫成:

public Optional<User> 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<User> 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<User> getOptional(@NonNull Integer id);}

小結

通過 空集合返回值,Optional,jsr 303,jsr 305這幾種方式,可以讓我們的代碼可讀性更強,出錯率更低!

空集合返回值 :如果有集合這樣返回值時,除非真的有說服自己的理由,否則,一定要返回空集合,而不是nullOptional: 如果你的代碼是jdk8,就引入它!如果不是,則使用Guava的Optional,或者升級jdk版本!它很大程度的能增加了接口的可讀性!jsr 303: 如果新的項目正在開發,不防加上這個試試!一定有一種特別爽的感覺!jsr 305: 如果老的項目在你的手上,你可以嘗試的加上這種文檔型註解,有助於你後期的重構,或者新功能增加了,對於老接口的理解!空對象模式

場景

我們來看一個DTO轉化的場景,對象:

@Datastatic class PersonDTO{private String dtoName; private String dtoAge;}@Datastatic class Person{ private String name; private String age;}

需求是將Person對象轉化成PersonDTO,然後進行返回。

當然對於實際操作來講,返回如果Person為空,將返回null,但是PersonDTO是不能返回null的(尤其Rest接口返回的這種DTO)。

在這裡,我們只關注轉化操作,看如下代碼:

@Testpublic 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的具體實現是誰的。

那我們可以創建一個Person子類:

static class NullPerson extends Person{@Override public String getAge() { return ""; } @Override public String getName() { return ""; }}

它作為Person的一種特例而存在,如果當Person為空的時候,則返回一些get*的默認行為.

所以代碼可以修改為:

@Testpublic 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進行優化。

@Testpublic 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<User> listUser(Optional<String> username);}

這個例子的方法 listUser,可能在告訴我們需要根據username查詢所有數據集合,如果username是空,也要返回所有的用戶集合.

當我們看到這個方法的時候,會覺得有一些歧義:

「如果username是absent,是返回空集合嗎?還是返回全部的用戶數據集合?」

Optioanl是一種分支的判斷,那我們究竟是關注 Optional還是Optional.get()呢?

我給大家的建議是,如果不想要這樣的歧義,就不要使用它!

如果你真的想表達兩個含義,就給它拆分出兩個接口:

public interface UserService{List<User> listUser(String username); List<User> listUser();}

我覺得這樣的語義更強,並且更能滿足 軟體設計原則中的 「單一職責」。

如果你覺得你的入參真的有必要可能傳null,那請使用jsr 303或者jsr 305進行說明和驗證!

請記住! Optional不能作為入參的參數!

Optional作為返回值

當個實體的返回

那Optioanl可以做為返回值嗎?

其實它是非常滿足是否存在這個語義的。

你如說,你要根據id獲取用戶信息,這個用戶有可能存在或者不存在。

你可以這樣使用:

public interface UserService{Optional<User> get(Integer id);}

當調用這個方法的時候,調用者很清楚get方法返回的數據,有可能不存在,這樣可以做一些更合理的判斷,更好的防止空指針的錯誤!

當然,如果業務方真的需要根據id必須查詢出User的話,就不要這樣使用了,請說明,你要拋出的異常.

只有當考慮它返回null是合理的情況下,才進行Optional的返回

集合實體的返回

不是所有的返回值都可以這樣用的!如果你返回的是集合:

public interface UserService{Optional<List<User>> listUser();}

這樣的返回結果,會讓調用者不知所措,是否我判斷Optional之後,還用進行isEmpty的判斷呢?

這樣帶來的返回值歧義!我認為是沒有必要的。

我們要約定,對於List這種集合返回值,如果集合真的是null的,請返回空集合(Lists.newArrayList);

使用Optional變量

Optional<User> 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進階架構師,ID:java_jiagoushi】經微信公眾號授權轉載,如需轉載與原文作者聯繫導語異常處理是程序開發中必不可少操作之一,但如何正確優雅的對異常進行處理確是一門學問
  • 實戰系列:使用Java8 Optional類優雅解決空指針問題
    Java8吸收其他語言的精髓帶來了函數式編程,lambda表達式,Stream流等一系列新特性,學會了這些新特性,可以讓你實現高效編碼優雅編碼。1. 不受待見的空指針異常有個小故事:null引用最早是由英國科學家Tony Hoare提出的,多年後Hoare為自己的這個想法感到後悔莫及,並認為這是"價值百萬的重大失誤"。
  • java如何快速入門?
    java如何快速入門正確掌握Java的基本知識由於Java為開發人員提供了如此多的特性和選項,人們有時會被分散注意力在太短的時間內學習了太多的東西java如何快速入門真正弄懂你敲出的代碼是做什麼的只要你理解了代碼背後的思想,算法和整個編譯過程就會顯得非常有意義。
  • Java中有關Null的9件事
    Java為什麼要保留null呢?null出現有一段時間了,並且我認為Java發明者知道null與它解決的問題相比帶來了更多的麻煩,但是null仍然陪伴著Java。我越發感到驚奇,因為java的設計原理是為了簡化事情,那就是為什麼沒有浪費時間在指針、操作符重載、多繼承實現的原因,null卻與此正好相反。
  • GitHub 標星 1.3k+,一款超讚的用於字符串處理的 Java 8 庫
    使用那些已經被驗證過,足夠優質的開源庫不僅能夠讓我們的代碼變得優雅,還能夠讓我們在不斷的使用過程當中,學習到編程的精髓。洋務運動的時候,有一句很響亮的口號叫做,「師夷長技以制夷」。先去用,再去學,自然而然就會變得牛逼。同學們,你們說,是不是這個理?我今天推薦的這款開源庫,名字叫做 strman-java,GitHub 上標星 1.3k,一款超讚的字符串處理工具庫,基於 Java 8,語法非常簡潔。
  • Java基礎面試題簡單總結
    一.歷史原因:Hashtable是基於陳舊的Dictionary類的,HashMap是Java 1.2引進的Map接口的一個實現二.同步性:Hashtable是線程安全的,也就是說是同步的,而HashMap是線程序不安全的,不是同步的三.值:只有HashMap可以讓你將空值作為一個表的條目的key或value
  • 你好, Java !
    它可能會誤導你,因為它對空值很寬鬆,並且會禁用 Kotlin 的 NULL 安全機制。public class Utils {    static String format(String text) {        return text.isEmpty() ?
  • 如何在Windows10系統中配置java的JDK環境
    今天給大家分享一下如何在Windows10系統中配置java的JDK環境。在「變量名」後面輸入:JAVA_HOME ,在「變量值」後面輸入:D:\jdk10注意,此時輸入的「變量值」就是安裝JDK的路徑。截圖如下:14.點擊」確定「按鈕後,用戶變量下面會顯示剛剛新增的「JVAV_HOME」欄位。
  • 如何優雅地使用Matlab玩轉Excel?
    本文將介紹如何優雅地使用Matlab玩轉Excel,並露出迷之微笑。Excel是一款風靡全球的電子遊戲,擁有許多不同段位的玩家。
  • Java中有這玩意?
    本文轉載自【微信公眾號:java進階架構師,ID:java_jiagoushi】經微信公眾號授權轉載,如需轉載與原文作者聯繫一:簡潔二:方法引用三:Optional 可選值package java.util;import java.util.function.Consumer;import java.util.function.Function;import java.util.function.Predicate
  • 阿里P8教你Java註解與反射
    格式為 public @interface 註解名 {定義內容}其中每一個方法實際是聲明了一個參數方法的名稱就是參數的名稱返回值類型就是參數的類型,而且返回值類型只能是基本類型,Class可以通過default關鍵字來聲明參數的默認值,一般會使用空字符串或者0如果只有一個參數,一般參數名為value,而且使用註解時,賦值可以不顯示寫出參數名,直接寫參數值定義了參數,如果沒有默認值,就一定要顯示賦值
  • python和java哪個好
    python和java哪個好?書聲琅琅Python培訓老師介紹,這兩年來IT教育發展迅速,程式語言隨著發展也日益月異,比較火的Python語言發展迅速,與傳統使用的JAVA語言來說,火爆程度差不多,就有同學問了,python和java這兩個語言到底哪個好呢?
  • 純Java中的函數式編程:Functor和Monad示例
    讓我介紹幾個Functors,以使您更流暢地使用此API:interface Functor<T,F extends Functor<?,?一個FOptional<T>仿函數可以持有價值,但同樣也可能是空的。這是一種類型安全的編碼方式null。有兩種構造方法FOptional-通過提供值或創建 empty()實例。在這兩種情況下,就像with一樣Identity,FOptional都是不可變的,我們只能與內部的值進行交互。不同之處FOptional在於,如果轉換函數f為空,則可能不會將其應用於任何值。
  • 黑馬程式設計師java培訓機構如何?好口碑java培訓機構如何選?
    大大小小的Java培訓機構多如牛毛,幾個人經過簡單的包裝就會成為精英人士混淆視聽,因此想要知道黑馬程式設計師java培訓機構如何?好口碑java培訓機構如何選?我們就要考全面慮。想要知道一家java培訓機構好不好,品牌和實力是最為重要的,實力如何就要看師資力量了,擁有豐富實戰經驗的導師會結合學員過往的工作經歷、學習表現、階段性成績、項目成績等,為學員提供最佳的專業輔導。課程安排方面會凸顯這家java培訓機構的專業,畢竟專注的總歸是專業的,java培訓起來理論必須加實踐,因為最終的目的是打造符合企業需求的java人才。
  • java集合詳解合集
    所以的集合類都位於java.util包下,後來為了處理多線程環境下的並發安全問題,java5還在java.util.concurrent包下提供了一些多線程支持的集合類。在學習Java中的集合類的API、編程原理的時候,我們一定要明白,"集合"是一個很古老的數學概念,它遠遠早於Java的出現。
  • 課程設計指導——如何應用Java反射技術靈活地創建程序類對象實例
    軟體項目實訓及課程設計指導——如何應用Java反射技術靈活地創建程序類的對象實例1、如何應用屬性配置文件實現對系統中的配置信息進行讀寫操作Java中的屬性配置文件主要可以作為軟體應用系統及項目的配置文件,比如許多J2EE的開源框架系統中都提供了屬性配置文件作為該應用框架的對外配置文件
  • Lambda 表達式,簡潔優雅就是生產力!
    本文轉載自【微信公眾號:java進階架構師,ID:java_jiagoushi】經微信公眾號授權轉載,如需轉載與原文作者聯繫1什麼是Lambda?我們知道,對於一個Java變量,我們可以賦給其一個「值」。
  • 一起學JAVA——數組和函數
    方法(函數)是java的最小代碼重用單位,方法(函數)是為了重用代碼。方法不能嵌套方法,不能在一個方法內部定義另外一個方法。可以在一個方法內部調用另外一個方法。如果函數運行之後需要返回給調用者數據,那麼需要指定返回值類型,並且用關鍵字return返回。定義函數的3個必要條件:函數名、參數列表、返回值類型。如果不需要參數也要寫小括號,如果沒有返回值類型要寫void。
  • JAVA map的用法/如何遍歷MAP
    第一步,,要引入它所在JAR—— 可以在JAVA類裡直接引入import java.util.*;  這樣until下的所有接口都可以調用,還有常用到的是List.map.put("a",     "1");            map.put("b",     "2");            map.put("c",     "3");   第三步:上面我們已經在MAP中添加了三條數據進去,我們可以用下面這句取值 :         String str = map.get("a").toString();       // 這樣獲取到str的值就是
  • JAVA 基礎:JAVA開發環境搭建
    新建,變量名JAVA_HOME,變量值為jdk路徑,配置CLASSPATH。新建,變量名CLASSPATH,變量值:%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar配置Path。