JDK日志分級(jí)作為核心API最佳實(shí)踐淺析
JDK日志(Log)是什么?字典對(duì)其的解釋是"對(duì)某種機(jī)器工作情況或某項(xiàng)任務(wù)進(jìn)展情況的記載"。對(duì)于應(yīng)用系統(tǒng)來(lái)說(shuō)，JDK日志就應(yīng)該記錄應(yīng)用系統(tǒng)的運(yùn)行狀況了。
是否需要記錄JDK日志?這個(gè)問(wèn)題無(wú)需回答，這是毋庸置疑的--當(dāng)然要記了。
剩下的問(wèn)題就是應(yīng)該如何記錄日志才能確保日志具有高可用性和低耗性了。日志信息過(guò)于簡(jiǎn)化，乃至于沒(méi)有日志，則用戶無(wú)法找到解決問(wèn)題所需的信息，進(jìn)而妨礙問(wèn)題的解決;然而日志信息過(guò)于詳細(xì)不僅會(huì)降低系統(tǒng)的性能而且會(huì)使真正有用的信息淹沒(méi)在文字的海洋中。
為此JDK給出了建議的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í)比較感興趣的事件，或指示系統(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í)別更詳細(xì)的信息。包括進(jìn)入/返回方法調(diào)用，拋出了一個(gè)異常等信息。
FINEST級(jí)別描述更詳細(xì)的調(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)題所在。
此JDK日志分級(jí)標(biāo)準(zhǔn)被廣泛地應(yīng)用于中小型系統(tǒng)中。更詳細(xì)的信息可以參考JDKAPI文檔的java.util.logging部分。那么這個(gè)介紹你是否對(duì)JDK日志分級(jí)有所了解了呢？
【編輯推薦】
