log4j的好處在於: 當你在開發程序的時候, 調試(debugging)和日誌(logging)都是非常重要的工作, 但是, 現在有太多的 logging API 問世, 因爲他們都不錯, 很難做一個抉擇. 國外 java 論壇對於這些logging 方式也是有一番討論. 另,mvnforum裏面的commons-logging.properties寫法: ==================================================================== LOG4J的配置之簡單使它遍及於越來越多的應用中了:Log4J配置文件實現了輸出到控制檯、文件、回滾文件、發送日誌郵件、輸出到數據庫日誌表、自定義標籤等全套功能。擇其一二使用就夠用了,
|
posted on 2008-03-11 11:48 蘆葦 閱讀(1733) 評論(3) 編輯 收藏 所屬分類: JAVA 、其他
# re:log4j和commons.logging日誌記錄的使用方法 2008-03-11 14:08 蘆葦
模式字符串簡介:
%c:Category名稱。還可以使用%c{n}的格式輸出Category的部分名稱,其中n爲正整數,輸出時會從Category名稱的右側起查n個".",然後截取第n個"."右側的部分輸出,例如Category的名稱爲"x.y.z",指定格式爲"%c{2}",則輸出"y.z"。
%C:輸出信息時Category所在類的名稱,也可以使用%C{n}的格式輸出。
%d:輸出信息的時間,也可以用%d{FormatString}的格式輸出,其中FormatString的值請參考TTCCLayout的setDateFormat方法,但NULL和RELATIVE在%d中無法使用。
%F:輸出信息時Category所在類文件的名稱。
%l:輸出信息時Category所在的位置,使用"%C.%M(%F:%L)"可以產生同樣的效果。
%L:輸出信息時Category在類文件中的行號。
%m:信息本身。
%M:輸出信息時Category所在的方法。
%n:換行符,可以理解成回車。
%p:日誌級別。
%r:輸出信息所用的時間,以毫秒爲單位。
%t:當前線程。
%x:輸出和當前線程相關的NDC信息。
%X:輸出與當前現成相關的MDC信息。
%%:輸出%。
此外,還可以在%與模式字符之間加上修飾符來設置輸出時的最小寬度、最大寬度及文本對齊方式,例如:
%30d{DATE}:按當前所在地區顯示日期和時間,並指定最小寬度爲30,當輸出信息少於30個字符時會補以空格並右對齊。
%-30d{DATE}:也是按當前所在地區顯示日期和時間,指定最小寬度爲30,並在字符少於30時補以空格,但由於使用了"-",因此對齊方式爲左對齊,與默認情況一樣。
%.40d{DATE}:也是按當前所在地區顯示日期和時間,但指定最大寬度爲40,當輸出信息多於40個字符時會將左邊多出的字符截掉。此外,最大寬度只支持默認的左對齊方式,而不支持右對齊。
%30.40d{DATE}:如果輸出信息少於30個字符就補空格並右對齊,如果多於40個字符,就將左邊多出的字符截掉。
%-30.40d{DATE}:如果輸出信息少於30個字符就補空格並左對齊,如果多於40個字符,就將左邊多出的字符截掉。
回覆
更多評論
# re:log4j和commons.logging日誌記錄的使用方法 2008-03-11 14:08 蘆葦
一最好與commons-logging一起用,why?
1.標準接口,即使將來脫離了log4j也一樣用
2.簡化了編碼,減少耦合度:不需在代碼中指定log4j配製文件位置,代碼中不需要引用log4j的包
3.基本所有框架都是這麼用的。。。。。。(我相信羣衆)
附加提供一下commons-logging尋找配置文件的順序(從別人那抄的)
1) 首先在classpath下尋找自己的配置文件commons-logging.properties,如果找到,則使用其中定義的Log實現類;
2) 如果找不到commons-logging.properties文件,則在查找是否已定義系統環境變量org.apache.commons.logging.Log,找到則使用其定義的Log實現類;
3) 否則,查看classpath中是否有Log4j的包,如果發現,則自動使用Log4j作爲日誌實現類;
4) 否則,使用JDK自身的日誌實現類(JDK1.4以後纔有日誌實現類);
5) 否則,使用commons-logging自己提供的一個簡單的日誌實現類SimpleLog;
二具體實現
1.把commons-logging的jar加到classpath中
2.把log4j的jar加到classpath中
3.在classpath的根目錄下,建立log4j.properties(必須是這個地方,必須叫這個名,纔不用特殊配置),可以直接複製後邊的模板
4.在需要log的類中:
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
private static Log log = LogFactory.getLog(xxxx.class);
爲什麼要使用static?因爲避免產生多個實例
爲什麼不使用this.class?因爲是static不能用this(我經常犯這個錯誤。。。)
爲什麼不使new XXXX().getClass()?因爲。。。。你猜呢?
5.根據實際需要log.debug()、log.info()、log.warn()、log.error()、log.fatal()
就可以輸出不同等級的log
三 log的等級
1.爲什麼需要等級?寫代碼的時候可能需要很多調試信息,運行的時候可能需要顯示提示信息,如果在服務器上發生嚴重錯誤的時候,可能需要給管理員發郵件。這種:調試,提示,錯誤就是等級。
2.都有什麼等級?調試(DEBUG)<信息(INFO)<警告(WARN)<錯誤(ERROR)<致命錯誤(FATAL)
3.怎麼用? log.debug() log.info() log.warn() log.error()log.fatal()依次對應上邊的等級
四 log4j的配製
1.基本參數解釋:
⑴全局配製
log4j.rootLogger = [ level ] , appenderName, appenderName,..........appenderName
★log4j.rootLogger的意思可以理解爲:根log或者所有的log
★level就是輸出級別,只能設置一個值。
·關於等級,前邊已經說過了有5種,他們之間的關係可以理解爲:
調試(DEBUG):包含調試(DEBUG)、信息(INFO)、警告(WARN)、錯誤(ERROR)、致命錯誤(FATAL)
信息(INFO):包含信息(INFO)、警告(WARN)、錯誤(ERROR)、致命錯誤(FATAL)
警告(WARN):包含警告(WARN)、錯誤(ERROR)、致命錯誤(FATAL)
錯誤(ERROR):包含錯誤(ERROR)、致命錯誤(FATAL)
致命錯誤(FATAL):只有他自己
這樣,如果log4j.rootLogger = INFO,那麼 INFO,WARN,ERROR,FATAL就全部會被輸出
如果log4j.rootLogger = ERROR,那麼ERROR,FATAL就全部會被輸出
★appenderName就是記錄的目標,目標可以多個,中間用『,』分割,appenderName是自己定義的,換句話說,名字是隨便起的,起了名之後,就需要在下邊設定具體配製
總結一下這部分,比如說有這麼一句log4j.rootLogger = INFO, F1,F2那麼就以爲着要將所有INFO,WARN,ERROR,FATAL的log全部輸出到F1,F2上。F1,F2是什麼?往下看。。。。
⑵具體配製
log4j.appender.F1=org.apache.log4j.ConsoleAppender
log4j.appender.F1.layout=org.apache.log4j.PatternLayout
log4j.appender.F1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p]%m%n
★log4j.appender.F1=org.apache.log4j.ConsoleAppender的意思就是:將F1設置爲控制檯輸出
·還可以設置成什麼?
org.apache.log4j.ConsoleAppender(控制檯),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌文件),
org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件),
org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)
★log4j.appender.F1.layout=org.apache.log4j.PatternLayout的意思就是:將F1的輸出佈局設置爲自定義輸出佈局。
·還可以設置成什麼?
org.apache.log4j.HTMLLayout(以HTML表格形式佈局)
org.apache.log4j.xml.XMLLayout(以XML形式佈局)
org.apache.log4j.PatternLayout(可以靈活地指定佈局模式),
org.apache.log4j.SimpleLayout(包含日誌信息的級別和信息字符串),
org.apache.log4j.TTCCLayout(包含日誌產生的時間、線程、類別等等信息)
★log4j.appender.F1.layout.ConversionPattern=%d{yyyy-MM-ddHH:mm:ss,SSS} [%c]-[%p] %m%n既然上邊定義的是自定義輸出佈局,那麼就要定義一下具體輸出什麼樣了~~上邊的%c
%p %m 等以%開頭的都是模式字符串,除了模式字符串外[]-空格等這些字符會按照原樣顯示。
·模式字符串解釋:
%m:消息本身
%p:消息的級別INFO,WARN,ERROR。。。
%r:從程序開始執行到當前日誌產生時的時間間隔(微秒)
%c:輸出當前日誌動作所在的category名稱。例如:如果category名稱是"a.b.c","%c{2}"將會輸出"b.c".
{2}意謂着輸出“以點分隔開的category名稱的後兩個組件”,如果
{n}沒有,將會輸出整個category名稱.
%t:輸出當前線程的名稱
%x:輸出和當前線程相關聯的NDC,尤其用到像java servlets這樣的多客戶多線程的應用中。
%n:輸出平臺相關的換行符。
%%:輸出一個"%"字符
%d:輸出日誌產生時候的日期,當然可以對日期的格式進行定製。例如:%d{HH:mm:ss,SSSS}或者是%d{dd MMM yyyy HH:mm:ss,SSSS},如果沒有指定後面的格式,將會輸出ISO8601的格式。
%l:輸出位置信息,相當於%C.%M(%F:%L)的組合。
%C:輸出日誌消息產生時所在的類名,如果類名是“test.page.Class1”%C{1}表示輸出類名"Class1",%C{2}輸出"page.Class1",而%C則輸出"test.page.Class1"。
%M:輸出日誌消息產生時的方法名稱
%F:輸出日誌消息產生時所在的文件名稱
%L:輸出代碼中的行號
·可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如:
1)%20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,默認的情況下右對齊。
2)%-20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,"-"號指定左對齊。
3)%.30c:指定輸出category的名稱,最大的寬度是30,如果category的名稱大於30的話,就會將左邊多出的字符截掉,但小於30的話也不會有空格。
4)%20.30c:如果category的名稱小於20就補空格,並且右對齊,如果其名稱長於30字符,就從左邊交遠銷出的字符截掉。
總結一下,現在來我們所配製的F1的全部內容
·我們把它配製成了屏幕輸出
·輸出的佈局爲:自定義佈局
·我們又定義了自定義佈局的格式:日期時間(格式爲:yyyy-MM-dd HH:mm:ss,SSS)[產生該日誌的包名類名方法名]
[等級]
信息+回車
如果想配製F2爲每天產生一個日誌文件,並且保存爲xml,就這麼寫:
log4j.appender.F2=org.apache.log4j.DailyRollingFileAppender
log4j.appender.F2.layout=org.apache.log4j.xml.XMLLayout
這樣就可以了嗎?當然不是,既然保存爲文件。。至少要指定一個文件名吧
log4j.appender.F2.File=c:/logs/log.xml
可以了嗎?可以運行了。。。但是。。既然每天都產生一個文件,那麼前一天的怎麼辦呢?
log4j.appender.F2.DatePattern=yyyyMMdd'.xml.back'
這樣log4j會在第一次產生今天的log的同時,將昨天的log備份爲
log文件名.擴展名yyyyMMdd.xml.back。對應我們這個文件,今天的log到明天有新log產生的時候,就會變爲log.xml20070420.xml.back
這樣的參數到底有多少?常用的有:
★ConsoleAppender選項
·Threshold=WARN:指定日誌消息的輸出最低層次。
·ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
·Target=System.err:默認情況下是:System.out,指定輸出控制檯
★FileAppender
選項
·Threshold=WARN:指定日誌消息的輸出最低層次。
·ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
·File=mylog.txt:指定消息輸出到mylog.txt文件。
·Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
★RollingFileAppender選項
·Threshold=WARN:指定日誌消息的輸出最低層次。
·ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
·File=mylog.txt:指定消息輸出到mylog.txt文件。
·Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
·MaxFileSize=100KB: 後綴可以是KB, MB
或者是 GB.
在日誌文件到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1文件。
·MaxBackupIndex=2:指定可以產生的滾動文件的最大數。
★DailyRollingFileAppender選項
·Threshold=WARN:指定日誌消息的輸出最低層次。
·ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
·File=mylog.txt:指定消息輸出到mylog.txt文件。
·Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
·DatePattern='.'yyyy-ww:每週滾動一次文件,即每週產生一個新的文件。當然也可以指定按月、周、天、時和分。即對應的格式如下:
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: 每分鐘
★PatternLayout
選項
·ConversionPattern=%m%n :指定怎樣格式化指定的消息。
★HTMLLayout
選項
·LocationInfo=true:默認值是false,輸出java文件名稱和行號
·Title=my app file: 默認值是 Log4JLog Messages.
★XMLLayout
選項
·LocationInfo=true:默認值是false,輸出java文件和行號
現在來看一下我們完整的第一個配製文件:
========================================================================================
log4j.rootLogger = INFO,F1,F2
log4j.appender.F1=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.F1.Target=System.out
log4j.appender.F1.layout=org.apache.log4j.PatternLayout
log4j.appender.F1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p]%m%n
log4j.appender.F2=org.apache.log4j.DailyRollingFileAppender
log4j.appender.F2.File=c:/logs/log.xml
log4j.appender.F2.DatePattern=yyyyMMdd-HH'.xml.back'
log4j.appender.F2.layout=org.apache.log4j.xml.XMLLayout
========================================================================================
編段代碼看看效果
========================================================================================
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class Main{
private static Log log = LogFactory.getLog(Main.class);
public static void main(String[] args) throws Exception{
log.info("info");
log.debug("debug");
log.warn("warn");
log.error("error");
}
}
========================================================================================
運行效果
========================================================================================
2007-04-20 12:36:22,531 [cn.yyun.test.Main]-[INFO] info
2007-04-20 12:36:22,531 [cn.yyun.test.Main]-[WARN] warn
2007-04-20 12:36:22,531 [cn.yyun.test.Main]-[ERROR] error
========================================================================================
並且在c:/logs/下有log.xml生成,裏邊的內容爲:
========================================================================================
<log4j:event logger="cn.yyun.test.Main" timestamp="1177043782531"level="INFO" thread="main">
<log4j:message><![CDATA[info]]></log4j:message>
</log4j:event>
<log4j:event logger="cn.yyun.test.Main" timestamp="1177043782531"level="WARN" thread="main">
<log4j:message><![CDATA[warn]]></log4j:message>
</log4j:event>
<log4j:event logger="cn.yyun.test.Main" timestamp="1177043782531"level="ERROR" thread="main">
<log4j:message><![CDATA[error]]></log4j:message>
</log4j:event>
========================================================================================
仔細看一下會發現,雖然我們在代碼裏寫了log.debug("debug")但是debug並沒有出現在log中,這是因爲我們配置文件中,定義了log的等級爲INFO,debug的等級小於info,所以不會顯示,而warn,error的大於info,所以也會被顯示出來
2.根據package生成不同的log文件
⑴配置
log4j.logger.cn.yyun.test.abc=INFO,abc2,abc1
log4j.appender.abc2=org.apache.log4j.ConsoleAppender
log4j.appender.abc2.layout=org.apache.log4j.PatternLayout
log4j.appender.abc2.layout.ConversionPattern=abc:[%p] %m%n
log4j.appender.abc1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.abc1.File=C:/logs/abc.log
log4j.appender.abc1.DatePattern='.'yyyyMMdd
log4j.appender.abc1.layout=org.apache.log4j.PatternLayout
log4j.appender.abc1.layout.ConversionPattern=%d %r [%t] %5p - %m%n
log4j.logger.cn.yyun.test.def=INFO,def
log4j.appender.def=org.apache.log4j.ConsoleAppender
log4j.appender.def.layout=org.apache.log4j.PatternLayout
log4j.appender.def.layout.ConversionPattern=def: [%p] %m%n
把logger.cn.yyun.test.abc換成需要的package就可以了(整個log4j配製文件中只有這些就可以了)。但是這樣會有另一個問題,如果cn.yyun.test.Main這個類中,如果有log操作,會報告:log4j:WARN
No appenders could be found for logger (cn.yyun.test.Main).所以要加上log4j.rootCategory=INFO,F1
這樣所有的log都會被紀錄了。。但是這樣又做之後:cn.yyun.test.def裏的log,會同時出現在def和F1中,cn.yyun.test.abc裏的log,會同時出現在abc1,abc2和F1中。。。。。所以定義的時候一定要規劃好。
⑵制定package的log等級
log4j.logger.org.hibernate=DEBUG