log4j簡介

簡單的說log4j就是用于幫助開發人員進行日志輸出管理的API類庫。它最重要的特點是可以配置文件靈活的設置日志信息的優先級、日志信息的輸出目的地以及日志信息的輸出格式。Log4j除了可以記錄程序運行日志信息外還有一重要的功能就是用來顯示調試信息。

Log4j的類圖

• Logger - 日志寫出器，供程序員輸出日志信息
• Appender - 日志目的地，把格式化好的日志信息輸出到指定的地方去
• Layout - 日志格式化器，用來把程序員的logging request格式化成字符串

log4j使用方法

1、定義配置文件

　 首先使用配置文件將使我們的應用程序更加靈活配置。log日志輸出方式包括輸出優先級、輸出目的地、輸出格式。Log4j支持兩種配置文件格式，一種是XML格式的文件，一種是Java特性文件log4j.properties（鍵=值）。下面將介紹使用log4j.properties文件作為配置文件的方法：

　　①配置根Logger，其語法為：0

　　log4j.rootLogger = [ level ] , appenderName, appenderName, …

　　其中，level 是日志記錄的優先級，分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定義的級別。Log4j建議只使用四個級別，優先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級別，您可以控制到應用程序中相應級別的日志信息的開關。比如在這里定義了INFO級別，則應用程序中所有DEBUG級別的日志信息將不被打印出來。 appenderName就是指定日志信息輸出到哪個地方。可同時指定多個輸出目的地。

　　②配置日志信息輸出目的地Appender，其語法為：

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

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

　 ③配置日志信息的格式（布局），其語法為：

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

　　其中，Log4j提供的layout有以下幾種：
　　org.apache.log4j.HTMLLayout（以HTML表格形式布局），
　　org.apache.log4j.PatternLayout（可以靈活地指定布局模式），
　　org.apache.log4j.SimpleLayout（包含日志信息的級別和信息字符串），
　　org.apache.log4j.TTCCLayout（包含日志產生的時間、線程、類別等等信息）

　　Log4J采用類似C語言中的printf函數的打印格式格式化日志信息，打印參數如下： %m 輸出代碼中指定的消息

　　%p 輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL
　　%r 輸出自應用啟動到輸出該log信息耗費的毫秒數
　　%c 輸出所屬的類目，通常就是所在類的全名
　　%t 輸出產生該日志事件的線程名
　　%n 輸出一個回車換行符，Windows平臺為“\r\n”，Unix平臺為“\n”
　　%d 輸出日志時間點的日期或時間，默認格式為ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921
　　%l 輸出日志事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlog4.main(TestLog4.java:10)

2、在代碼中使用Log4j

　　①得到記錄器

　　使用Log4j，第一步就是獲取日志記錄器，這個記錄器將負責控制日志信息。其語法為：

　　public static Logger getLogger( String name)

　　通過指定的名字獲得記錄器，如果必要的話，則為這個名字創建一個新的記錄器。Name一般取本類的名字，比如：

　　static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )

　　②讀取配置文件

　　當獲得了日志記錄器之后，第二步將配置Log4j環境，其語法為：

        BasicConfigurator.configure ()： 自動快速地使用缺省Log4j環境。
　　PropertyConfigurator.configure ( String configFilename) ：讀取使用Java的特性文件編寫的配置文件。

例：PropertyConfigurator.configure(".\\src\\log4j.properties")
　　DOMConfigurator.configure ( String filename ) ：讀取XML形式的配置文件。

　　③插入記錄信息（格式化日志信息）

　　當上兩個必要步驟執行完畢，就可輕松地使用不同優先級別的日志記錄語句插入到您想記錄日志的任何地方，其語法如下：

　　Logger.debug ( Object message ) ;
　　Logger.info ( Object message ) ;
　　Logger.warn ( Object message ) ;
　　Logger.error ( Object message ) ;

下面是配置文件log4j.properties的內容： 

程序說明：

① log4j.rootCategory=DEBUG, stdout，R

要顯示所有優先權等于和高于Debug的信息。
"stdout"，”R”表示定義了兩個輸出端。

②下面的三行說stdout輸出端其實是標準輸出Console，也就是屏幕。輸出的格式是PatternLayout。轉換方式是%5p (%F:%L) - %m%n，即前五格用來顯示優先權，再顯示當前的文件名，加當前的行數。最后是logger.debug()或logger.info()或logger.warn()或logger.error()里的信息。%n表示回車空行。

③再加上下面六行則說明log信息不光顯示在屏幕上，而且被保存在一個叫"log.txt"的文件里，文件最大為100KB。如果文件大小超過100KB，文件會被備份成"log.txt.1"，新的"log.txt"繼續記錄log信息。

我們可以改變log4j.properties，而不需重新編譯就可以控制log信息是否顯示、log信息的輸出端類型、輸出方式、輸出格式，等等。舉例如下：

①在log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改寫成"log4j.rootCategory=OFF, stdout,R"，這樣所有的log信息都不會顯示了；解決了本文開始提出的問題。
②在log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改寫成"log4j.rootCategory=INFO, stdout,R"，這樣只顯示INFO, WARN, ERROR的log信息，而DEBUG信息不會被顯示；

在web程序中使用log4j注意問題

1、    由于jsp或servlet在執行狀態時沒有當前路徑概念，所有使用PropertyConfigurator.configure（String）語句找log4j.properties文件時要給出相對于當前jsp或servlet的路徑轉化成為一個絕對的文件系統路徑。方法是使用servletcontext.getrealpath(string)語句。例：

 2、相應的log4j.properties設置某個屬性時也要在程序中設置絕對路徑。例：

log4j.appender.R.File屬性設置日志文件存放位置。可以用讀寫.properties配置文件的方法進行靈活設置。

附：[配置文件]

### set log levels ###
log4j.rootLogger = debug ,  stdout ,  D ,  E

### 輸出到控制臺 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern =  %d{ABSOLUTE} %5p %c{ 1 }:%L - %m%n

### 輸出到日志文件 ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG ## 輸出DEBUG級別以上的日志
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

### 保存異常信息到單獨文件 ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File = logs/error.log ## 異常日志文件名
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR ## 只輸出ERROR級別以上的日志!!!
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n