1 Log4j配置說明
1.1 設定文件
Log4j可以透過java程式動態設置,該方式明顯缺點是:如果需要修改日誌輸出等級等信息,則必須修改java文件,然後重新編譯,很麻煩;
log4j也可以透過設定檔的方式進行設置,目前支援兩種格式的設定檔:
•xml文件
•properties檔案(建議)
下面是一個log4j設定檔的完整內容:
複製代碼代碼如下:
log4j.rootCategory=INFO, stdout
log4j.rootLogger=info, stdout
### stdout ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p - %m%n
### set package ###
log4j.logger.org.springframework=info
log4j.logger.org.apache.catalina=info
log4j.logger.org.apache.commons.digester.Digester=info
log4j.logger.org.apache.catalina.startup.TldConfig=info
log4j.logger.chb.test=debug
1.2 配置根Logger
根logger主要定義log4j支援的日誌等級及輸出目的地,其語法為:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
其中,level 是日誌記錄的優先權,分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或自訂的等級。
建議只使用四個級別,優先權從高到低分別是ERROR、WARN、INFO、DEBUG。
appenderName指定日誌資訊輸出到哪個地方,可同時指定多個輸出目的地。
1.3 設定輸出目的地Appender
Appender主要定義日誌資訊輸出在什麼位置,主要語法為:
複製代碼代碼如下:
log4j.appender.appenderName = classInfo
log4j.appender.appenderName.option1 = value1
…
log4j.appender.appenderName.optionN = valueN
Log4j提供的appender有以下幾種:
•org.apache.log4j.ConsoleAppender(控制台),
•org.apache.log4j.FileAppender(檔案),
•org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌檔案),
•org.apache.log4j.RollingFileAppender(檔案大小到達指定尺寸的時候產生一個新的檔案)
•org.apache.log4j.WriterAppender(將日誌資訊以串流格式傳送到任意指定的地方)
以ConsoleAppender為例,如:
複製代碼代碼如下:
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
1.4 設定日誌資訊的格式Layout
Layout 負責格式化Appender的輸出,其語法為:
複製代碼代碼如下:
log4j.appender.appenderName.layout = classInfo
log4j.appender.appenderName.layout.option1 = value1
…
log4j.appender.appenderName.layout.optionN = valueN
其中,Log4j提供的layout有以下幾種:
•org.apache.log4j.HTMLLayout(以HTML表格形式佈局),
•org.apache.log4j.PatternLayout(可以靈活地指定佈局模式),
•org.apache.log4j.SimpleLayout(包含日誌資訊的等級和資訊字串)
•org.apache.log4j.TTCCLayout(包含日誌產生的時間、執行緒、類別等等資訊)
1.5 設定package輸出級
可以設定不同package的日誌輸出級別,語法為:
log4j.logger.packageName=level
其中,packageName為實際的套件名,level為日誌級別,例如:
複製代碼代碼如下:
log4j.logger.org.springframework=info
log4j.logger.org.apache.catalina=info
log4j.logger.org.apache.commons.digester.Digester=info
log4j.logger.org.apache.catalina.startup.TldConfig=info
log4j.logger.chb.test=debug
2 Log4j與J2ee結合
2.1 使用spring架構
Spring真是不錯,替我們做了很多事情,如果系統使用了spring框架,則要整合log4j就很簡單了,主要分為3個步驟,如下:
2.1.1 定義log4j設定檔
複製代碼代碼如下:
log4j.rootCategory=INFO, stdout
log4j.rootLogger=info, stdout
### stdout ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p - %m%n
### log to file ###
log4j.logger.org.springframework=info
log4j.logger.org.apache.catalina=info
log4j.logger.org.apache.commons.digester.Digester=info
log4j.logger.org.apache.catalina.startup.TldConfig=info
log4j.logger.chb.test=debug
2.1.2 定義監聽器
監聽器需定義在web.xml,主要包含:定義log4j設定檔目錄、log4j監聽器,如下:
複製代碼代碼如下:
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<!--Spring載入的Log4j設定檔位置-->
<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>/WEB-INF/log4j.properties</param-value>
</context-param>
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>
/WEB-INF/classes/applicationContext*.xml
</param-value>
</context-param>
<!--Spring log4j Config loader-->
<listener>
<listener-class>
org.springframework.web.util.Log4jConfigListener
</listener-class>
</listener>
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
<servlet>
<servlet-name>InitiaServlet</servlet-name>
<servlet-class>chb.test.web.InitiaServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>
2.1.3 測試類
複製代碼代碼如下:
package com.dheaven.mip.web;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import org.apache.log4j.Logger;
public class InitiaServlet extends HttpServlet {
protected Logger log = Logger.getLogger(InitiaServlet.class);
private static final long serialVersionUID = 8550329576989690578L;
/**
* Constructor of the object.
*/
public InitiaServlet() {
super();
}
/**
* Destruction of the servlet. <br>
*/
public void destroy() {
super.destroy();
}
/**
* Initialization of the servlet. <br>
*
* @throws ServletException if an error occure
*/
public void init() throws ServletException {
log.debug("伺服器啟動了,log4j開始工作了");
}
}
2.2不使用spring架構
如果系統沒有使用spring,我們以servlet為例,很簡單,大家都按照步驟執行即可,只貼程式碼,不說廢話。
2.2.1 定義log4j設定檔
放在web工程的WEB-INF目錄下,內容如:
複製代碼代碼如下:
log4j.rootCategory=INFO, stdout
log4j.rootLogger=info, stdout
### stdout ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p - %m%n
### set package ###
log4j.logger.org.apache.catalina=info
log4j.logger.org.apache.commons.digester.Digester=info
log4j.logger.org.apache.catalina.startup.TldConfig=info
log4j.logger.com.dheaven=debug
2.2.2 建立log4j初始化類
複製代碼代碼如下:
package com.dheaven.mip.web;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import org.apache.log4j.PropertyConfigurator;
public class InitLog4j extends HttpServlet {
private static final long serialVersionUID = 1L;
public void init() throws ServletException {
String prefix = getServletContext().getRealPath("/");
prefix = prefix.replace("//", "/");
String file = getInitParameter("log4j-init-file");
// if the log4j-init-file is not set, then no point in trying
if (file != null) {
PropertyConfigurator.configure(prefix + file);
}
}
}
2.2.3 在Web.xml中定義初始化類
複製代碼代碼如下:
<servlet>
<servlet-name>log4j-init</servlet-name>
<servlet-class>chb.test.web.InitLog4j</servlet-class>
<init-param>
<param-name>log4j-init-file</param-name>
<param-value>WEB-INF/log4j.properties</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
2.2.4 測試類
複製代碼代碼如下:
package chb.test.web;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import org.apache.log4j.Logger;
public class InitiaServlet extends HttpServlet {
protected Logger log = Logger.getLogger(InitiaServlet.class);
private static final long serialVersionUID = 8550329576989690578L;
/**
* Constructor of the object.
*/
public InitiaServlet() {
super();
}
/**
* Destruction of the servlet. <br>
*/
public void destroy() {
super.destroy();
}
/**
* Initialization of the servlet. <br>
*
* @throws ServletException if an error occure
*/
public void init() throws ServletException {
log.debug("伺服器啟動了,log4j開始工作了");
}
}