天天看點

log4j輸出多個自定義檔案

log4j的強大功能無可置疑,但實際應用中免不了遇到某個功能需要輸出獨立的日志檔案的情況,怎樣才能把所需的内容從原有日志中分離,形成單獨的日志檔案呢?其實隻要在現有的log4j基礎上稍加配置即可輕松實作這一功能。

  先看一個常見的log4j.properties檔案,它是在控制台和myweb.log檔案中記錄日志:

log4j.rootLogger=DEBUG, stdout, logfile

log4j.category.org.springframework=ERROR

log4j.category.org.apache=INFO

log4j.appender.stdout=org.apache.log4j.ConsoleAppender

log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m%n

log4j.appender.logfile=org.apache.log4j.RollingFileAppender

log4j.appender.logfile.File=${myweb.root}/WEB-INF/log/myweb.log

log4j.appender.logfile.MaxFileSize=512KB

log4j.appender.logfile.MaxBackupIndex=5

log4j.appender.logfile.layout=org.apache.log4j.PatternLayout

log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - %m%n

  

如果想對不同的類輸出不同的檔案(以cn.com.Test為例),先要在Test.java中定義:

private static Log logger = LogFactory.getLog(Test.class);

  然後在log4j.properties中加入:

log4j.logger.cn.com.Test= DEBUG, test

log4j.appender.test=org.apache.log4j.FileAppender

log4j.appender.test.File=${myweb.root}/WEB-INF/log/test.log

log4j.appender.test.layout=org.apache.log4j.PatternLayout

log4j.appender.test.layout.ConversionPattern=%d %p [%c] - %m%n

  也就是讓cn.com.Test中的logger使用log4j.appender.test所做的配置。

  但是,如果在同一類中需要輸出多個日志檔案呢?其實道理是一樣的,先在Test.java中定義:

private static Log logger1 = LogFactory.getLog("myTest1");

private static Log logger2 = LogFactory.getLog("myTest2");

  然後在log4j.properties中加入:

log4j.logger.myTest1= DEBUG, test1

log4j.appender.test1=org.apache.log4j.FileAppender

log4j.appender.test1.File=${myweb.root}/WEB-INF/log/test1.log

log4j.appender.test1.layout=org.apache.log4j.PatternLayout

log4j.appender.test1.layout.ConversionPattern=%d %p [%c] - %m%n

  

log4j.logger.myTest2= DEBUG, test2

log4j.appender.test2=org.apache.log4j.FileAppender

log4j.appender.test2.File=${myweb.root}/WEB-INF/log/test2.log

log4j.appender.test2.layout=org.apache.log4j.PatternLayout

log4j.appender.test2.layout.ConversionPattern=%d %p [%c] - %m%n

  也就是在用logger時給它一個自定義的名字(如這裡的"myTest1"),然後在log4j.properties中做出相應配置即可。别忘了不同日志要使用不同的logger(如輸出到test1.log的要用logger1.info("abc"))。

  還有一個問題,就是這些自定義的日志預設是同時輸出到log4j.rootLogger所配置的日志中的,如何能隻讓它們輸出到自己指定的日志中呢?别急,這裡有個開關:

log4j.additivity.myTest1 = false

  它用來設定是否同時輸出到log4j.rootLogger所配置的日志中,設為false就不會輸出到其它地方啦!注意這裡的"myTest1"是你在程式中給logger起的那個自定義的名字!

如果你說,我隻是不想同時輸出這個日志到log4j.rootLogger所配置的logfile中,stdout裡我還想同時輸出呢!那也好辦,把你的log4j.logger.myTest1 = DEBUG, test1改為下式就OK啦!

log4j.logger.myTest1=DEBUG, test1, stdout

--------------------------------------------------------------------------------------------------------------------------------------

log4j使用示例

--by blues([email protected])

PART 1 介紹

log4j的好處在于:

1.通過修改配置檔案,就可以決定log資訊輸出到何處(console,檔案,...),是否輸出。

