log4j使用總結

 一、log4j引入三部曲

1）引入import jar包（最新1.2.17）  http://logging.apache.org/
2）新建配置文件log4j.properties，置於project根目錄下
3）代碼引入：
    Logger logger  =  Logger.getLogger(TestLog4j. class );
            logger.debug( " debug " );

            logger.error( " error " );

二、log4j.properties配置文件說明：

Log4J的配置文件(Configuration File)就是用來設置記錄器的級別、存放器和佈局的，
它可接key=value格式的設置或xml格式的設置信息。通過配置，
可以創建出Log4J的運行環境。

log4j.properties配置文件範例：

log4j.rootLogger=ERROR,stdout,stderr
#log4j.logger.syslog=stdout
######################### logger ##############################
# stdout is set to be a ConsoleAppender.
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.conversionPattern=%d [%t] %-5p %c - %m%n

# stderr is set to be a FileAppender.
log4j.appender.stderr=org.apache.log4j.DailyRollingFileAppender
log4j.appender.stderr.File=log/stderr.log
log4j.appender.stderr.Append=true
log4j.appender.stderr.layout=org.apache.log4j.PatternLayout
log4j.appender.stderr.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] %-5p %c %x - %m%n

log4j.logger.task=INFO,task
log4j.appender.task=org.apache.log4j.DailyRollingFileAppender
log4j.appender.task.Threshold = INFO
log4j.appender.task.File=log/pcbaby/task.log
log4j.appender.task.DatePattern = '.'yyyy-MM-dd
log4j.appender.task.Append=true
log4j.appender.task.layout=org.apache.log4j.PatternLayout
log4j.appender.task.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] %-5p %c %x - %m%n
log4j.additivity.task=false

1、配置說明

#配置根Logger

log4j.rootLogger  =   [ level ]   ,  appenderName1 ,  appenderName2 ,  …

#配置日誌信息輸出目的地Appender

log4j.appender.appenderName  =  fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1  =  value1
…
log4j.appender.appenderName.optionN  =  valueN

注意：

A、第一行appenderName爲自定義appderName，在log4j.rootLogger設置中使用；

value可設值如下：

org.apache.log4j.ConsoleAppender(控制檯)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌文件)
org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件)
org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)

B、第二行開始option爲輸出選項，如DailyRollingFileAppender選項：

Threshold=WARN  指定日誌信息的最低輸出級別，默認爲DEBUG。
ImmediateFlush=true  表示所有消息都會被立即輸出，設爲false則不輸出，默認值是true。
Append=false  true表示消息增加到指定文件中，false則將消息覆蓋指定的文件內容，默認true。
File=D:/logs/logging.log4j  指定當前消息輸出到logging.log4j文件中。
DatePattern='.'yyyy-MM  每月滾動一次日誌文件，即每月產生一個新的日誌文件。
當前月的日誌文件名爲logging.log4j，前一個月的日誌文件名爲logging.log4j.yyyy-MM。
另外，也可以指定按周、天、時、分等來滾動日誌文件，對應的格式如下：
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：每分鐘

#配置日誌信息的格式（佈局）

log4j.appender.appenderName.layout  =  fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1  =  value1
…
log4j.appender.appenderName.layout.optionN  =  valueN

注意：

A、第一行Layout爲日誌輸出格式，Log4j提供的layout有以下幾種：

org.apache.log4j.HTMLLayout（以HTML表格形式佈局），
org.apache.log4j.PatternLayout（可以靈活地指定佈局模式），
org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串），
org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）

B、第二行開始option爲輸出格式選項，Log4J採用類似C語言中的printf函數的打印格式格式化日誌信息，如下:

%p   輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL
%c   輸出所屬的類目，通常就是所在類的全名
%t   輸出產生該日誌事件的線程名
%m   輸出代碼中指定的消息
%n   輸出一個回車換行符，Windows平臺爲“/r/n”，Unix平臺爲“/n”
%d   輸出日誌時間點的日期或時間，默認格式爲ISO8601，也可以在其後指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，輸出類似：2002年10月18日  22 ： 10 ： 28 ， 921

2、日誌記錄器(Logger)的可用級別（優先級從低到高），共有5級：

DEBUG Level指出細粒度信息事件對調試應用程序是非常有幫助的。

INFO level表明 消息在粗粒度級別上突出強調應用程序的運行過程。

WARN level表明會出現潛在錯誤的情形。

ERROR level指出雖然發生錯誤事件，但仍然不影響系統的繼續運行。

FATAL level指出每個嚴重的錯誤事件將會導致應用程序的退出。

PS：Log4j建議只使用前四個級別

3、自定義appenderName變量名，如範例中第三段task定時任務的配置，代碼中以字符串形式獲取：

protected  Log log = LogFactory.getLog("task");

注意：

log4j.additivity.task=false
子Logger 是否繼承 父Logger 的 輸出源（appender） 的標誌。