?

最后更新于2017年02月09日

一、log4j基本用法

　　首先，配置log4j的jar，maven工程配置以下依賴，非maven工程從maven倉庫下載jar添加到“build path”

1 2 3 4 5

<dependency> ????<groupId>log4j</groupId> ????<artifactId>log4j</artifactId> ????<version>1.2.17</version> </dependency>

　　然后，在src/main/java目錄（包的根目錄即classpath）新建log4j.properties文件

1 2 3 4 5 6 7 8 9

log4j.rootLogger=INFO,console log4j.additivity.org.apache=true #console log4j.appender.console=org.apache.log4j.ConsoleAppender log4j.appender.console.Threshold=INFO log4j.appender.console.ImmediateFlush=true log4j.appender.console.Target=System.out log4j.appender.console.layout=org.apache.log4j.PatternLayout log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

　　最后，新建Main.java文件

1 2 3 4 5 6 7 8 9 10 11 12 13

package?com.xmyself.log4j; import?org.apache.log4j.Logger; public?class?Main { ????public?static?void?main(String[] args) { ????????new?Test().test(); ????} } class?Test { ????final?Logger log = Logger.getLogger(Test.class); ????public?void?test() { ????????log.info("hello this is log4j info log"); ????} }

　　運行main方法，日志信息就出來了

1	2016-12-01 21:23:29 [INFO] hello this is log4j info log

二、log4j.properties路徑

　　log4j.properties要放在哪以及怎樣配置才能被解析呢？不同工程類型配置方式不同

1、普通java或spring工程

　　這是最常見的java工程類型，寫demo用的多，把log4j.properties放在src/main/java目錄（包的根目錄）就行了

2、spring mvc工程

　　web工程里用spring mvc構(gòu)建的比較多了，把log4j.properties放在src/main/resources的conf目錄（web工程配置文件通常在resources或WEB-INF目錄），編輯web.xml，添加

1 2 3 4 5 6 7

<context-param> ????<param-name>log4jConfigLocation</param-name> ????<param-value>classpath:/conf/log4j.properties</param-value> </context-param> <listener> ????<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class> </listener>

3、普通web工程

　　沒有了spring提供的listener加載log4j.properties，我們要怎么加載這個文件呢？同樣，把log4j.properties放在src/main/resources的conf目錄，用servlet加載

1 2 3 4 5 6 7 8 9 10 11 12

public?class?Log4jServlet?extends?HttpServlet { ????private?static?final?long?serialVersionUID = 1L; ?? ????public?void?init(ServletConfig config)?throws?ServletException { ????????String prefix =?this.getClass().getClassLoader().getResource("/").getPath(); ????????String path = config.getInitParameter("log4j-path"); ????????PropertyConfigurator.configure(prefix + path); ????} ????public?void?doGet(HttpServletRequest req, HttpServletResponse res)?throws?IOException, ServletException {} ????public?void?doPost(HttpServletRequest req, HttpServletResponse res)?throws?IOException, ServletException {} ????public?void?destroy() {} }

　　編輯web.xml，添加

1 2 3 4 5 6 7 8 9

<servlet> ????<servlet-name>log4j</servlet-name> ????<servlet-class>com.xmyself.log4j.Log4jServlet</servlet-class> ????<init-param> ????????<param-name>log4j-path</param-name> ????????<param-value>conf/log4j.properties</param-value> ????</init-param> ????<load-on-startup>1</load-on-startup> </servlet>

　　看著是不是和spring mvc的很像，甚至你也想到了，普通java工程沒有指定log4j.properties的路徑，那說明log4j的jar包一定有一個默認(rèn)的路徑。另外，建議，log4j的配置放在第一個，因為后續(xù)加載其他組件就要開始使用日志記錄了

　　現(xiàn)在，你可以在多種類型的java工程中打出日志了，但都是控制臺的日志，輸出內(nèi)容也很有限，下面我們就來詳細(xì)介紹log4j.properties內(nèi)容怎么配置

三、log4j.properties內(nèi)容

　　接下來介紹的內(nèi)容看起來獨立，其實相互關(guān)聯(lián)，并且很有規(guī)律，我們要輸出日志，首先得有日志對象（logger），那這些日志對象把日志輸出到哪里呢，控制臺還是文件，這就要設(shè)置輸出位置（appender），輸出的格式與內(nèi)容又是什么樣的呢，這就要設(shè)置輸出樣式（layout），這些設(shè)置完，log4j的配置也就完了