這樣,在系統開發階段可以列印詳細的log資訊以跟蹤系統運作情況,而在系統穩定後可以關閉log輸出,進而在能跟蹤系統運作情況的同時,又減少了垃圾代碼(System.out.println(...)等)。

2.使用log4j,需要整個系統有一個統一的log機制,有利于系統的規劃。

log4j的使用本身很簡單。但合理地規劃一個系統的統一log機制需要周全的考慮。

其他關于log4j的資訊參看log4j自帶的文檔。

PART II 配置檔案詳細解釋

先看一個配置檔案的例子:

1.配置檔案的例子

log4j.rootLogger=DEBUG

#将DAO層log記錄到DAOLog,allLog中

log4j.logger.DAO=DEBUG,A2,A4

#将邏輯層log記錄到BusinessLog,allLog中

log4j.logger.Businesslog=DEBUG,A3,A4

#A1--列印到螢幕上

log4j.appender.A1=org.apache.log4j.ConsoleAppender

log4j.appender.A1.layout=org.apache.log4j.PatternLayout

log4j.appender.A1.layout.ConversionPattern=%-5p [%t] %37c %3x - %m%n

#A2--列印到檔案DAOLog中--專門為DAO層服務

log4j.appender.A2=org.apache.log4j.DailyRollingFileAppender

log4j.appender.A2.file=DAOLog

log4j.appender.A2.DatePattern='.'yyyy-MM-dd

log4j.appender.A2.layout=org.apache.log4j.PatternLayout

