一、前言
Java的開源項目太多了,這種遍地開花的局面絕對趕得上中國五代十國時期的“百家爭鳴”、“百花爭艷”的繁榮。使用java技術，我們的項目幾乎不需要購買有關java支撐開發產品，只需把一個一個開源產品經過架構師的手，合理搭配和拼接，就能做出靈活性佳、性能不錯的商業產品來。
無疑，作為一個流行的日志記錄工具，Log4j是java開源項目中最閃亮的環節之一。筆者所見的java項目，十有八九都采用了Log4j，究其原因，我認為有以下幾點：
a）Log4j受大多數web應用服務器的擁護：以我目前所知，tomcat，weblogic，websphere，jboss都支持log4j。
b）快速，功能強大：Log4J配置文件實現了輸出到控制台、文件、回滾文件、發送日志郵件、輸出到數據庫日志表、自定義標簽等全套功能。在速度上，從log4j一開始出現，注重運行的速度就一直放在首位，並且堅持不懈地進行著改進和完善。
c）使用簡單、方便：只需要導入一個簡單的log4j-1.2.x.jar，然後在程序類的開頭寫上下面一句private final static Logger log =Logger.getLogger(ClassName.class);
這樣你就得到了一個日志對象log，可以輕松往特定目標寫日志了。
二、為什麼需要Log4j？---項目的調試是log4j產生的內在驅動力
原始的方法是：把信息輸出到屏幕（console），利用JDK提供的System.out.println。但是，這樣做的壞處是顯而易見的：
a）信息的輸出不夠靈活，並且繁瑣。比如，要輸出執行處的文件名，行數，當前時間等，println顯得很原始。
b）如果要改變輸出的內容和格式，需要重新編譯源程序。
c）更嚴重的是，如果程序中有很多的println，會嚴重的影響程序的性能。
三、Log4j使用的幾個關鍵點？
根記錄器（Logger），輸出端（appenders）和布局（layouts）
a）定義根記錄器的格式為
log4j.rootLogger = [ level ], appendName1, appendName2, …appendNameN。同一個記錄器可有多個輸出端。
PS：level的級別（此級別可以自定義，系統默認提供了以下級別）
◆debug//調試信息
◆info//一般信息
◆warn//警告信息
◆error//錯誤信息
◆fatal//致命錯誤信息
上面列出的就是所謂log4j的輸出級別，log4j建議只使用4個級別，它們從上到下分別為ERROR、WARN、INFO、DEBUG，假設你定義的級別是info，那麼error和warn的日志可以顯示而比他低的debug信息就不顯示了。
b）定義一個appender的輸出目的地的格式為
log4j.appender.appenderName = fully.qualified.name.of.appender.class。log4j提供了以下幾種常用的輸出目的地：
◆org.apache.log4j.ConsoleAppender，將日志信息輸出到控制台
◆org.apache.log4j.FileAppender，將日志信息輸出到一個文件
◆org.apache.log4j.DailyRollingFileAppender，將日志信息輸出到一個，並且每天輸出到一個新的日志文件
◆org.apache.log4j.RollingFileAppender，將日志信息輸出到一個文件，通過指定文件的的尺寸，當文件大小到達指定尺寸的時候會自動把文件改名，如名為example.log的文件會改名為 example.log.1，同時產生一個新的example.log文件。如果新的文件再次達到指定尺寸，又會自動把文件改名為 example.log.2，同時產生一個example.log文件。依此類推，直到example.log. MaxBackupIndex，MaxBackupIndex的值可在配置文件中定義。
◆org.apache.log4j.WriterAppender，將日志信息以流格式發送到任意指定的地方。
◆org.apache.log4j.jdbc.JDBCAppender，通過JDBC把日志信息輸出到數據庫中。
c）輸出格式（布局）layout
Log4j提供了一下幾種布局：
◆org.apache.log4j.HTMLLayout，以HTML表格形式布局
◆org.apache.log4j.PatternLayout，可以靈活地指定布局模式
◆org.apache.log4j.SimpleLayout，包含日志信息的級別和信息字符串
定義一個PatternLayout布局的語句為：
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1} - %m%n
PS：ConversionPattern參數的格式含義
格式名 含義
%c 輸出日志信息所屬的類的全名
%d 輸出日志時間點的日期或時間，默認格式為ISO8601，也可以在其後指定格式，比如：%d{yyy-MM-dd HH:mm:ss }，輸出類似：2002-10-18- 22：10：28
%f 輸出日志信息所屬的類的類名
%l 輸出日志事件的發生位置，即輸出日志信息的語句處於它所在的類的第幾行
%m 輸出代碼中指定的信息，如log(message)中的message
%n 輸出一個回車換行符，Windows平台為“\r\n”，Unix平台為“\n”
%p 輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL。如果是調用debug()輸出的，則為DEBUG，依此類推
%r 輸出自應用啟動到輸出該日志信息所耗費的毫秒數
%t 輸出產生該日志事件的線程名
四、log4j的配置文件:log4j.properties或者log4j.xml
a）有幾種方式可以配置Log4J
◆在程序中調用BasicConfigurator.configure()方法；
◆配置放在文件裡，通過命令行參數傳遞文件名字，通過
PropertyConfigurator.configure(args[x])解析並配置；
◆配置放在文件裡，通過環境變量傳遞文件名等信息，利用log4j默認的初始化過程解析並配置；
◆配置放在文件裡，通過應用服務器配置傳遞文件名等信息，利用一個特殊的servlet來完成配置。
b）配置文件的初始化：
通過應用服務器完成初始化
通過servlet輔助完成初始化
c）一個log4j.properties文件示例
log4j.rootLogger=INFO, stdout, logfile
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=/webserver/specialTraining3/wangzj.log
log4j.appender.logfile.MaxFileSize=51200KB
log4j.appender.logfile.MaxBackupIndex=3
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%d %p [%c] - <%m>%n
五、用log4j來演練一個例子
Test:
com.webage.servlets.MyServlet
Log4j.properties文件：
log4j.rootLogger=DEBUG,ROOT
log4j.appender.ROOT=org.apache.log4j.RollingFileAppender
log4j.appender.ROOT.File=E:\wangzj\myapplication.log
log4j.appender.ROOT.MaxFileSize=1000KB
log4j.appender.ROOT.MaxBackupIndex=5
log4j.appender.ROOT.layout=org.apache.log4j.PatternLayout
log4j.appender.ROOT.layout.ConversionPattern=[%d]%t%c%-5p-%m%n
ootLogger=DEBUG,CONSOLE,A1,im
log4j.addivity.org.apach
MyModel.java文件：
package com.webage.model;
import org.apache.log4j.Logger;
public class MyModel {
static Logger logger = Logger.getLogger(MyModel.class);;
public void checkValid(String name, String value) throws Exception {
logger.debug("ENTRY");
logger.debug("檢查參數: " + name);
if (value == null) {
throw new Exception("缺少參數。");
}
if (value.trim().length() == 0) {
throw new Exception("參數空。");
}
logger.debug("EXIT");
}
}
MyServlet.java
package com.webage.servlets;
import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.log4j.Logger;
import com.webage.model.MyModel;
public class MyServlet extends HttpServlet {
Logger logger = Logger.getLogger(MyServlet.class);
public void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
logger.debug("ENTRY");
MyModel model = new MyModel();
resp.getWriter().println("Log4J測試");
try {
model.checkValid("firstName", req.getParameter("firstName"));
} catch (Exception e) {
logger.error("doGet出現錯誤.", e);
}
logger.debug("EXIT");
}
public void init() throws ServletException {
super.init();
logger.info("Servlet初始化...");
}
}
需要兩個jar包：servlet.jar和log4j-1.2.9.jar。
准備就緒，運行之於tomcat或者weblogic，筆者暫用weblogic代之。每當運行Logger logger = Logger.getLogger(MyServlet.class);時即生成E:\wangzj\myapplication.log文件。
