log4j.properties總結(jié):
一、介紹
Log4j是Apache的一個開放源代碼項(xiàng)目,通過使用Log4j,我們可以控制日志信息輸送的目的地是控制臺、文件、GUI組件、甚至是套接口服務(wù) 器、NT的事件記錄器、UNIX Syslog守護(hù)進(jìn)程等;我們也可以控制每一條日志的輸出格式;通過定義每一條日志信息的級別,我們能夠更加細(xì)致地控制日志的生成過程。
Log4j由三個重要的組件構(gòu)成:日志信息的優(yōu)先級,日志信息的輸出目的地,日志信息的輸出格式。日志信息的優(yōu)先級從高到低有ERROR、WARN、 INFO、DEBUG,分別用來指定這條日志信息的重要程度;日志信息的輸出目的地指定了日志將打印到控制臺還是文件中;而輸出格式則控制了日志信息的顯示內(nèi)容。
二、配置文件
其實(shí)您也可以完全不使用配置文件,而是在代碼中配置Log4j環(huán)境。但是,使用配置文件將使您的應(yīng)用程序更加靈活。
Log4j支持兩種配置文件格式,一種是XML格式的文件,一種是properties格式的文件。下面我們介紹使用properties格式做為配置文件的方法:
示例:
1
2
3
4
|
log4j.rootLogger=INFO, A1 log4j.appender.A1=org.apache.log4j.ConsoleAppender log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.A1.layout.ConversionPattern=%-4r %-5p [%t] %37c %3x - %m%n |
1. 配置根Logger,其語法為:
1
|
log4j.rootLogger = [ level ] , appenderName, appenderName, … |
其中,level 是日志記錄的優(yōu)先級,分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定義的級別。Log4j建議只使用四個級別,優(yōu)先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級別,您可以控制到應(yīng)用程序中相應(yīng)級別的日志信息的開關(guān)。比如在這里定義了INFO級別,則應(yīng)用程序中所有DEBUG級別的日志信息將不被打印出來。
appenderName就是指定日志信息輸出到哪個地方。您可以同時指定多個輸出目的地。
2. 配置日志信息輸出目的地Appender,其語法為:
1
2
3
4
|
log4j.appender.appenderName = fully.qualified.name.of.appender. class log4j.appender.appenderName.option1 = value1 … log4j.appender.appenderName.option = valueN |
其中,Log4j提供的appender有以下幾種:
1
2
3
4
5
|
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ā)送到任意指定的地方) |
(1).ConsoleAppender選項(xiàng)
1
2
3
|
Threshold=WARN:指定日志消息的輸出最低層次。 ImmediateFlush= true :默認(rèn)值是 true ,意謂著所有的消息都會被立即輸出。 Target=System.err:默認(rèn)情況下是:System.out,指定輸出控制臺 |
(2).FileAppender 選項(xiàng)
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認(rèn)值是true,意謂著所有的消息都會被立即輸出。
File=mylog.txt:指定消息輸出到mylog.txt文件。
Append=false:默認(rèn)值是true,即將消息增加到指定文件中,false指將消息覆蓋指定的文件內(nèi)容。
(3).DailyRollingFileAppender 選項(xiàng)
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: 每分鐘
(4).RollingFileAppender 選項(xiàng)
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ù)。
3. 配置日志信息的布局,其語法為:
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)生的時間、線程、類別等等信息)
4、輸出格式設(shè)置
在配置文件中可以通過log4j.appender.A1.layout.ConversionPattern設(shè)置日志輸出格式。
參數(shù):
%p: 輸出日志信息優(yōu)先級,即DEBUG,INFO,WARN,ERROR,F(xiàn)ATAL,
%d: 輸出日志時間點(diǎn)的日期或時間,默認(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)銷出的字符截掉。
三、加載log4j.properties文件
1、spring方式加載,配置與web.xml中:
Spring加載log4j.properties,它提供了一個Log4jConfigListener,本身就能通過web.xml配置從指定位置加載log4j配置文件和log4j的輸出路徑,要注意的是
Log4jConfigListener必須要在Spring的Listener之前。
web.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<!-- 設(shè)置由Sprng載入的Log4j配置文件位置 --> <context-param> <param-name>log4jConfigLocation</param-name> <param-value>WEB-INF/classes/log4j.properties</param-value> </context-param> <!-- Spring刷新Log4j配置文件變動的間隔,單位為毫秒 --> <context-param> <param-name>log4jRefreshInterval</param-name> <param-value> 10000 </param-value> </context-param> <listener> <listener- class >org.springframework.web.util.Log4jConfigListener</listener- class > </listener> |
2、可以通過資源類對資源文件進(jìn)行加載,與使用為一體
1
2
3
4
5
6
7
8
|
public class TestLog4j { public static void main(String[] args) { PropertyConfigurator.configure( " D:/Code/conf/log4j.properties " ); Logger logger = Logger.getLogger(TestLog4j. class ); logger.debug( " debug " ); logger.error( " error " ); } } |
四、在程序中的使用
在程序中使用Log4j之前,首先要將commons-logging.jar和logging-log4j-1.2.9.jar導(dǎo)入到classpath中,并將log4j.properties放于src根目錄中。接下來就可以使用了。
1.得到記錄器
使用Log4j,第一步就是獲取日志記錄器,這個記錄器將負(fù)責(zé)控制日志信息。其語法為:
public static Logger getLogger( String name),
通過指定的名字獲得記錄器,如果必要的話,則為這個名字創(chuàng)建一個新的記錄器。Name一般取本類的名字,比如:
1
|
static Logger logger = Logger.getLogger ( ServerWithLog4j. class .getName () ) ; |
注:推薦使用commons-logging結(jié)合log4j進(jìn)行日志記錄
1
|
private static Log logger = LogFactory.getLog(Yourclass. class ); |
2.插入記錄信息(格式化日志信息)
當(dāng)上兩個必要步驟執(zhí)行完畢,您就可以輕松地使用不同優(yōu)先級別的日志記錄語句插入到您想記錄日志的任何地方,其語法如下:
1
2
3
4
|
Logger.debug ( Object message ) ; Logger.info ( Object message ) ; Logger.warn ( Object message ) ; Logger.error ( Object message ) ; |
例如:
1
2
3
4
5
6
7
8
9
10
11
12
|
import org.apache.log4j.*; public class LogTest ...{ static Logger logger = Logger.getLogger(LogTest. class .getName()); public static void main(String[] args) ...{ //通過PropertyConfigurator加載log4j.properties文件,如果不添加這句話,則有spring加載 PropertyConfigurator.configure ( “.\srclog4j.properties”); logger.debug( "Debug ..." ); logger.info( "Info ..." ); logger.warn( "Warn ..." ); logger.error( "Error ..." ); } } |
總結(jié)
以上所述是小編給大家介紹的log4j.properties配置與加載應(yīng)用,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復(fù)大家的。在此也非常感謝大家對服務(wù)器之家網(wǎng)站的支持!
原文鏈接:http://blog.csdn.net/u010839779/article/details/65442250