一、前言：

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 来演练一个例子

Web.xml 文件：

version= "1.0" encoding= "ISO-8859-1" ?>

web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/j2ee/dtds/web-app_2_3.dtd" >

Test

com.webage.servlets.MyServlet

Test

/MyServlet

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文件。

Happy~~~~！

六、其它一点实用性资料??网上摘抄而来，具体哪里忘了

log4j.rootLogger=DEBUG,CONSOLE,A1,im
log4j.addivity.org.apache=true


# 应用于控制台

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n


#应用于文件

log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=file.log //相对路径和绝对路径
log4j.appender.FILE.Append=false
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# Use this layout for LogFactor 5 analysis



# 应用于文件回滚

log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=10KB
log4j.appender.ROLLING_FILE.MaxBackupIndex=1
log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n


#应用于socket
log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
# Set up for Log Facter 5
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n


# Log Factor 5 Appender
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000



# 发送日志给邮件

log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=web@www.wuset.com
log4j.appender.MAIL.SMTPHost=www.wusetu.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=web@www.wusetu.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n



# 用于数据库
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n


log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=SampleMessages.log4j
log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout

#自定义Appender

log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender

log4j.appender.im.host = mail.cybercorlin.net
log4j.appender.im.username = username
log4j.appender.im.password = password
log4j.appender.im.recipient = corlin@cybercorlin.net

log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n