　　在此之前，先介紹下log4j日志等級的概念，日志等級就是日志的重要程度，log4j日志分為7個等級：ALL、DEBUG、INFO、WARN、ERROR、FATAL、OFF，從左到右等級由低到高，分等級是為了設(shè)置日志輸出的門檻，只有等級等于或高于這個門檻的日志才有機會輸出

1、logger

　　日志實例，就是代碼里實例化的Logger對象

1 2	log4j.rootLogger=LEVEL,appenderName1,appenderName2,... log4j.additivity.org.apache=false：表示不會在父logger的appender里輸出，默認(rèn)true

　　這是全局logger的配置，LEVEL用來設(shè)定日志等級，appenderName定義日志輸出器，示例中的“console”就是一個日志輸出器

　　下面給出一個更清晰的例子，配置“com.demo.test”包下所有類中實例化的Logger對象

1 2	log4j.logger.com.demo.test=DEBUG,test log4j.additivity.com.demo.test=false

2、appender

　　日志輸出器，指定logger的輸出位置

1	log4j.appender.appenderName=className

　　appender有5種選擇

1 2 3 4 5

org.apache.log4j.ConsoleAppender（控制臺） org.apache.log4j.FileAppender（文件） org.apache.log4j.DailyRollingFileAppender（每天產(chǎn)生一個日志文件） org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產(chǎn)生一個新的文件） org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）

　　每種appender都有若干配置項，下面逐一介紹

　　ConsoleAppender（常用）

1 2 3

Threshold=WARN：指定日志信息的最低輸出級別，默認(rèn)DEBUG ImmediateFlush=true：表示所有消息都會被立即輸出，設(shè)為false則不輸出，默認(rèn)值是true Target=System.err：默認(rèn)值是System.out

　　FileAppender

1 2 3 4

Threshold=WARN：指定日志信息的最低輸出級別，默認(rèn)DEBUG ImmediateFlush=true：表示所有消息都會被立即輸出，設(shè)為false則不輸出，默認(rèn)true Append=false：true表示消息增加到指定文件中，false則將消息覆蓋指定的文件內(nèi)容，默認(rèn)true File=D:/logs/logging.log4j：指定消息輸出到logging.log4j文件

　　DailyRollingFileAppender（常用）

1 2 3 4 5 6 7 8 9 10 11 12

