怎么在Java代碼里正確的打日志

本篇內容主要講解“怎么在Java代碼里正確的打日志”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實用性強。下面就讓小編來帶大家學習“怎么在Java代碼里正確的打日志”吧!

打日志的正確方式

什么時候應該打日志

1. 當你遇到問題的時候，只能通過debug功能來確定問題，你應該考慮打日志，良好的系統，是可以通過日志進行問題定為的。

2. 當你碰到if…else 或者 switch這樣的分支時，要在分支的首行打印日志，用來確定進入了哪個分支

3. 經常以功能為核心進行開發，你應該在提交代碼前，可以確定通過日志可以看到整個流程

基本格式

必須使用參數化信息的方式:

logger.debug("Processing trade with id:[{}] and symbol : [{}] ", id, symbol);

對于debug日志，必須判斷是否為debug級別后，才進行使用:

if (logger.isDebugEnabled()) {     logger.debug("Processing trade with id: " +id + " symbol: " + symbol); }

不要進行字符串拼接,那樣會產生很多String對象，占用空間，影響性能。

反例(不要這么做):

logger.debug("Processing trade with id: " + id + " symbol: " + symbol);

使用[]進行參數變量隔離

如有參數變量，應該寫成如下寫法:

logger.debug("Processing trade with id:[{}] and symbol : [{}] ", id, symbol);

這樣的格式寫法，可讀性更好，對于排查問題更有幫助。

不同級別的使用

ERROR:

基本概念

影響到程序正常運行、當前請求正常運行的異常情況:

1. 打開配置文件失敗

2. 所有第三方對接的異常(包括第三方返回錯誤碼)

3. 所有影響功能使用的異常，包括:SQLException和除了業務異常之外的所有異常(RuntimeException和Exception)

不應該出現的情況:

比如要使用Azure傳圖片，但是Azure未響應

如果有Throwable信息，需要記錄完成的堆棧信息:

log.error("獲取用戶[{}]的用戶信息時出錯",userName,e);

說明

如果進行了拋出異常操作，請不要記錄error日志，由最終處理方進行處理：

反例(不要這么做):

try{     .... }catch(Exception ex){   String errorMessage=String.format("Error while reading information of user [%s]",userName);   logger.error(errorMessage,ex);   throw new UserServiceException(errorMessage,ex); }

WARN

基本概念

不應該出現但是不影響程序、當前請求正常運行的異常情況:

1. 有容錯機制的時候出現的錯誤情況

2. 找不到配置文件，但是系統能自動創建配置文件

即將接近臨界值的時候，例如：

緩存池占用達到警告線

業務異常的記錄,比如:

當接口拋出業務異常時，應該記錄此異常

INFO:

基本概念

系統運行信息

1. Service方法中對于系統/業務狀態的變更

2. 主要邏輯中的分步驟

外部接口部分

1. 客戶端請求參數(REST/WS)

2. 調用第三方時的調用參數和調用結果

說明

     1.并不是所有的service都進行出入口打點記錄,單一、簡單service是沒有意義的(job除外,job需要記錄開始和結束,)。

      反例(不要這么做):

public List listByBaseType(Integer baseTypeId) {      log.info("開始查詢基地"); BaseExample ex=new BaseExample(); BaseExample.Criteria ctr = ex.createCriteria(); ctr.andIsDeleteEqualTo(IsDelete.USE.getValue()); Optionals.doIfPresent(baseTypeId, ctr::andBaseTypeIdEqualTo);    log.info("查詢基地結束"); return baseRepository.selectByExample(ex);   }

       2.對于復雜的業務邏輯，需要進行日志打點，以及埋點記錄，比如電商系統中的下訂單邏輯，以及OrderAction操作(業務狀態變更)。

       3.對于整個系統的提供出的接口(REST/WS)，使用info記錄入參

       4.如果所有的service為SOA架構，那么可以看成是一個外部接口提供方，那么必須記錄入參。

       5.調用其他第三方服務時，所有的出參和入參是必須要記錄的(因為你很難追溯第三方模塊發生的問題)

DEBUG

基本概念

1. 可以填寫所有的想知道的相關信息(但不代表可以隨便寫，debug信息要有意義,***有相關參數)

2. 生產環境需要關閉DEBUG信息

3. 如果在生產情況下需要開啟DEBUG,需要使用開關進行管理，不能一直開啟。

說明

如果代碼中出現以下代碼，可以進行優化:

//1. 獲取用戶基本薪資  //2. 獲取用戶休假情況  //3. 計算用戶應得薪資

優化后的代碼:

logger.debug("開始獲取員工[{}] [{}]年基本薪資",employee,year); logger.debug("獲取員工[{}] [{}]年的基本薪資為[{}]",employee,year,basicSalary); logger.debug("開始獲取員工[{}] [{}]年[{}]月休假情況",employee,year,month);  logger.debug("員工[{}][{}]年[{}]月年假/病假/事假為[{}]/[{}]/[{}]",employee,year,month,annualLeaveDays,sickLeaveDays,noPayLeaveDays); logger.debug("開始計算員工[{}][{}]年[{}]月應得薪資",employee,year,month);  logger.debug("員工[{}] [{}]年[{}]月應得薪資為[{}]",employee,year,month,actualSalary);

TRACE

基本概念

特別詳細的系統運行完成信息，業務代碼中，不要使用.(除非有特殊用意，否則請使用DEBUG級別替代)

規范示例說明

@Override @Transactional public void createUserAndBindMobile(@NotBlank String mobile, @NotNull User user) throws CreateConflictException{     boolean debug = log.isDebugEnabled();     if(debug){         log.debug("開始創建用戶并綁定手機號. args[mobile=[{}],user=[{}]]", mobile, LogObjects.toString(user));     }     try {         user.setCreateTime(new Date());         user.setUpdateTime(new Date());         userRepository.insertSelective(user);         if(debug){             log.debug("創建用戶信息成功. insertedUser=[{}]",LogObjects.toString(user));         }         UserMobileRelationship relationship = new UserMobileRelationship();         relationship.setMobile(mobile);         relationship.setOpenId(user.getOpenId());         relationship.setCreateTime(new Date());         relationship.setUpdateTime(new Date());         userMobileRelationshipRepository.insertOnDuplicateKey(relationship);         if(debug){             log.debug("綁定手機成功. relationship=[{}]",LogObjects.toString(relationship));         }         log.info("創建用戶并綁定手機號. userId=[{}],openId=[{}],mobile=[{}]",user.getId(),user.getOpenId(),mobile); // 如果考慮安全，手機號記得脫敏     }catch(DuplicateKeyException e){         log.info("創建用戶并綁定手機號失敗,已存在相同的用戶. openId=[{}],mobile=[{}]",user.getOpenId(),mobile);         throw new CreateConflictException("創建用戶發生沖突, openid=[%s]",user.getOpenId());     } }

到此，相信大家對“怎么在Java代碼里正確的打日志”有了更深的了解，不妨來實際操作一番吧！這里是億速云網站，更多相關內容可以進入相關頻道進行查詢，關注我們，繼續學習！