Posted on 2006-11-29 09:57
sxt 閱讀(680)
評論(0) 編輯 收藏
轉(zhuǎn)自：http://www.tkk7.com/rickhunter/articles/28133.html
1、 Log4j是什么？
? Log4j可以幫助調(diào)試（有時候debug是發(fā)揮不了作 用的）和分析，要下載和了解更詳細(xì)的內(nèi)容，還是訪問其官方網(wǎng)站吧：
http://jakarta.apache.org/log4j
。
2、Log4j的概念
?? Log4j中有三個主要的組件，它們分別是
Logger、Appender和Layout，Log4j 允許開發(fā)人員定義多個Logger，每個Logger擁有自己的名字，Logger之間通過名字來表明隸屬關(guān)系。有一個Logger稱為Root，它永遠(yuǎn)存在，且不能通過名字檢索或引用，可以通過Logger.getRootLogger()方法獲得，其它Logger通過 Logger.getLogger(String name)方法。
?? Appender則是用來指明將所有的log信息存放到什么地方，Log4j中支持多種appender，如
console、files、GUI components、NT Event Loggers等，一個Logger可以擁有多個Appender，也就是你既可以將Log信息輸出到屏幕，同時存儲到一個文件中。
?? Layout的作用是控制Log信息的輸出方式，也就是格式化輸出的信息。
?? Log4j中將要輸出的Log信息定義了5種級別，依次為DEBUG、INFO、WARN、ERROR和FATAL，當(dāng)輸出時，只有級別高過配置中規(guī)定的級別的信息才能真正的輸出，這樣就很方便的來配置不同情況下要輸出的內(nèi)容，而不需要更改代碼，這點實在是方便啊。
3、Log4j的配置文件
? 雖然可以不用配置文件，而在程序中實現(xiàn)配置，但這種方法在如今的系統(tǒng)開發(fā)中顯然是不可取的，能采用配置文件的地方一定一定要用配置文件。Log4j支持兩種格式的配置文件：XML格式和Java的property格式，本人更喜歡后者，首先看一個簡單的例子吧，如下：
? log4j.rootLogger=debug, stdout, R
? 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 [%t] (%F:%L) - %m%n
? log4j.appender.R=org.apache.log4j.RollingFileAppender
? log4j.appender.R.File=example.log
? log4j.appender.R.MaxFileSize=
100KB
? # Keep one backup file
? log4j.appender.R.MaxBackupIndex=1
? log4j.appender.R.layout=org.apache.log4j.PatternLayout
? log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n?????????
? 首先，是設(shè)置root，格式為 log4j.rootLogger=[level],appenderName,?...，其中l(wèi)evel就是設(shè)置需要輸出信息的級別，后面是appender的輸出的目的地，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（每天產(chǎn)生一個日志文件）
? org.apache.log4j.RollingFileAppender（文件大小到達(dá)指定尺寸的時候產(chǎn)生新文件）
? org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）
配置日志信息的格式（布局），其語法為：
? 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（包含日志產(chǎn)生的時間、線程、類別等等信息）
Log4J采用類似C語言中的printf函數(shù)的打印格式格式化日志信息，打印參數(shù)如下： %m 輸出代碼中指定的消息
%p 輸出優(yōu)先級，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL
%r 輸出自應(yīng)用啟動到輸出該log信息耗費的毫秒數(shù)
%c 輸出所屬的類目，通常就是所在類的全名
%t 輸出產(chǎn)生該日志事件的線程名
%n 輸出一個回車換行符，Windows平臺為“\r\n”，Unix平臺為“\n”
%d 輸出日志時間點的日期或時間，默認(rèn)格式為ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：
2002年10月18日
22：10：28，921
%l 輸出日志事件的發(fā)生位置，包括類目名、發(fā)生的線程，以及在代碼中的行數(shù)。舉例：Testlog4.main(TestLog4.java:10)
4、Log4j在程序中的使用
? 要在自己的程序中使用Log4j，首先需要將commons-logging.jar和logging-log4j-1.2.9.jar導(dǎo)入到構(gòu)建路徑中。然后再將log4j.properties放到src根目錄下。這樣就可以在程序中使用log4j了。在類中使用log4j，
首先聲明一個靜態(tài)變量
Logger logger=Logger.getLog("classname")；現(xiàn)在就可以使用了，用法如下：logger.debug("debug message")或者logger.info("info message")，看下面一個小例子：
? import com.foo.Bar;
? import org.apache.log4j.Logger;
??import org.apache.log4j.PropertyConfigurator;
??public class MyApp {
? ? static Logger logger = Logger.getLogger(MyApp.class.getName());
?? ?public static void main(String[] args) {
??? ? // BasicConfigurator replaced with PropertyConfigurator.
???? ?PropertyConfigurator.configure(args[0]);
????? logger.info("Entering application.");
????? Bar bar = new Bar();
????? bar.doIt();
????? logger.info("Exiting application.");
??? }
??}