編碼規範 | Java函式優雅之道(下)
上文背景
本文總結了一套與Java函式相關的編碼規則,旨在給廣大Java程式設計師一些編碼建議,有助於大家編寫出更優雅、更高質、更高效的程式碼。
內部函式引數儘量使用基礎型別
案例一:內部函式引數儘量使用基礎型別
現象描述:
// 呼叫程式碼double price = 5.1D; int number = 9; double total = calculate(price, number);// 計算金額函式private double calculate(Double price, Integer number) { return price * number; }
建議方案:
// 呼叫程式碼double price = 5.1D; int number = 9; double total = calculate(price, number);// 計算金額函式private double calculate(double price, int number) { return price * number; }
案例二:內部函式返回值儘量使用基礎型別
現象描述:
// 獲取訂單總額函式public double getOrderAmount(List<Product> productList) { double amount = 0.0D; for (Product product : productList) { if (Objects.isNull(product) || Objects.isNull(product.getPrice()) || Objects.isNull(product.getNumber())) { continue; } amount += calculate(product.getPrice(), product.getNumber()); } return amount; }// 計算金額函式private Double calculate(double price, double number) { return price * number; }
建議方案:
// 獲取訂單總額函式public double getOrderAmount(List<Product> productList) { double amount = 0.0D; for (Product product : productList) { if (Objects.isNull(product) || Objects.isNull(product.getPrice()) || Objects.isNull(product.getNumber())) { continue; } amount += calculate(product.getPrice(), product.getNumber()); } return amount; }// 計算金額函式private double calculate(double price, double number) { return price * number; }
此處只是舉例說明這種現象,更好的方式是採用流式(Stream)程式設計。
主要收益
- 內部函式儘量使用基礎型別,避免了隱式封裝型別的打包和拆包;
- 內部函式引數使用基礎型別,用語法上避免了內部函式的引數空指標判斷;
- 內部函式返回值使用基礎型別,用語法上避免了呼叫函式的返回值空指標判斷。
儘量避免返回的陣列和列表為null
案例一:儘量避免返回的陣列為null,引起不必要的空指標判斷
現象描述:
// 呼叫程式碼UserVO[] users = queryUser();if (Objects.nonNull(users)) { for (UserVO user : users) { // 處理使用者資訊 } }// 查詢使用者函式private UserVO[] queryUser() { // 查詢使用者列表 List<UserDO> userList = userDAO.queryAll(); if (CollectionUtils.isEmpty(userList)) { return null; } // 轉化使用者陣列 UserVO[] users = new UserVO[userList.size()]; for (int i = 0; i < userList.size(); i++) { UserDO user = userList.get(i); users[i] = new UserVO(); users[i].setId(user.getId()); users[i].setName(user.getName()); } // 返回使用者陣列 return users; }
建議方案:
// 呼叫程式碼UserVO[] users = queryUser();for (UserVO user : users) { // 處理使用者資訊}// 查詢使用者函式private UserVO[] queryUser() { // 查詢使用者列表 List<UserDO> userList = userDAO.queryAll(); if (CollectionUtils.isEmpty(userList)) { return new UserVO[0]; } // 轉化使用者陣列 UserVO[] users = new UserVO[userList.size()]; for (int i = 0; i < userList.size(); i++) { UserDO user = userList.get(i); users[i] = new UserVO(); users[i].setId(user.getId()); users[i].setName(user.getName()); } // 返回使用者陣列 return users; }
案例二:儘量避免返回的列表為null,引起不必要的空指標判斷
現象描述:
// 呼叫程式碼List<UserVO> userList = queryUser();if (Objects.nonNull(userList)) { for (UserVO user : userList) { // 處理使用者資訊 } }// 查詢使用者函式private List<UserVO> queryUser(){ // 查詢使用者列表 List<UserDO> userList = userDAO.queryAll(); if(CollectionUtils.isEmpty(userList)) { return null; } // 轉化使用者列表 List<UserVO> userVoList = new ArrayList<>(userList.size()); for(UserDO user : userList) { UserVO userVo = new UserVO(); userVo.setId(user.getId()); userVo.setName(user.getName()); userVoList.add(userVo); } // 返回使用者列表 return userVoList; }
建議方案:
// 呼叫程式碼List<UserVO> userList = queryUser();for (UserVO user : userList) { // 處理使用者資訊 }// 查詢使用者函式private List<UserVO> queryUser(){ // 查詢使用者列表 List<UserDO> userList = userDAO.queryAll(); if(CollectionUtils.isEmpty(userList)) { return Collections.emptyList(); } // 轉化使用者列表 List<UserVO> userVoList = new ArrayList<>(userList.size()); for(UserDO user : userList) { UserVO userVo = new UserVO(); userVo.setId(user.getId()); userVo.setName(user.getName()); userVoList.add(userVo); } // 返回使用者列表 return userVoList; }
主要收益
- 保證返回的陣列和列表不為null, 避免呼叫函式的空指標判斷。
封裝函式傳入引數
案例一:當傳入引數過多時,應封裝為引數類
Java規範不允許函式引數太多,不便於維護也不便於擴充套件。
現象描述:
// 修改使用者函式public void modifyUser(Long id, String name, String phone, Integer age, Integer sex, String address, String description) { // 具體實現邏輯}
建議方案:
// 修改使用者函式public void modifyUser(User user) { // 具體實現內容}// 使用者類@Getter @Setter @ToString private class User{ private Long id; private String name; private String phone; private Integer age; private Integer sex; private String address; private String description; }
當傳入成組引數時,應封裝為引數類
既然引數成組出現,就需要封裝一個類去描述這種現象。
現象描述:
// 獲取距離函式public double getDistance(double x1, double y1, double x2, double y2) { // 具體實現邏輯}
建議方案:
// 獲取距離函式public double getDistance(Point point1, Point point2) { // 具體實現邏輯}// 點類@Getter @Setter @ToString private class Point{ private double x; private double y; }
主要收益
- 封裝過多函式引數為類,使函式更便於擴充套件和維護;
- 封裝成組函式引數為類,使業務概念更明確更清晰。
儘量用函式替換匿名內部類的實現
Java匿名內部類的優缺點:
在匿名內部類(包括Lambda表示式)中可以直接訪問外部類的成員,包括類的成員變數、函式的內部變數。正因為可以隨意訪問外部變數,所以會導致程式碼邊界不清晰。
首先推薦用Lambda表示式簡化匿名內部類,其次推薦用函式替換複雜的Lambda表示式的實現。
案例一:儘量用函式替換匿名內部類(包括Lambda表示式)的實現
現象描述:
// 傳送結算資料sendWorkerSettleData(WorkerPushDataType.CHECKER, () -> { Date beginDate = DateUtils.addDays(currDate, -aheadDays); Date endDate = DateUtils.addDays(currDate, 1); return auditTaskDAO.statCheckerSettleData(beginDate, endDate); });
建議方案:
// 傳送結算資料sendWorkerSettleData(WorkerPushDataType.CHECKER, () -> statCheckerSettleData(currDate, aheadDays));// 統計驗收員結算資料函式private List<WorkerSettleData> statCheckerSettleData(Date currDate, int aheadDays) { Date beginDate = DateUtils.addDays(currDate, -aheadDays); Date endDate = DateUtils.addDays(currDate, 1); return auditTaskDAO.statCheckerSettleData(beginDate, endDate); }
其實,還有一個更簡單的辦法。在呼叫函式sendWorkerSettleData(傳送作業員結算資料)之前計算開始日期、結束日期,就直接可以用函式auditTaskDAO.statCheckerSettleData(beginDate, endDate)代替匿名內部類實現。
案例二:拆分複雜匿名內部類實現介面為多個函式類介面
如果一個匿名內部類實現的介面幾個函式間關聯性不大,可以把這個介面拆分為幾個函式式介面,便於使用Lambda表示式。
現象描述:
// 清除過期資料cleanExpiredData("使用者日誌表", new CleanExpiredDataOperator() { @Override public List<Date> queryExpiredDate(Integer remainDays) { return userDAO.queryExpiredDate(remainDays); } @Override public void cleanExpiredData(Date expiredDate) { userDAO.cleanExpiredData(expiredDate); } });// 清除過期資料函式private void cleanExpiredData(String tableName, CleanExpiredDataOperator , cleanExpiredDataOperator) { // 功能實現程式碼}// 清除過期操作介面interface CleanExpiredDataOperator { // 查詢過期日期 public List<Date> queryExpiredDate(Integer remainDays); // 清除過期資料 public void cleanExpiredData(Date expiredDate); }
建議方案:
// 清除過期資料cleanExpiredData("使用者日誌表", userDAO::queryExpiredDate,userDAO::cleanExpiredData);// 清除過期資料函式private void cleanExpiredData(String tableName, QueryExpiredDateOperator queryExpiredDateOperator, CleanExpiredDataOperator cleanExpiredDataOperator) { // 功能實現程式碼}// 查詢過期日期介面interface QueryExpiredDateOperator { // 查詢過期日期 public List<Date> queryExpiredDate(Integer remainDays); }// 清除過期操作介面interface CleanExpiredDataOperator { // 清除過期資料 public void cleanExpiredData(Date expiredDate); }
主要收益
- 定義函式並指定引數,明確規定了匿名內部類的程式碼邊界;
- 利用Lambda表示式簡化匿名內部類實現,使程式碼更簡潔。
利用return精簡不必要的程式碼
案例一:刪除不必要的if
現象描述:
// 是否透過函式public boolean isPassed(Double passRate) { if (Objects.nonNull(passRate) && passRate.compareTo(PASS_THRESHOLD) >= 0) { return true; } return false; }
建議方案:
// 是否透過函式public boolean isPassed(Double passRate) { return Objects.nonNull(passRate) && passRate.compareTo(PASS_THRESHOLD) >= 0; }
案例二:刪除不必要的else
現象描述:
// 結算工資函式public double settleSalary(Long workId, int workDays) { // 根據是否合格處理 if (isQualified(workId)) { return settleQualifiedSalary(workDays); } else { return settleUnqualifiedSalary(workDays); } }
建議方案:
// 結算工資函式public double settleSalary(Long workId, int workDays) { // 根據是否合格處理 if (isQualified(workId)) { return settleQualifiedSalary(workDays); } return settleUnqualifiedSalary(workDays); }
案例三:刪除不必要的變數
現象描述:
// 查詢使用者函式public List<UserDO> queryUser(Long id, String name) { UserQuery userQuery = new UserQuery(); userQuery.setId(id); userQuery.setName(name); List<UserDO> userList = userDAO.query(userQuery); return userList; }
建議方案:
// 查詢使用者函式public List<UserDO> queryUser(Long id, String name) { UserQuery userQuery = new UserQuery(); userQuery.setId(id); userQuery.setName(name); return userDAO.query(userQuery); }
主要收益
- 精簡不必要的程式碼,讓程式碼看起來更清爽
利用臨時變數最佳化程式碼
在一些程式碼中,經常會看到a.getB().getC()...getN()的寫法,姑且叫做“函式的級聯呼叫”,程式碼健壯性和可讀性太差。建議:杜絕函式的級聯呼叫,利用臨時變數進行拆分,並做好物件空指標檢查。
案例一:利用臨時變數釐清邏輯
現象描述:
// 是否土豪使用者函式private boolean isRichUser(User user) { return Objects.nonNull(user.getAccount()) && Objects.nonNull(user.getAccount().getBalance()) && user.getAccount().getBalance().compareTo(RICH_THRESHOLD) >= 0; }
這是精簡程式碼控的最愛,但是可讀性實在太差。
建議方案:
// 是否土豪使用者函式private boolean isRichUser(User user) { // 獲取使用者賬戶 UserAccount account = user.getAccount(); if (Objects.isNull(account)) { return false; } // 獲取使用者餘額 Double balance = account.getBalance(); if (Objects.isNull(balance)) { return false; } // 比較使用者餘額 return balance.compareTo(RICH_THRESHOLD) >= 0; }
這個方案,增加了程式碼行數,但是邏輯更清晰。
有時候,當程式碼的精簡性和可讀性發生衝突時,個人更偏向於保留程式碼的可讀性。
案例二:利用臨時變數精簡程式碼
現象描述:
// 構建使用者函式public UserVO buildUser(UserDO user) { UserVO vo = new UserVO(); vo.setId(user.getId()); vo.setName(user.getName()); if (Objects.nonNull(user.getAccount())) { vo.setBalance(user.getAccount().getBalance()); vo.setDebt(user.getAccount().getDebt()); } return vo; }
這麼寫,大約是為了節約一個臨時變數把。
建議方案:
// 構建使用者函式public UserVO buildUser1(UserDO user) { UserVO vo = new UserVO(); vo.setId(user.getId()); vo.setName(user.getName()); UserAccount account = user.getAccount(); if (Objects.nonNull(account)) { vo.setBalance(account.getBalance()); vo.setDebt(account.getDebt()); } return vo; }
主要收益
- 利用臨時變數釐清邏輯,顯得業務邏輯更清晰;
- 利用臨時變數精簡程式碼,看變數名稱即知其義,減少了大量無用程式碼;
- 如果獲取函式比較複雜耗時,利用臨時變數可以提高執行效率;
- 利用臨時變數避免函式的級聯呼叫,可有效預防空指標異常。
僅保留函式需要的引數
在一些程式碼中,經常會看到a.getB().getC()...getN()的寫法,姑且叫做“函式的級聯呼叫”,程式碼健壯性和可讀性太差。建議:杜絕函式的級聯呼叫,利用臨時變數進行拆分,並做好物件空指標檢查。
案例一:刪除多餘的引數
現象描述:
// 修改使用者狀態函式private void modifyUserStatus(Long userId, Integer status, String unused) { userCache.modifyStatus(userId, status); userDAO.modifyStatus(userId, status); } 其中,unused引數是無用引數。 建議方案:// 修改使用者狀態函式private void modifyUserStatus(Long userId, Integer status) { userCache.modifyStatus(userId, status); userDAO.modifyStatus(userId, status); }
案例二:用屬性取代物件
現象描述:
// 刪除使用者函式private void deleteUser(User user) { userCache.delete(user.getId()); userDAO.delete(user.getId()); }
建議方案:
// 刪除使用者函式private void deleteUser(Long userId) { userCache.delete(userId); userDAO.delete(userId); }
建議方案:
呼叫函式時,引數物件不需要專門構建,而函式使用其屬性超過3個,可以不必使用該規則。
主要收益
僅保留函式需要的引數,明確了呼叫時需要賦值的引數,避免了呼叫時還要去構造些無用引數。
後記
"眾人拾柴火焰高"。如果有更多更好的觀點,亦或有更好的程式碼案例,歡迎大家進行補充說明。筆者希望以此文拋磚引玉,如果最終形成一套完善的Java編碼規範,善莫大焉。
來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/69941357/viewspace-2653494/,如需轉載,請註明出處,否則將追究法律責任。
相關文章
- 編碼規範 | Java函式優雅之道(上)Java函式
- c函式編寫規範函式
- 阿里Java編碼規範阿里Java
- Java 編碼規範 (轉)Java
- java編碼規範 (轉)Java
- Java語言編碼規範Java
- Google的Java編碼規範GoJava
- java編碼規範(2) (轉)Java
- 函式可重入性及編寫規範函式
- Java 程式編碼的規範(轉)Java
- Java原始碼的折行規則(編碼規範)Java原始碼
- 編碼規範系列:css規範CSS
- Java語言編碼規範(一) (轉)Java
- Java語言編碼規範(2)(轉)Java
- Java語言編碼規範(1)(轉)Java
- PHP程式碼規範簡潔之道PHP
- PHP 程式碼規範簡潔之道PHP
- 編碼規範 - 養成良好的Java編碼習慣Java
- Java語言編碼規範(Java Code Conventions)Java
- 程式碼規範之前端編寫碼規範前端
- 嵌入式c語言編碼規範C語言
- CSS編碼規範CSS
- Javascript編碼規範JavaScript
- html編碼規範HTML
- Swift 編碼規範Swift
- PHP編碼規範PHP
- SQL 編碼規範SQL
- 關於Java編碼規範的問題Java
- python編碼規範以及推導式的編寫Python
- WEB前端編碼規範Web前端
- python編碼規範Python
- 前端安全編碼規範前端
- 前端html編碼規範前端HTML
- Go 編碼規範指南Go
- Go編碼規範指南Go
- android 編碼規範Android
- HTML,CSS編碼規範HTMLCSS
- [轉]PHP編碼規範PHP