Threshold=WARN：指定日志信息的最低輸出級別，默認(rèn)DEBUG ImmediateFlush=true：表示所有消息都會被立即輸出，設(shè)為false則不輸出，默認(rèn)true Append=false：true表示消息增加到指定文件中，false則將消息覆蓋指定的文件內(nèi)容，默認(rèn)true File=D:/logs/logging.log4j：指定當(dāng)前消息輸出到logging.log4j文件 DatePattern='.'yyyy-MM：每月滾動一次日志文件，即每月產(chǎn)生一個新的日志文件。當(dāng)前月的日志文件名為logging.log4j，前一個月的日志文件名為logging.log4j.yyyy-MM 另外，也可以指定按周、天、時、分等來滾動日志文件，對應(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：每分鐘

　　RollingFileAppender

1 2 3 4 5 6

Threshold=WARN：指定日志信息的最低輸出級別，默認(rèn)DEBUG ImmediateFlush=true：表示所有消息都會被立即輸出，設(shè)為false則不輸出，默認(rèn)true Append=false：true表示消息增加到指定文件中，false則將消息覆蓋指定的文件內(nèi)容，默認(rèn)true File=D:/logs/logging.log4j：指定消息輸出到logging.log4j文件 MaxFileSize=100KB：后綴可以是KB,MB或者GB。在日志文件到達該大小時，將會自動滾動，即將原來的內(nèi)容移到logging.log4j.1文件 MaxBackupIndex=2：指定可以產(chǎn)生的滾動文件的最大數(shù)，例如，設(shè)為2則可以產(chǎn)生logging.log4j.1，logging.log4j.2兩個滾動文件和一個logging.log4j文件

3、layout

　　指定logger輸出內(nèi)容及格式

1	log4j.appender.appenderName.layout=className

　　layout有4種選擇

1 2 3 4

org.apache.log4j.HTMLLayout（以HTML表格形式布局） org.apache.log4j.PatternLayout（可以靈活地指定布局模式） org.apache.log4j.SimpleLayout（包含日志信息的級別和信息字符串） org.apache.log4j.TTCCLayout（包含日志產(chǎn)生的時間、線程、類別等信息）

　　layout也有配置項，下面具體介紹

　　HTMLLayout

1 2	LocationInfo=true：輸出java文件名稱和行號，默認(rèn)false Title=My Logging： 默認(rèn)值是Log4J Log Messages

　　PatternLayout（最常用的配置）

1	ConversionPattern=%m%n：設(shè)定以怎樣的格式顯示消息

　　設(shè)置格式的參數(shù)說明如下

1 2 3 4 5 6 7 8 9 10 11 12 13

%p：輸出日志信息的優(yōu)先級，即DEBUG，INFO，WARN，ERROR，FATAL %d：輸出日志時間點的日期或時間，默認(rèn)格式為ISO8601，可以指定格式如：%d{yyyy/MM/dd HH:mm:ss,SSS} %r：輸出自應(yīng)用程序啟動到輸出該log信息耗費的毫秒數(shù) %t：輸出產(chǎn)生該日志事件的線程名 %l：輸出日志事件的發(fā)生位置，相當(dāng)于%c.%M(%F:%L)的組合，包括類全名、方法、文件名以及在代碼中的行數(shù) %c：輸出日志信息所屬的類目，通常就是類全名 %M：輸出產(chǎn)生日志信息的方法名 %F：輸出日志消息產(chǎn)生時所在的文件名 %L：輸出代碼中的行號 %m：輸出代碼中指定的具體日志信息 %n：輸出一個回車換行符，Windows平臺為"rn"，Unix平臺為"n" %x：輸出和當(dāng)前線程相關(guān)聯(lián)的NDC(嵌套診斷環(huán)境) %%：輸出一個"%"字符

四、log4j完整配置示例

　　介紹完了log4j.properties內(nèi)容，我們來配置一些常用的日志輸出吧

1 2	log4j.rootLogger=DEBUG,console,dailyFile,rollingFile,logFile log4j.additivity.org.apache=true

　　控制臺console日志輸出器

1 2 3 4 5 6 7

# 控制臺(console) log4j.appender.console=org.apache.log4j.ConsoleAppender log4j.appender.console.Threshold=DEBUG log4j.appender.console.ImmediateFlush=true log4j.appender.console.Target=System.err log4j.appender.console.layout=org.apache.log4j.PatternLayout log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

　　文件logFile日志輸出器

1 2 3 4 5 6 7 8

# 日志文件(logFile) log4j.appender.logFile=org.apache.log4j.FileAppender log4j.appender.logFile.Threshold=DEBUG log4j.appender.logFile.ImmediateFlush=true log4j.appender.logFile.Append=true log4j.appender.logFile.File=D:/logs/log.log4j log4j.appender.logFile.layout=org.apache.log4j.PatternLayout log4j.appender.logFile.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

　　滾動文件rollingFile日志輸出器

1 2 3 4 5 6 7 8 9 10

# 滾動文件(rollingFile) log4j.appender.rollingFile=org.apache.log4j.RollingFileAppender log4j.appender.rollingFile.Threshold=DEBUG log4j.appender.rollingFile.ImmediateFlush=true log4j.appender.rollingFile.Append=true log4j.appender.rollingFile.File=D:/logs/log.log4j log4j.appender.rollingFile.MaxFileSize=200KB log4j.appender.rollingFile.MaxBackupIndex=50 log4j.appender.rollingFile.layout=org.apache.log4j.PatternLayout log4j.appender.rollingFile.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

　　定期滾動文件dailyFile日志輸出器

1 2 3 4 5 6 7 8 9

# 定期滾動日志文件(dailyFile) log4j.appender.dailyFile=org.apache.log4j.DailyRollingFileAppender log4j.appender.dailyFile.Threshold=DEBUG log4j.appender.dailyFile.ImmediateFlush=true log4j.appender.dailyFile.Append=true log4j.appender.dailyFile.File=D:/logs/log.log4j log4j.appender.dailyFile.DatePattern='.'yyyy-MM-dd log4j.appender.dailyFile.layout=org.apache.log4j.PatternLayout log4j.appender.dailyFile.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

五、log4j局部日志配置

　　以上介紹的配置都是全局的，整個工程的代碼使用同一套配置，意味著所有的日志都輸出在了相同的地方，你無法直接了當(dāng)?shù)娜タ磾?shù)據(jù)庫訪問日志、用戶登錄日志、操作日志，它們都混在一起，因此，需要為包甚至是類配置單獨的日志輸出，下面給出一個例子，為“com.demo.test”包指定日志輸出器“test”，“com.demo.test”包下所有類的日志都將輸出到/log/test.log文件

1 2 3 4 5

log4j.logger.com.demo.test=DEBUG,test log4j.appender.test=org.apache.log4j.FileAppender log4j.appender.test.File=/log/test.log log4j.appender.test.layout=org.apache.log4j.PatternLayout log4j.appender.test.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

