一、配置文件說明:
1、log4j.rootLogger=INFO, stdout, R
將等級爲INFO的日誌信息使用stdout和R進行輸出,這裏可以自己命名;
等級可分爲OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL,OFF是關閉,不輸出任何信息,其他級別按這個順序依次降低,如果指定一個級別,如INFO,則比該級別高的信息都會輸出,此時會輸出FATAL、ERROR、WARN、INFO級別的信息。
2、log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.option1=value1
定義stdout的輸出端類型,以及屬性選項配置,可以有下面幾種類型:
org.apache.log4j.ConsoleAppender(輸出在控制檯)
org.apache.log4j.FileAppender(輸出到文件)
org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌文件)
org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生一個新的文件),可通過log4j.appender.R.MaxFileSize=100KB設置文件大小,還可通過log4j.appender.R.MaxBackupIndex=1設置爲保存一個備份文件
org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)
輸出端共同選項:
Threshold=WARN:指定日誌消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂着所有的消息都會被立即輸出。
ConsoleAppender選項:
Target=System.err:默認情況下是:System.out,指定輸出控制檯
文件輸出端共同選項:
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內容。
DailyRollingFileAppender 選項:
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: 每分鐘
RollingFileAppender 選項:
MaxFileSize=100KB: 後綴可以是KB, MB 或者是 GB. 在日誌文件到達該大小時,將會自動滾動,即將原來的內容移到mylog.log.1文件。
MaxBackupIndex=2:指定可以產生的滾動文件的最大數。
3、log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
定義stdout的輸出端的layout是類型,可以有下面幾種類型:
org.apache.log4j.HTMLLayout(以HTML表格形式佈局),
org.apache.log4j.PatternLayout(可以靈活地指定佈局模式),
org.apache.log4j.SimpleLayout(包含日誌信息的級別和信息字符串),
org.apache.log4j.TTCCLayout(包含日誌產生的時間、線程、類別等等信息)
4、log4j.appender.stdout.layout.ConversionPattern= [APPName] %p [%t] %C.%M(%L) | %m%n
如果使用pattern佈局就要指定的打印信息的具體格式ConversionPattern,具體參數:
%m 輸出代碼中指定的消息
%p 輸出優先級,即DEBUG,INFO,WARN,ERROR,FATAL
%r 輸出自應用啓動到輸出該log信息耗費的毫秒數
%c 輸出所屬的類目,通常就是所在類的全名
%t 輸出產生該日誌事件的線程名
%n 輸出一個回車換行符,Windows平臺爲"rn”,Unix平臺爲"n”
%d 輸出日誌時間點的日期或時間,默認格式爲ISO8601,也可以在其後指定格式,比如:%d{yyyy MM dd HH:mm:ss,SSS},輸出類似:2002年10月18日 22:10:28,921
%l 輸出日誌事件的發生位置,包括類目名、發生的線程,以及在代碼中的行數。
%x: 輸出和當前線程相關聯的NDC(嵌套診斷環境),尤其用到像java servlets這樣的多客戶多線程的應用中。
%%: 輸出一個”%”字符
%F: 輸出日誌消息產生時所在的文件名稱
%M: 輸出執行方法
%L: 輸出代碼中的行號
可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如:
1) c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,默認的情況下右對齊。
2)%-20c:指定輸出category的名稱,最小的寬度是20,如果category的名稱小於20的話,”-”號指定左對齊。
3)%.30c:指定輸出category的名稱,最大的寬度是30,如果category的名稱大於30的話,就會將左邊多出的字符截掉,但小於30的話也不會有空格。
4) .30c:如果category的名稱小於20就補空格,並且右對齊,如果其名稱長於30字符,就從左邊交遠銷出的字符截掉。
[APPName]是log信息的開頭,可以爲任意字符,一般爲項目簡稱。
5、log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
6、log4j.appender.R.File=D:\\logs\\APPName.log
定義R的輸出端的文件名D:\\logs\\APPName.log,該名稱可以自行修改。
7、log4j.appender.R.layout=org.apache.log4j.PatternLayout
8、log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n
9、log4j.logger.com.johnny=DEBUG
自定義各個包中日誌級別,指定com.johnny包下的所有類的等級爲DEBUG。
二、加載自己的配置文件
log4j默認加載類路徑下的log4j.properties文件,如果自定義其他名稱的properties文件的時候,就需要使用PropertyConfigurator.configure(“FilePath”)來加載配置文件,這裏要注意一下配置文件的路徑:
針對java項目:
1、絕對路徑 -- F:\\test\\log4jSelf.properties;
這個就不用多說了,如果不是web項目的話,寫絕對路徑那就是硬盤上的全路徑了
2、相對路徑 -- src/youFileName.properties
log4j默認的當前路徑工程下面,即跟src同級目錄,瞭解這點相信相對路徑大家都手到擒來了,或者類加載器獲得路徑也可以;
針對web項目:
getRealPath獲得路徑加上文件名