在強(qiáng)調(diào)可重用組件開發(fā)的今天，除了自己從頭到尾開發(fā)一個(gè)可重用的日志操作類外，Apache為我們提供了一個(gè)強(qiáng)有力的日志操作包-Log4j。



Log4j是Apache的一個(gè)開放源代碼項(xiàng)目，通過使用Log4j，我們可以控制日志信息輸送的目的地是控制臺(tái)、文件、GUI組件、甚至是套接口服務(wù)器、NT的事件記錄器、UNIX Syslog守護(hù)進(jìn)程等；我們也可以控制每一條日志的輸出格式；通過定義每一條日志信息的級(jí)別，我們能夠更加細(xì)致地控制日志的生成過程。最令人感興趣的就是，這些可以通過一個(gè)配置文件來靈活地進(jìn)行配置，而不需要修改應(yīng)用的代碼。



此外，通過Log4j其他語言接口，您可以在C、C++、.Net、PL/SQL程序中使用Log4j，其語法和用法與在Java程序中一樣，使得多語言分布式系統(tǒng)得到一個(gè)統(tǒng)一一致的日志組件模塊。而且，通過使用各種第三方擴(kuò)展，您可以很方便地將Log4j集成到J2EE、JINI甚至是SNMP應(yīng)用中。



說明：下面分為三部分，第一部分講解如何配置log4j，第二部分為對(duì)log4j.properties配置文件中的各個(gè)屬性的講解，第三部分為對(duì)log4j的詳細(xì)講解，如果只想配置上log4j，那么只需要看前兩個(gè)部分就可以，如果想對(duì)log4j深入了解，則還需看第三部分。



一、Log4j配置



第一步：加入log4j-1.2.8.jar到lib下。



第二步：在CLASSPATH下建立log4j.properties。內(nèi)容如下：



1 log4j.rootCategory=INFO, stdout , R



2



3 log4j.appender.stdout=org.apache.log4j.ConsoleAppender



4 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout



5 log4j.appender.stdout.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n



6



7 log4j.appender.R=org.apache.log4j.DailyRollingFileAppender



8 log4j.appender.R.File=D:\Tomcat 5.5\logs\qc.log



9 log4j.appender.R.layout=org.apache.log4j.PatternLayout



10 log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n



11



12 log4j.logger.com.neusoft=DEBUG



13 log4j.logger.com.opensymphony.oscache=ERROR



14 log4j.logger.net.sf.navigator=ERROR



15 log4j.logger.org.apache.commons=ERROR



16 log4j.logger.org.apache.struts=WARN



17 log4j.logger.org.displaytag=ERROR



18 log4j.logger.org.springframework=DEBUG



19 log4j.logger.com.ibatis.db=WARN



20 log4j.logger.org.apache.velocity=FATAL



21



22 log4j.logger.com.canoo.webtest=WARN



23



24 log4j.logger.org.hibernate.ps.PreparedStatementCache=WARN



25 log4j.logger.org.hibernate=DEBUG



26 log4j.logger.org.logicalcobwebs=WARN



第三步：相應(yīng)的修改其中屬性，修改之前就必須知道這些都是干什么的，在第二部分講解。



第四步：在要輸出日志的類中加入相關(guān)語句：



定義屬性：protected final Log log = LogFactory.getLog(getClass());



在相應(yīng)的方法中：



if (log.isDebugEnabled())



{



log.debug(“System …..”);



}



二、Log4j說明



1 log4j.rootCategory=INFO, stdout , R



此句為將等級(jí)為INFO的日志信息輸出到stdout和R這兩個(gè)目的地，stdout和R的定義在下面的代碼，可以任意起名。等級(jí)可分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL，如果配置OFF則不打出任何信息，如果配置為INFO這樣只顯示INFO, WARN, ERROR的log信息，而DEBUG信息不會(huì)被顯示，具體講解可參照第三部分定義配置文件中的logger。