log4j.appender.A2.layout.ConversionPattern=[%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

#A3--列印到檔案BusinessLog中--專門記錄邏輯處理層服務log資訊

log4j.appender.A3=org.apache.log4j.DailyRollingFileAppender

log4j.appender.A3.file=BusinessLog

log4j.appender.A3.DatePattern='.'yyyy-MM-dd

log4j.appender.A3.layout=org.apache.log4j.PatternLayout

log4j.appender.A3.layout.ConversionPattern=[%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

#A4--列印到檔案alllog中--記錄所有log資訊

log4j.appender.A4=org.apache.log4j.DailyRollingFileAppender

log4j.appender.A4.file=alllog

log4j.appender.A4.DatePattern='.'yyyy-MM-dd

log4j.appender.A4.layout=org.apache.log4j.PatternLayout

log4j.appender.A4.layout.ConversionPattern=[%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

2.Appender的使用

一個Appender代表log資訊要寫向的一個地方。log4j可使用的Appender有很多類型,這裡隻考慮3種:ConsoleAppender,FileAppender,DailyRollFileAppender

2.1 ConsoleAppender

如果使用ConsoleAppender,那麼log資訊将寫到Console。就是直接把資訊列印到System.out上了。

2.2 FileAppender

使用FileAppender,那麼log資訊将寫到指定的檔案中。這應該是比較經常使用到的情況。

相應地,在配置檔案中應該指定log輸出的檔案名。如下配置指定了log檔案名為demo.txt

log4j.appender.A2.File=demo.txt

注意将A2替換為具體配置中Appender的别名。

2.3 DailyRollingAppender

使用FileAppender可以将log資訊輸出到檔案中,但是如果檔案太大了讀起來就不友善了。這時就可以使用DailyRollingAppender。DailyRollingAppender可以把Log資訊輸出到按照日期來區分的檔案中。如下配置檔案就會每天産生一個log檔案,每個log檔案隻記錄當天的log資訊:

log4j.appender.A2=org.apache.log4j.DailyRollingFileAppender

log4j.appender.A2.file=demo

log4j.appender.A2.DatePattern='.'yyyy-MM-dd

log4j.appender.A2.layout=org.apache.log4j.PatternLayout

log4j.appender.A2.layout.ConversionPattern=%m%n

3.Layout的配置

Layout指定了log資訊輸出的樣式。

詳細資訊請檢視PatternLayout的javadoc。

例子1:顯示日期和log資訊

log4j.appender.A2.layout=org.apache.log4j.PatternLayout

log4j.appender.A2.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} %m%n

列印的資訊是:

2002-11-12 11:49:42,866 SELECT * FROM Role WHERE 1=1 order by createDate desc

例子2:顯示日期,log發生地方和log資訊

log4j.appender.A2.layout=org.apache.log4j.PatternLayout

log4j.appender.A2.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} %l "#" %m%n

2002-11-12 11:51:46,313 cn.net.unet.weboa.system.dao.RoleDAO.select(RoleDAO.java:409) "#" SELECT * FROM Role WHERE 1=1 order by createDate desc

例子3:顯示log級别,時間,調用方法,log資訊

log4j.appender.A2.layout=org.apache.log4j.PatternLayout

log4j.appender.A2.layout.ConversionPattern=[%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n

log資訊:

[DEBUG] 2002-11-12 12:00:57,376 method:cn.net.unet.weboa.system.dao.RoleDAO.select(RoleDAO.java:409)

SELECT * FROM Role WHERE 1=1 order by createDate desc

PART 3 log4j的使用

log4j使用步驟有3個:

3.1.根據配置檔案初始化log4j

配置檔案如PART 2所叙述。現在講的是如何在程式中配置log4j。

log4j可以使用3中配置器來初始化:BasicConfigurator,DOMConfigurator,PropertyConfigurator

這裡用的是PropertyConfigurator。使用PropertyConfigurator适用于所有的系統。

如下的語句

PropertyConfigurator.configure("log4j.properties");

就以log4j.properties為配置檔案初始化好了log4j環境。

注意一點:這個語句隻需要在系統啟動的時候執行一次。例如:在unet webOA項目中可以這麼用:

在ActionServlet的init()方法中調用一次。

public class ActionServlet extends HttpServlet{

...

public void init() throws ServletException {

// 初始化Action資源

try{

initLog4j();

...

}catch(IOException e){

throw new ServletException("Load ActionRes is Error");

}

}

...

protected void initLog4j(){

PropertyConfigurator.configure("log4j.properties");

}

...

}//end class ActionServlet

3.2 在需要使用log4j的地方擷取Logger執行個體

如下是RoleDAO類中的使用例子:

static Logger log = Logger.getLogger("DAO");

注意這裡使用"DAO"辨別符,那麼對應的在配置檔案中對應的配置資訊如下:

#定義DAO Logger

log4j.logger.DAO=DEBUG,A2

#設定Appender A2的屬性

log4j.appender.A2=org.apache.log4j.DailyRollingFileAppender

log4j.appender.A2.file=demo

log4j.appender.A2.DatePattern='.'yyyy-MM-dd

log4j.appender.A2.layout=org.apache.log4j.PatternLayout

log4j.appender.A2.layout.ConversionPattern=%-5p %d{yyyy-MM-dd HH:mm:ss} %l%n%m%n

public class RoleDAO extends BaseDBObject

{

...

static Logger log = Logger.getLogger("DAO");

...

public BeanCollection selectAll() throws SQLException

{

StringBuffer sql = new StringBuffer(SQLBUF_LEN);

sql.append("SELECT * FROM " + tableName + " order by roldId");

//System.out.println(sql.toString());

log.debug(sql);

...

}

...

}

3.3 使用Logger對象的debug,info,fatal...方法

log.debug("it is the debug info");

附件1:log4j的一個bug

當這樣使用時,DailyRollingFileAppender不能正确使用:

public Class RoleDAO(){

static Logger log = Logger.getLogger("DAO");

//在每一次new RoleDAO對象的時候都執行一次configure()操作

public RoleDAO(TransactionManager transMgr) throws SQLException

{

...

PropertyConfigurator.configure("log4j.properties");

...

}

public void select(){

...

//使用log4j進行log記錄

log.debug("...");

...

}

}

怎麼解決:

在系統啟動時執行一次PropertyConfigurator.configure("log4j.properties");

之後就不再執行。

---------------------------------------------------------------------------------------------------------------------------

一、log4j.properties

### 設定org.zblog域對應的級别INFO,DEBUG,WARN,ERROR和輸出地A1,A2 ##

log4j.category.org.zblog=ERROR,A1

log4j.category.org.zblog=INFO,A2

log4j.appender.A1=org.apache.log4j.ConsoleAppender

### 設定輸出地A1,為ConsoleAppender(控制台) ##

log4j.appender.A1.layout=org.apache.log4j.PatternLayout

### 設定A1的輸出布局格式PatterLayout,(可以靈活地指定布局模式)##

log4j.appender.A1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

### 配置日志輸出的格式##

log4j.appender.A2=org.apache.log4j.RollingFileAppender

### 設定輸出地A2到檔案(檔案大小到達指定尺寸的時候産生一個新的檔案)##

log4j.appender.A2.File=E:/study/log4j/zhuwei.html

### 檔案位置##

log4j.appender.A2.MaxFileSize=500KB

### 檔案大小##

log4j.appender.A2.MaxBackupIndex=1

log4j.appender.A2.layout=org.apache.log4j.HTMLLayout

##指定采用html方式輸出

二、log4j.xml

<?xml version="1.0" encoding="GB2312" ?>

<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

<appender name="org.zblog.all" class="org.apache.log4j.RollingFileAppender">

<!-- 設定通道ID:org.zblog.all和輸出方式:org.apache.log4j.RollingFileAppender -->

<param name="File" value="E:/study/log4j/all.output.log" /><!-- 設定File參數:日志輸出檔案名 -->

<param name="Append" value="false" /><!-- 設定是否在重新啟動服務時,在原有日志的基礎添加新日志 -->

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%p (%c:%L)- %m%n" /><!-- 設定輸出檔案項目和格式 -->

</layout>

</appender>

<appender name="org.zblog.zcw" class="org.apache.log4j.RollingFileAppender">

<param name="File" value="E:/study/log4j/zhuwei.output.log" />

<param name="Append" value="true" />

<param name="MaxFileSize" value="10240" /> <!-- 設定檔案大小 -->

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%p (%c:%L)- %m%n" />

</layout>

</appender>

<logger name="zcw.log"> <!-- 設定域名限制,即zcw.log域及以下的日志均輸出到下面對應的通道中 -->

<level value="debug" /><!-- 設定級别 -->

<appender-ref ref="org.zblog.zcw" /><!-- 與前面的通道id相對應 -->

</logger>

<root> <!-- 設定接收所有輸出的通道 -->

<appender-ref ref="org.zblog.all" /><!-- 與前面的通道id相對應 -->

</root>

</log4j:configuration>

三、配置檔案加載方法:

import org.apache.log4j.Logger;

import org.apache.log4j.PropertyConfigurator;

import org.apache.log4j.xml.DOMConfigurator;

public class Log4jApp {

public static void main(String[] args) {

DOMConfigurator.configure("E:/study/log4j/log4j.xml");//加載.xml檔案

//PropertyConfigurator.configure("E:/study/log4j/log4j.properties");//加載.properties檔案

Logger log=Logger.getLogger("org.zblog.test");

log.info("測試");

}

}

四、項目使用log4j

在web應用中,可以将配置檔案的加載放在一個單獨的servlet中,并在web.xml中配置該servlet在應用啟動時候加載。對于在多人項目 中,可以給每一個人設定一個輸出通道,這樣在每個人在建構Logger時,用自己的域名稱,讓調試資訊輸出到自己的log檔案中。

五、常用輸出格式

# -X号:X資訊輸出時左對齊;

# %p:日志資訊級别

# %d{}:日志資訊産生時間

# %c:日志資訊所在地(類名)

# %m:産生的日志具體資訊

# %n:輸出日志資訊換行