Java學習篇之--- log4j.properties 詳解與配置步驟

標籤：java

log4j.properties 詳解與配置步驟

最近在剖析項目代碼，看到日誌功能，心血來潮收集整理了一下log4j的用法：

一、log4j.properties 的使用詳解

1.輸出層級的種類

ERROR、WARN、INFO、DEBUG
ERROR 為嚴重錯誤 主要是程式的錯誤
WARN 為一般警告，比如session丟失
INFO 為一般要顯示的資訊，比如登入登出
DEBUG 為程式的調試資訊

2.配置日誌資訊輸出目的地

log4j.appender.appenderName = fully.qualified.name.of.appender.class
1.org.apache.log4j.ConsoleAppender（控制台）
2.org.apache.log4j.FileAppender（檔案）
3.org.apache.log4j.DailyRollingFileAppender（每天產生一個記錄檔）
4.org.apache.log4j.RollingFileAppender（檔案大小到達指定尺寸的時候產生一個新的檔案）
5.org.apache.log4j.WriterAppender（將日誌資訊以流格式發送到任意指定的地方）

3.配置日誌資訊的格式

log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
1.org.apache.log4j.HTMLLayout（以HTML表格形式布局），
2.org.apache.log4j.PatternLayout（可以靈活地指定配置模式），
3.org.apache.log4j.SimpleLayout（包含日誌資訊的層級和資訊字串），
4.org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等資訊）

4.控制台選項

Threshold=DEBUG:指定日誌訊息的輸出最低層次。
ImmediateFlush=true:預設值是true,意謂著所有的訊息都會被立即輸出。
Target=System.err：預設情況下是：System.out,指定輸出控制台
FileAppender 選項
Threshold=DEBUF:指定日誌訊息的輸出最低層次。
ImmediateFlush=true:預設值是true,意謂著所有的訊息都會被立即輸出。
File=mylog.txt:指定訊息輸出到mylog.txt檔案。
Append=false:預設值是true,即將訊息增加到指定檔案中，false指將訊息覆蓋指定的檔案內容。
RollingFileAppender 選項
Threshold=DEBUG:指定日誌訊息的輸出最低層次。
ImmediateFlush=true:預設值是true,意謂著所有的訊息都會被立即輸出。
File=mylog.txt:指定訊息輸出到mylog.txt檔案。
Append=false:預設值是true,即將訊息增加到指定檔案中，false指將訊息覆蓋指定的檔案內容。
MaxFileSize=100KB: 尾碼可以是KB, MB 或者是 GB. 在記錄檔到達該大小時，將會自動滾動，即將原來的內容移到mylog.log.1檔案。
MaxBackupIndex=2:指定可以產生的滾動檔案的最大數。
log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n

5.日誌資訊格式中幾個符號所代表的含義：

 -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字元，就從左邊較遠輸出的字元截掉。

二、log4j.properties的配置

1、配置步驟

　　1）  在應用程式中使用log4j
　　2)     把log4j-*.*jar放入CLASSPATH變數中
　　3)     建立一個設定檔log4j.properties，放於bin檔案下
　　　　

2.建立一個設定檔log4j.properties，如：

　　log4j.rootLogger=WARN, stdout, Ryze
　　log4j.appender.stdout=org.apache.log4j.ConsoleAppender
　　log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
　　# Pattern to output the caller‘s file name and line number.
　　#log4j.appender.stdout.layout.ConversionPattern=%-5p %d{yyyyMMdd HH\:mm\:ss} %l %m%n
　　# Print the date in ISO 8601 format
　　log4j.appender.stdout.layout.ConversionPattern=%-5p %d{yyyyMMdd HH\:mm\:ss} %l %m%n
　　log4j.appender.Ryze=org.apache.log4j.RollingFileAppender
　　log4j.appender.Ryze.File=ryze.log
　　log4j.appender.Ryze.MaxFileSize=10MB
　　# Keep one backup file
　　log4j.appender.Ryze.MaxBackupIndex=1
　　log4j.appender.Ryze.layout=org.apache.log4j.PatternLayout
　　log4j.appender.Ryze.layout.ConversionPattern=%p %t %c - %m%n
　　# Print only messages of level WARN or above in the package com.foo.
　　log4j.logger.com.foo=WARN

　　編譯並運行TestLog4j會在目錄下產生一個ryze.log的檔案，螢幕也會輸出資訊，這證明已經你已經成功了第一步。

著作權聲明：本文為博主原創文章，未經博主允許不得轉載。

Java學習篇之--- log4j.properties 詳解與配置步驟