Log4j

一：Log4j  構成
經過配置文件可知，咱們須要配置3個方面的內容：
一、根目錄（級別和目的地）；
二、目的地（控制檯、文件等等）；
三、輸出樣式。
下面咱們來看看Log4J的類圖：

 

Logger - 日誌寫出器，供程序員輸出日誌信息
Appender - 日誌目的地，把格式化好的日誌信息輸出到指定的地方去
ConsoleAppender - 目的地爲控制檯的Appender
FileAppender - 目的地爲文件的Appender
RollingFileAppender - 目的地爲大小受限的文件的Appender
Layout - 日誌格式化器，用來把程序員的logging request格式化成字符串
PatternLayout - 用指定的pattern格式化logging request的Layout

二：優先級：ALL < DEBUG < INFO <WARN < ERROR < FATAL < OFF

三：Log4j配置：一種是XML格式的文件，一種是properties（key=value）文件。

Log4j提供的appender有如下幾種：
org.apache.log4j.ConsoleAppender（控制檯），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件），
org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件），
org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）。

1) ConsoleAppender選項
Threshold=WARN:指定日誌消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
Target=System.err：默認狀況下是：System.out,指定輸出控制檯
2) FileAppender 選項
Threshold=WARN:指定日誌消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。
3) DailyRollingFileAppender 選項
Threshold=WARN:指定日誌消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。
DatePattern=''.''yyyy-ww:每週滾動一次文件，即每週產生一個新的文件。
固然也能夠指定按月、周、天、時和分。即對應的格式以下：
1)''.''yyyy-MM: 每個月
2)''.''yyyy-ww: 每週
3)''.''yyyy-MM-dd: 天天
4)''.''yyyy-MM-dd-a: 天天兩次
5)''.''yyyy-MM-dd-HH: 每小時
6)''.''yyyy-MM-dd-HH-mm: 每分鐘
4) RollingFileAppender 選項
Threshold=WARN:指定日誌消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着全部的消息都會被當即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增長到指定文件中，false指將消息覆蓋指定的文件內容。
MaxFileSize=100KB: 後綴能夠是KB, MB 或者是 GB. 在日誌文件到達該大小時，將會自動滾動，即將原來的內容移到mylog.log.1文件。
MaxBackupIndex=2:指定能夠產生的滾動文件的最大數。

Log4j提供的layout有如下幾種：
org.apache.log4j.HTMLLayout（以HTML表格形式佈局），
org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式），
org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串），
org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）
1) HTMLLayout選項
LocationInfo=true:默認值是false,輸出java文件名稱和行號
Title=my app file: 默認值是 Log4J Log Messages.
2) PatternLayout選項
ConversionPattern=%m%n :指定怎樣格式化指定的消息。
3) XMLLayout選項
LocationInfo=true:默認值是false,輸出java文件和行號

Log4J採用相似C語言中的printf函數的打印格式格式化日誌信息，打印參數以下：
og4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
這裏須要說明的就是日誌信息格式中幾個符號所表明的含義：
-X號: X信息輸出時左對齊；
%p: 輸出日誌信息優先級，即DEBUG，INFO，WARN，ERROR，FATAL,
%d: 輸出日誌時間點的日期或時間，默認格式爲ISO8601，也能夠在其後指定格式，
好比：%d{yyy MMM dd HH:mm:ss,SSS}，輸出相似：2002年10月18日 22：10：28，921
%r: 輸出自應用啓動到輸出該log信息耗費的毫秒數
%c: 輸出日誌信息所屬的類目，一般就是所在類的全名
%t: 輸出產生該日誌事件的線程名
%l: 輸出日誌事件的發生位置，至關於%C.%M(%F:%L)的組合,包括類目名、發生的線程，以及行數。
舉例：Testlog4.main(TestLog4.java:10)
%x: 輸出和當前線程相關聯的NDC(嵌套診斷環境)，尤爲用到像java servlets這樣的多客戶多線程的應用中。
%%: 輸出一個"%"字符
%F: 輸出日誌消息產生時所在的文件名稱
%L: 輸出代碼中的行號
%m: 輸出代碼中指定的消息,產生的日誌具體信息
%n: 輸出一個回車換行符，Windows平臺爲"\r\n"，Unix平臺爲"\n"輸出日誌信息換行
能夠在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如：
1)%20c：指定輸出category的名稱，最小的寬度是20，若是category的名稱小於20的話，默認的狀況下右對齊。
2)%-20c:指定輸出category的名稱，最小的寬度是20，若是category的名稱小於20的話，"-"號指定左對齊。
3)%.30c:指定輸出category的名稱，最大的寬度是30，若是category的名稱大於30的話，就會將左邊多出的字符截掉，但小於30的話也不會有空格。
4)%20.30c:若是category的名稱小於20就補空格，而且右對齊，若是其名稱長於30字符，就從左邊交遠銷出的字符截掉

 Properties文件實例說明

