一、前言

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