3 log4j.appender.stdout=org.apache.log4j.ConsoleAppender



此句為定義名為stdout的輸出端是哪種類型，可以是



org.apache.log4j.ConsoleAppender（控制臺(tái)），



org.apache.log4j.FileAppender（文件），



org.apache.log4j.DailyRollingFileAppender（每天產(chǎn)生一個(gè)日志文件），



org.apache.log4j.RollingFileAppender（文件大小到達(dá)指定尺寸的時(shí)候產(chǎn)生一個(gè)新的文件）



org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）



具體講解可參照第三部分定義配置文件中的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（包含日志信息的級(jí)別和信息字符串），



org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時(shí)間、線程、類別等等信息）



具體講解可參照第三部分定義配置文件中的Layout。



5 log4j.appender.stdout.layout.ConversionPattern= [QC] %p [%t] %C.%M(%L) | %m%n



如果使用pattern布局就要指定的打印信息的具體格式ConversionPattern，打印參數(shù)如下：



%m 輸出代碼中指定的消息



%p 輸出優(yōu)先級(jí)，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL



%r 輸出自應(yīng)用啟動(dòng)到輸出該log信息耗費(fèi)的毫秒數(shù)



%c 輸出所屬的類目，通常就是所在類的全名



%t 輸出產(chǎn)生該日志事件的線程名



%n 輸出一個(gè)回車換行符，Windows平臺(tái)為“rn”，Unix平臺(tái)為“n”