1 log4j.rootLogger=INFO, stdout , R
此句爲將等級爲INFO的日誌信息輸出到stdout和R這兩個目的地，stdout和R的定義在下面的代碼，能夠任意起名。等級可分爲OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL，若是配置OFF則不打出任何信息，若是配置爲INFO這樣只顯示INFO, WARN, ERROR的log信息，而DEBUG信息不會被顯示，具體講解可參照第三部分定義配置文件中的logger。
3 log4j.appender.stdout=org.apache.log4j.ConsoleAppender
此句爲定義名爲stdout的輸出端是哪一種類型，能夠是
org.apache.log4j.ConsoleAppender（控制檯）
org.apache.log4j.FileAppender（文件）
org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件），
org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件）
org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）
具體講解可參照第三部分定義配置文件中的Appender。
4 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
此句爲定義名爲stdout的輸出端的layout是哪一種類型，能夠是
org.apache.log4j.HTMLLayout（以HTML表格形式佈局）
org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式
org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串）
org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）
具體講解可參照第三部分定義配置文件中的Layout。
5 log4j.appender.stdout.layout.ConversionPattern= [QC] %p [%t] %C.%M(%L) | %m%n
若是使用pattern佈局就要指定的打印信息的具體格式ConversionPattern，打印參數以下：
%m 輸出代碼中指定的消息
%p 輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL
%r 輸出自應用啓動到輸出該log信息耗費的毫秒數
%c 輸出所屬的類目，一般就是所在類的全名
%t 輸出產生該日誌事件的線程名
%n 輸出一個回車換行符，Windows平臺爲「\r\n」，Unix平臺爲「\n」
%d 輸出日誌時間點的日期或時間，默認格式爲ISO8601，也能夠在其後指定格式
好比：%d{yyyy MMM dd HH:mm:ss,SSS}，輸出相似：2002年10月18日 22：10：28，921
%l 輸出日誌事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。
[QC]是log信息的開頭，能夠爲任意字符，通常爲項目簡稱。
輸出的信息
[TS] DEBUG [main] AbstractBeanFactory.getBean(189) | Returning cached instance of singleton bean 'MyAutoProxy'
具體講解可參照第三部分定義配置文件中的格式化日誌信息。
7 log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
此句與第3行同樣。定義名爲R的輸出端的類型爲天天產生一個日誌文件。
8 log4j.appender.R.File=D:\\Tomcat 5.5\\logs\\qc.log
此句爲定義名爲R的輸出端的文件名爲D:\\Tomcat 5.5\\logs\\qc.log能夠自行修改。
9 log4j.appender.R.layout=org.apache.log4j.PatternLayout
與第4行相同。
10 log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n
與第5行相同。
12 log4j.logger.com.neusoft=DEBUG
指定com.neusoft包下的全部類的等級爲DEBUG。
能夠把com.neusoft改成本身項目所用的包名。

13 log4j.logger.com.opensymphony.oscache=ERROR
14 log4j.logger.net.sf.navigator=ERROR
這兩句是把這兩個包下出現的錯誤的等級設爲ERROR，若是項目中沒有配置EHCache，則不須要這兩句。

15 log4j.logger.org.apache.commons=ERROR16 log4j.logger.org.apache.struts=WARN這兩句是struts的包。17 log4j.logger.org.displaytag=ERROR這句是displaytag的包。（QC問題列表頁面所用）18 log4j.logger.org.springframework=DEBUG此句爲Spring的包。24 log4j.logger.org.hibernate.ps.PreparedStatementCache=WARN25 log4j.logger.org.hibernate=DEBUG此兩句是hibernate的包。以上這些包的設置可根據項目的實際狀況而自行定製。