在
項目的開發(fā)過程中，系統(tǒng)對日志的要求很細(xì)，而且要求分類清楚。所以還是采用了Log4J。
在強(qiáng)調(diào)可重用組件開發(fā)的今天，除了自己從頭到尾開發(fā)一個可重用的日志操作類外，Apache為我們提供了一個強(qiáng)有力的日志操作包-Log4j。
Log4j是Apache的一個開放源代碼項目，通過使用Log4j，我們可以控制日志信息輸送的目的地是控制臺、文件、GUI組件、甚至是套接口服務(wù)器、NT的事件記錄器、UNIX Syslog守護(hù)進(jìn)程等；我們也可以控制每一條日志的輸出格式；通過定義每一條日志信息的級別，我們能夠更加細(xì)致地控制日志的生成過程。最令人感興趣的就是，這些可以通過一個配置文件來靈活地進(jìn)行配置，而不需要修改應(yīng)用的代碼。
此外，通過Log4j其他語言接口，您可以在C、php、C++、.Net、PL/SQL程序中使用Log4j，其語法和用法與在Java程序中一樣，使得多語言分布式系統(tǒng)得到一個統(tǒng)一一致的日志組件模塊。而且，通過使用各種第三方擴(kuò)展，您可以很方便地將Log4j集成到J2EE、JINI甚至是SNMP應(yīng)用中。
Log4j配置文件詳細(xì)說明（*.properties和*.xml）
屬性文件Properties
properties屬性文件
編號 配置項 配置項描述 示例
1 log4j.threshold 閾值項
log4j.threshold = error
2 log4j.rootLogger 根日志屬性項
log4j.rootLogger = info,stdout1,stdout2
3 log4j.category. 子日志屬性項（舊）
log4j.category.com.eos = NULL,stdout1
4 log4j.logger. 子日志屬性項（新）
log4j.logger.com.eos.log = debug,stdout2
5 log4j.additivity. appender是否繼承設(shè)置
log4j.additivity.com.eos = false
6 log4j.appender. 輸出目的地定義項
log4j.appender.stdout2 = org.apache.log4j.ConsoleAppender
7 log4j.appender.A.layout 輸出格式定義項
log4j.appender.stdout2.layout = org.apache.log4j.PatternLayout
xml文件
編號 配置項 配置項描述 示例
1 threshold 閾值項
2 root 根日志屬性項
3 priority 級別項（舊）
4 level 級別項（新）
5 category 子日志屬性項（舊）
6 logger 子日志屬性項（新）
7 appender-ref 輸出端控制項
8 additivity appender是否繼承設(shè)置
9 appender 輸出目的地定義項
10 layout 輸出格式定義項
詳細(xì)說明（只針對Log4j常用的，用戶可以自定義）Appender
Appender繼承關(guān)系
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ā)送到任意指定的地方）
· ConsoleAppender選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
Target=System.err：默認(rèn)情況下是：System.out,指定輸出控制臺
· FileAppender 選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認(rèn)值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內(nèi)容。
· DailyRollingFileAppender 選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認(rèn)值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內(nèi)容。
DatePattern='.'yyyy-ww:每周滾動一次文件，即每周產(chǎn)生一個新的文件。當(dāng)然也可以指定按月、周、
天、時和分。即對應(yīng)的格式如下：
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: 每分鐘
n RollingFileAppender 選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認(rèn)值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內(nèi)容。
MaxFileSize=100KB: 后綴可以是KB, MB 或者是 GB. 在日志文件到達(dá)該大小時，將會自動滾動，即將原來
的內(nèi)容移到mylog.log.1文件。
MaxBackupIndex=2:指定可以產(chǎn)生的滾動文件的最大數(shù)。
詳細(xì)說明（只針對Log4j，用戶可以自定義）Layout
Log4j的Layout基本種類
org.apache.log4j.HTMLLayout（以HTML表格形式布局），
org.apache.log4j.PatternLayout（可以靈活地指定布局模式），
org.apache.log4j.SimpleLayout（包含日志信息的級別和信息字符串），
org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時間、線程、類別等等信息）
· HTMLLayout選項
LocationInfo=true:默認(rèn)值是false,輸出java文件名稱和行號
Title=my app file: 默認(rèn)值是 Log4J Log Messages.
n PatternLayout 選項
log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n
這里需要說明的就是日志信息格式中幾個符號所代表的含義：
%X: 信息輸出時左對齊；
%p: 輸出日志信息優(yōu)先級，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL,
%d: 輸出日志時間點的日期或時間，默認(rèn)格式為ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921
%r: 輸出自應(yīng)用啟動到輸出該log信息耗費(fèi)的毫秒數(shù)
%c: 輸出日志信息所屬的類目，通常就是所在類的全名
%t: 輸出產(chǎn)生該日志事件的線程名
%l: 輸出日志事件的發(fā)生位置，相當(dāng)于%C.%M(%F:%L)的組合,包括類目名、發(fā)生的線程，以及在代碼中的行數(shù)。舉例：Testlog4.main(TestLog4.java:10)
%x: 輸出和當(dāng)前線程相關(guān)聯(lián)的NDC(嵌套診斷環(huán)境),尤其用到像java servlets這樣的多客戶多線程的應(yīng)用中。
%%: 輸出一個"%"字符
%F: 輸出日志消息產(chǎn)生時所在的文件名稱
%L: 輸出代碼中的行號
%m: 輸出代碼中指定的消息,產(chǎn)生的日志具體信息
%n: 輸出一個回車換行符，Windows平臺為"\r\n"，Unix平臺為"\n"輸出日志信息換行，可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如：
1)%20c：指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，默認(rèn)的情況下右對齊。
2)%-20c:指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，"-"號指定左對齊。
3)%.30c:指定輸出category的名稱，最大的寬度是30，如果category的名稱大于30的話，就會將左邊多出的字符截掉，但小于30的話也不會有空格。
4)%20.30c:如果category的名稱小于20就補(bǔ)空格，并且右對齊，如果其名稱長于30字符， 就從左邊交遠(yuǎn)銷出的字符截掉。
· XMLLayout 選項
LocationInfo=true:默認(rèn)值是false,輸出java文件和行號
日志配置文件內(nèi)容范例
log4j.properties
#注意：在屬性配置文件中，屬性值的第一個一定是級別，輸出端可有可無，以逗號分割。（而xml文件格式?jīng)]有這種限制）
log4j.xml
- < xml version="1.0" encoding="UTF-8" >
- <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
- <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="false" threshold="null">
-
-
- <appender class="org.apache.log4j.ConsoleAppender" name="CONSOLE">
- <param name="Target" value="System.out"/>
- <param name="Threshold" value="INFO"/>
- <layout class="org.apache.log4j.PatternLayout">
- <param name="ConversionPattern" value="%d [%p] - %m%n "/>
- </layout>
- <filter class="org.apache.log4j.varia.DenyAllFilter"/>
- <errorHandler class="org.apache.log4j.varia. FallbackErrorHandler"/>
- </appender>
-
- <appender class="org.apache.log4j.FileAppender" name="FILE">
- <param name="File" value="file.log"/>
- <param name="Append" value="false"/>
- <param name="Threshold" value="INFO"/>
- <layout class="org.apache.log4j.PatternLayout">
- <param name="ConversionPattern" value="%d [%p] - %m%n "/>
- </layout>
- </appender>
-
- <appender class="org.apache.log4j.RollingFileAppender" name="ROLLING_FILE">
- <param name="Threshold" value="INFO"/>
- <param name="File" value="rolling.log"/>
- <param name="Append" value="false"/>
- <param name="MaxFileSize" value="10KB"/>
- <param name="MaxBackupIndex" value="1"/>
- <layout class="org.apache.log4j.PatternLayout">
- <param name="ConversionPattern" value="%d [%p] - %m%n "/>
- </layout>
- </appender>
-
- <logger additivity="false" name="com.eos">
- <level value="info"/>
- <appender-ref ref="CONSOLE"/>
- </logger>
-
- <category additivity="true" name="com.eos.log">
- <priority value="warn"/>
- </category>
-
- <root>
- <priority value="info"/>
- <appender-ref ref="CONSOLE"/>
- </root>
- </log4j:configuration>
posted on 2008-05-21 10:35
xzc 閱讀(3997)
評論(1) 編輯 收藏 所屬分類:
Log4j