%d 輸出日志時(shí)間點(diǎn)的日期或時(shí)間，默認(rèn)格式為ISO8601，也可以在其后指定格式，比如：%d{yyyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921



%l 輸出日志事件的發(fā)生位置，包括類目名、發(fā)生的線程，以及在代碼中的行數(shù)。



[QC]是log信息的開頭，可以為任意字符，一般為項(xiàng)目簡稱。



輸出的信息



[TS] DEBUG [main] AbstractBeanFactory.getBean(189) | Returning cached instance of singleton bean 'MyAutoProxy'



具體講解可參照第三部分定義配置文件中的格式化日志信息。



7 log4j.appender.R=org.apache.log4j.DailyRollingFileAppender



此句與第3行一樣。定義名為R的輸出端的類型為每天產(chǎn)生一個(gè)日志文件。



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包下的所有類的等級(jí)為DEBUG。



可以把com.neusoft改為自己項(xiàng)目所用的包名。



13 log4j.logger.com.opensymphony.oscache=ERROR



14 log4j.logger.net.sf.navigator=ERROR



這兩句是把這兩個(gè)包下出現(xiàn)的錯(cuò)誤的等級(jí)設(shè)為ERROR，如果項(xiàng)目中沒有配置EHCache，則不需要這兩句。



15 log4j.logger.org.apache.commons=ERROR



16 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=WARN



25 log4j.logger.org.hibernate=DEBUG



此兩句是hibernate的包。



以上這些包的設(shè)置可根據(jù)項(xiàng)目的實(shí)際情況而自行定制。



三、log4j詳解



1、定義配置文件



Log4j支持兩種配置文件格式，一種是XML格式的文件，一種是Java特性文件log4j.properties（鍵=值）。下面將介紹使用log4j.properties文件作為配置文件的方法:



①、配置根Logger



Logger 負(fù)責(zé)處理日志記錄的大部分操作。



其語法為：



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



其中，level 是日志記錄的優(yōu)先級(jí)，分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定義的級(jí)別。Log4j建議只使用四個(gè)級(jí)別，優(yōu)先級(jí)從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級(jí)別，您可以控制到應(yīng)用程序中相應(yīng)級(jí)別的日志信息的開關(guān)。比如在這里定義了INFO級(jí)別，只有等于及高于這個(gè)級(jí)別的才進(jìn)行處理，則應(yīng)用程序中所有DEBUG級(jí)別的日志信息將不被打印出來。ALL:打印所有的日志，OFF：關(guān)閉所有的日志輸出。 appenderName就是指定日志信息輸出到哪個(gè)地方。可同時(shí)指定多個(gè)輸出目的地。



②、配置日志信息輸出目的地 Appender



Appender 負(fù)責(zé)控制日志記錄操作的輸出。



其語法為：



log4j.appender.appenderName = fully.qualified.name.of.appender.class



log4j.appender.appenderName.option1 = value1



…



log4j.appender.appenderName.optionN = valueN



這里的appenderName為在①里定義的，可任意起名。



其中，Log4j提供的appender有以下幾種：



org.apache.log4j.ConsoleAppender（控制臺(tái)），



org.apache.log4j.FileAppender（文件），



org.apache.log4j.DailyRollingFileAppender（每天產(chǎn)生一個(gè)日志文件），



org.apache.log4j.RollingFileAppender（文件大小到達(dá)指定尺寸的時(shí)候產(chǎn)生一個(gè)新的文件），可通過log4j.appender.R.MaxFileSize=100KB設(shè)置文件大小，還可通過log4j.appender.R.MaxBackupIndex=1設(shè)置為保存一個(gè)備份文件。



org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）



例如：log4j.appender.stdout=org.apache.log4j.ConsoleAppender



定義一個(gè)名為stdout的輸出目的地，ConsoleAppender為控制臺(tái)。



③、配置日志信息的格式（布局）Layout



Layout 負(fù)責(zé)格式化Appender的輸出。



其語法為：



log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class



log4j.appender.appenderName.layout.option1 = value1



…



log4j.appender.appenderName.layout.optionN = valueN



其中，Log4j提供的layout有以下幾種：



org.apache.log4j.HTMLLayout（以HTML表格形式布局），



org.apache.log4j.PatternLayout（可以靈活地指定布局模式），



org.apache.log4j.SimpleLayout（包含日志信息的級(jí)別和信息字符串），



org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時(shí)間、線程、類別等等信息）



2、格式化日志信息



Log4J采用類似C語言中的printf函數(shù)的打印格式格式化日志信息，打印參數(shù)如下：



%m 輸出代碼中指定的消息



%p 輸出優(yōu)先級(jí)，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL



%r 輸出自應(yīng)用啟動(dòng)到輸出該log信息耗費(fèi)的毫秒數(shù)



%c 輸出所屬的類目，通常就是所在類的全名



%t 輸出產(chǎn)生該日志事件的線程名



%n 輸出一個(gè)回車換行符，Windows平臺(tái)為“rn”，Unix平臺(tái)為“n”



%d 輸出日志時(shí)間點(diǎn)的日期或時(shí)間，默認(rèn)格式為ISO8601，也可以在其后指定格式，比如：%d{yyyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921



%l 輸出日志事件的發(fā)生位置，包括類目名、發(fā)生的線程，以及在代碼中的行數(shù)。



3、在代碼中使用Log4j



我們?cè)谛枰敵鋈罩拘畔⒌念愔凶鋈缦碌娜齻€(gè)工作：



1、導(dǎo)入所有需的commongs-logging類：



import org.apache.commons.logging.Log;



import org.apache.commons.logging.LogFactory;



2、在自己的類中定義一個(gè)org.apache.commons.logging.Log類的私有靜態(tài)類成員：



private final Log log = LogFactory.getLog(getClass());



LogFactory.getLog()方法的參數(shù)使用的是當(dāng)前類的class。



3、使用org.apache.commons.logging.Log類的成員方法輸出日志信息：



if (log.isDebugEnabled())



{



log.debug("111");



}



if (log.isInfoEnabled())



{



log.info("222");



}



if (log.isWarnEnabled())



{



log.warn("333");



}



if (log.isErrorEnabled())



{



log.error("444");



}



if (log.isFatalEnabled())



{



log.fatal("555")



}