核心API最佳實(shí)踐——JDK日志分級(jí)

2019-11-18 11:54:46

字體：大中小

供稿：網(wǎng)友

　　日志（Log）是什么？字典對(duì)其的解釋是"對(duì)某種機(jī)器工作情況或某項(xiàng)任務(wù)進(jìn)展情況的記載"。對(duì)于應(yīng)用系統(tǒng)來(lái)說(shuō)，日志就應(yīng)該記錄應(yīng)用系統(tǒng)的運(yùn)行狀況了。
　　
　　是否需要記錄日志？這個(gè)問(wèn)題無(wú)需回答，這是毋庸置疑的--當(dāng)然要記了。
　　
　　剩下的問(wèn)題就是應(yīng)該如何記錄日志才能確保日志具有高可用性和低耗性了。日志信息過(guò)于簡(jiǎn)化，乃至于沒(méi)有日志，則用戶無(wú)法找到解決問(wèn)題所需的信息，進(jìn)而妨礙問(wèn)題的解決；然而日志信息過(guò)于具體不僅會(huì)降低系統(tǒng)的性能而且會(huì)使真正有用的信息沉沒(méi)在文字的海洋中。
　　
　　為此JDK給出了建議的日志分級(jí)標(biāo)準(zhǔn)。將不同的信息根據(jù)其重要性分級(jí)。與此同時(shí)可以根據(jù)實(shí)際需要在JRE中設(shè)置需要記錄的日志級(jí)別--級(jí)別高于此值的日志才被記錄。依照J(rèn)DK提供的標(biāo)準(zhǔn)（java.util.logging.Level）將日志劃分為OFF、SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST、ALL等從高到低九個(gè)級(jí)別。他們都分別對(duì)應(yīng)著唯一的整數(shù)值，即OFF=Integer.MAX_VALUE、SEVERE=1000、WARNING=900、INFO=800、CONFIG=700、FINE=500、FINER=400、FINEST=300、ALL=Integer.MIN_VALUE。通過(guò)對(duì)java.util.logging.Level的泛化（擴(kuò)展），開(kāi)發(fā)人員可以在JDK提供的標(biāo)準(zhǔn)基礎(chǔ)之上定義自己的日志分級(jí)標(biāo)準(zhǔn)。
　　
　　在這九個(gè)級(jí)別中OFF、SEVERE、WARNING、INFO、CONFIG、ALL比較輕易理解。
　　
　　OFF級(jí)別主要用于JRE日志輸出控制，表示不輸出任何信息。
　　
　　SEVERE（嚴(yán)重）級(jí)別描述組織程序正常運(yùn)行的重大事件。這些事件的表述必須能夠讓最終用戶和系統(tǒng)治理員清楚地了解到底發(fā)生了什么事情。
　　
　　WARNING（警告）級(jí)別描述了最終用戶或系統(tǒng)治理員維護(hù)時(shí)比較感愛(ài)好的事件，或指示系統(tǒng)存在潛在問(wèn)題的事件。這些事件都需要非凡提醒最終用戶或系統(tǒng)治理員注重。
　　
　　INFO（信息）級(jí)別主要用于描述輸出到控制臺(tái)或其替代品的，具有相當(dāng)程度重大意義的事件。譬如系統(tǒng)的心跳信息，以及其他系統(tǒng)希望告知最終用戶或系統(tǒng)治理員的信息等。
　　
　　CONFIG（配置）級(jí)別主要用于描述可以輔助調(diào)試解決問(wèn)題的靜態(tài)配置信息。譬如CPU類型、操作系統(tǒng)類型、內(nèi)存容量、系統(tǒng)語(yǔ)言等等。
　　
　　ALL級(jí)別也是主要用于JRE日志輸出控制，表示輸出所有日志信息。
　　
　　FINE、FINER、FINEST等三個(gè)級(jí)別被用于描述不同程度的跟蹤信息。這三個(gè)級(jí)別被sun分別翻譯為"良好"，"較好"和"最好"，但是筆者認(rèn)為翻譯為"略細(xì)"，"較細(xì)"，"最細(xì)"更合適。這三個(gè)級(jí)別比較輕易使人難于區(qū)分。到底什么樣的信息應(yīng)該以哪個(gè)級(jí)別輸出呢？
　　
　　一般說(shuō)來(lái)，F(xiàn)INE級(jí)別用于輸出開(kāi)發(fā)人員廣泛關(guān)注的信息。包括小的可恢復(fù)的故障，潛在的性能問(wèn)題、數(shù)據(jù)源連接不足、服務(wù)超時(shí)等。
　　
　　FINER級(jí)別描述比FINE級(jí)別更具體的信息。包括進(jìn)入/返回方法調(diào)用，拋出了一個(gè)異常等信息。
　　
　　FINEST級(jí)別描述更具體的調(diào)試信息。包括開(kāi)發(fā)人員在方法內(nèi)為了調(diào)試方便而輸出的調(diào)試信息，即某些日志分級(jí)系統(tǒng)中定義的DEBUG級(jí)別信息。
　　
　　將方法調(diào)用/返回信息作為一個(gè)單獨(dú)的級(jí)別處理是一個(gè)明智的選擇。在解決系統(tǒng)運(yùn)行問(wèn)題時(shí)，通常根據(jù)方法調(diào)用/返回過(guò)程就能大致確定問(wèn)題所在。
　　
　　此日志分級(jí)標(biāo)準(zhǔn)被廣泛地應(yīng)用于中小型系統(tǒng)中。更具體的信息可以參考JDKAPI文檔的java.util.logging部分。

上一篇：J2SE5.0用Executor靈活處理事件下發(fā)

下一篇：Java EJB容器的存取和實(shí)現(xiàn)