一.什么是log4j
Log4J是Apache的一個開放源代碼的項目。通過使用Log4J,程序員可以控制日志信息輸送的目的地,包括控制台,文件,GUI組件和NT事件記錄器,也可以控制每一條日志的輸出格式,或通過定義每一條日志信息的級別,更加細致地控制日志的生成過程。
二.日志及分類
軟件的運行過程中離不開日志,日志主要用來記錄系統運行過程中的一些重要的操作信息,便於監視系統運行時的情況,幫助用戶提前發現和避開可能出現的問題,或者出現問題后根據日志找到發生的原因。
日志根據記錄的不同,主要分為三類:
1.SQL日志:記錄系統執行的sql語句。
2.異常日志:記錄系統運行中發生的異常事件。
3.業務日志:記錄系統運行過程,如用戶的登錄,操作記錄。
三.配置文件說明
1、定義配置文件
Log4j支持兩種配置文件格式,一種是XML格式的文件,一種是Java特性文件log4j.properties(鍵=值)。下面將介紹使用log4j.properties文件作為配置文件的方法:
①配置根Logger
Logger 負責處理日志記錄的大部分操作。
其語法為:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中,level 是日志記錄的優先級,分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定義的級別。Log4j建議只使用四個級別,優 先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級別,您可以控制到應用程序中相應級別的日志信息的開關。比如在這里定 義了INFO級別,只有等於及高於這個級別的才進行處理,則應用程序中所有DEBUG級別的日志信息將不被打印出來。ALL:打印所有的日志,OFF:關 閉所有的日志輸出。 appenderName就是指定日志信息輸出到哪個地方。可同時指定多個輸出目的地。
②配置日志信息輸出目的地 Appender
Appender 負責控制日志記錄操作的輸出。
其語法為:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
log4j.appender.appenderName.optionN = valueN
這里的appenderName為在①里定義的,可任意起名。
其中,Log4j提供的appender有以下幾種:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天產生一個日志文件),
org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件),可通過 log4j.appender.R.MaxFileSize=100KB設置文件大小,還可通過 log4j.appender.R.MaxBackupIndex=1設置為保存一個備份文件。
org.apache.log4j.WriterAppender(將日志信息以流格式發送到任意指定的地方)
例如:log4j.appender.stdout=org.apache.log4j.ConsoleAppender
定義一個名為stdout的輸出目的地,ConsoleAppender為控制台。
③配置日志信息的格式(布局)Layout
Layout 負責格式化Appender的輸出。
其語法為:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.optionN = valueN
其中,Log4j提供的layout有以下幾種:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以靈活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),
org.apache.log4j.TTCCLayout(包含日志產生的時間、線程、類別等等信息)
2、格式化日志信息
Log4J采用類似C語言中的printf函數的打印格式格式化日志信息,打印參數如下:
%m 輸出代碼中指定的消息
%p 輸出優先級,即DEBUG,INFO,WARN,ERROR,FATAL
%r 輸出自應用啟動到輸出該log信息耗費的毫秒數
%c 輸出所屬的類目,通常就是所在類的全名
%t 輸出產生該日志事件的線程名
%n 輸出一個回車換行符,Windows平台為“rn”,Unix平台為“n”
%d 輸出日志時間點的日期或時間,默認格式為ISO8601,也可以在其后指定格式,比如:%d{yyyy MMM dd HH:mm:ss,SSS},輸出類似:2002年10月18日 22:10:28,921
%l 輸出日志事件的發生位置,包括類目名、發生的線程,以及在代碼中的行數。
四.如何使用log4j記錄日志
要使用log4j記錄日志,首先要下載log4j的jar文件,官方網站是http://logging.apache.org/log4j。當前下載地址是:http://logging.apache.org/log4j/1.2/dowload.html.下載好該文件,解壓后有一個apache-log4j-1.2.17\log4j-1.2.17.jar文件.
第一步:在項目中加入log4j所使用的jar文件
首先在項目中創建一個lib文件夾,把該文件復制該文件中。然后對已經復制過來的jar包鼠標點擊右鍵,選中BuildPath --------》Add to Build Path 然后你會在項目中看到多了一個引入外包的項目:Library
第二步:創建log4j.properties文件
選擇要使用的log4j項目,點擊src,依次選擇New————》File---------New File--------》輸入文件名,單擊Finish按鈕,結束創建。‘
第三步:編寫log4j.properties文件,配置日志信息。
1 log4j.rootLogger=Info,file, stdout 2 3 4 ### direct log messages to stdout ### 5 log4j.appender.stdout=org.apache.log4j.ConsoleAppender 6 log4j.appender.stdout.Target=System.out 7 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout 8 log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n 9 10 ### direct messages to file mylog.log ### 11 log4j.appender.file=org.apache.log4j.FileAppender 12 log4j.appender.file.File=D\:mylog.log 13 log4j.appender.file.layout=org.apache.log4j.PatternLayout 14 log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n 15 16 ### set log levels - for more verbose logging change 'info' to 'debug' ###
五.日志及級別
每個Logger都被了一個日志級別(log level),用來控制日志信息的輸出。日志級別從高到低分為:
01.off 最高等級,用於關閉所有日志記錄。
02.fatal 指出每個嚴重的錯誤事件將會導致應用程序的退出。
03.error 指出雖然發生錯誤事件,但仍然不影響系統的繼續運行。
04.warm 表明會出現潛在的錯誤情形。
05.info 一般和在粗粒度級別上,強調應用程序的運行全程。
06.debug 一般用於細粒度級別上,對調試應用程序非常有幫助。
07.all 最低等級,用於打開所有日志記錄。
六.在程序中使用lpg4j記錄日志
1 package cn.hyj.one; 2 import org.apache.log4j.Logger; 3 public class Test { 4 5 //通過Logger的getLogger獲取一個Loogger實例 6 public static Logger lo=Logger.getLogger(Test.class); 7 public static void main(String[] args) { 8 try { 9 int result=5/0;//出現異常 10 } catch (Exception e) { 11 System.out.println("除數不能為零!"); 12 lo.info("除數不能為0");//保存日志 13 } 14 15 } 16 }
聲明:本文轉自http://www.cnblogs.com/heyongjun1997/p/5427655.html 特此鳴謝!