　　也可以讓同一個類輸出不同的日志，為達到這個目的，需要在這個類中實例化兩個logger

1 2	private?static?Log logger1 = LogFactory.getLog("myTest1"); private?static?Log logger2 = LogFactory.getLog("myTest2");

　　然后分別配置

1 2 3 4 5 6 7 8 9 10 11 12

log4j.logger.myTest1=?DEBUG,test1 log4j.additivity.myTest1=false log4j.appender.test1=org.apache.log4j.FileAppender log4j.appender.test1.File=/log/test1.log log4j.appender.test1.layout=org.apache.log4j.PatternLayout log4j.appender.test1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n ?? log4j.logger.myTest2=DEBUG,test2 log4j.appender.test2=org.apache.log4j.FileAppender log4j.appender.test2.File=/log/test2.log log4j.appender.test2.layout=org.apache.log4j.PatternLayout log4j.appender.test2.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%p]?%m%n

六、slf4j與log4j聯(lián)合使用

　　slf4j是什么？slf4j只是定義了一組日志接口，但并未提供任何實現(xiàn)，既然這樣，為什么要用slf4j呢？log4j不是已經(jīng)滿足要求了嗎？

　　是的，log4j滿足了要求，但是，日志框架并不只有l(wèi)og4j一個，你喜歡用log4j，有的人可能更喜歡logback，有的人甚至用jdk自帶的日志框架，這種情況下，如果你要依賴別人的jar，整個系統(tǒng)就用了兩個日志框架，如果你依賴10個jar，每個jar用的日志框架都不同，豈不是一個工程用了10個日志框架，那就亂了！

　　如果你的代碼使用slf4j的接口，具體日志實現(xiàn)框架你喜歡用log4j，其他人的代碼也用slf4j的接口，具體實現(xiàn)未知，那你依賴其他人jar包時，整個工程就只會用到log4j日志框架，這是一種典型的門面模式應(yīng)用，與jvm思想相同，我們面向slf4j寫日志代碼，slf4j處理具體日志實現(xiàn)框架之間的差異，正如我們面向jvm寫java代碼，jvm處理操作系統(tǒng)之間的差異，結(jié)果就是，一處編寫，到處運行。況且，現(xiàn)在越來越多的開源工具都在用slf4j了

　　那么，怎么用slf4j呢？

　　首先，得弄到slf4j的jar包，maven依賴如下，log4j配置過程完全不變

1 2 3 4 5

<dependency> ????<groupId>org.slf4j</groupId> ????<artifactId>slf4j-api</artifactId> ????<version>1.7.21</version> </dependency>

　　然后，弄到slf4j與log4j的關(guān)聯(lián)jar包，通過這個東西，將對slf4j接口的調(diào)用轉(zhuǎn)換為對log4j的調(diào)用，不同的日志實現(xiàn)框架，這個轉(zhuǎn)換工具不同

1 2 3 4 5

<dependency> ????<groupId>org.slf4j</groupId> ????<artifactId>slf4j-log4j12</artifactId> ????<version>1.7.21</version> </dependency>

　　當(dāng)然了，slf4j-log4j12這個包肯定依賴了slf4j和log4j，所以使用slf4j+log4j的組合只要配置上面這一個依賴就夠了

　　最后，代碼里聲明logger要改一下，原來使用log4j是這樣的

1 2 3 4 5 6 7

import?org.apache.log4j.Logger; class?Test { ????final?Logger log = Logger.getLogger(Test.class); ????public?void?test() { ????????log.info("hello this is log4j info log"); ????} }

　　現(xiàn)在要改成這樣

1 2 3 4 5 6 7 8

import?org.slf4j.Logger; import?org.slf4j.LoggerFactory; class?Test { ????Logger log = LoggerFactory.getLogger(Test.class); ????public?void?test() { ????????log.info("hello, my name is {}",?"chengyi"); ????} }

　　依賴的Logger變了，而且，slf4j的api還能使用占位符，很方便

（完）

作者：凌承一?
出處：http://www.cnblogs.com/ywlaker/?
聲明：本文版權(quán)歸作者和博客園共有，歡迎轉(zhuǎn)載，但轉(zhuǎn)載必須保留此段聲明，并在文章頁面明顯位置給出原文鏈接，否則作者將保留追究法律責(zé)任的權(quán)利。

總結(jié)

以上是生活随笔為你收集整理的java日志框架log4j详细配置及与slf4j联合使用教程的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。