风行天下

2、存放器
　　在log4j中，log信息通过存放器输出到目的地。支持的存放器有console, files, GUI components, remote socket servers, JMS, NT Event Loggers, remote UNIX Syslog daemons。通过file存放器，log信息可以被输出到不同的文件中（即不同的目的地）。log信息可被异步存放。
　　一个记录器可以有多个存放器，可以通过方法addAppender来增加存放器。一条blog信息如果可被这个记录器处理，则记录器会把这条信息送往每个它所拥有的存放器。
　　每个记录器有一个继承开关,其开关决定记录器是/否继承其父记录器的存放器，注意，如果继承则只继承其父记录器，而不考虑更远的祖先的情况。参考下表：

记录器	增加的存放器	继承的存放器	输出的目的地	备注
root	A1	not applicable	A1	The root logger is anonymous but can be accessed with the Logger.getRootLogger() method. There is no default appender attached to root.
x	A-x1, A-x2	TRUE	A1, A-x1, A-x2	Appenders of "x" and root.
x.y	none	TRUE	A1, A-x1, A-x2	Appenders of "x" and root.
x.y.z	A-xyz1	TRUE	A1, A-x1, A-x2, A-xyz1	Appenders in "x.y.z", "x" and root.
security	A-sec	FALSE	A-sec	No appender accumulation since the additivity flag is set to false.
security.access	none	TRUE	A-sec	Only appenders of "security" because the additivity flag in "security" is set to false.

　　
　　
3、布局
　　布局负责格式化输出的log信息。log4j的PatternLayout可以让程序以类似C语言printf的格式化模板来定义格式。

4、log4j可据程序员制定的标准自动提供一些log信息，这对那类需要频繁log的对象的情况很帮助。对象的自动log，具有继承性

前面主要记了一些原理，今天是实务。

1、研究发现，一个系统中4%的代码是用来作logging的。
2、Log4J的配置文件(Configuration File)就是用来设置记录器的级别、存放器和布局的，它可接key=value格式的设置或xml格式的设置信息。通过配置，可以创建出Log4J的运行环境。
　　Log4J运行时，不对环境做任何假定，尤其是没有默认的存放器。
3、有几种方式可以配置Log4J
1）在程序中调用BasicConfigurator.configure()方法；
2）配置放在文件里，通过命令行参数传递文件名字，通过PropertyConfigurator.configure(args[x])解析并配置；
3）配置放在文件里，通过环境变量传递文件名等信息，利用log4j默认的初始化过程解析并配置；
4）配置放在文件里，通过应用服务器配置传递文件名等信息，利用一个特殊的servlet来完成配置。
看下面的例子：

import com.foo.Bar;

 // Import log4j classes.

 import org.apache.log4j.Logger;

 import org.apache.log4j.BasicConfigurator;

 public class MyApp {

   // Define a static logger variable so that it references the

   // Logger instance named "MyApp".

   static Logger logger = Logger.getLogger(MyApp.class);

   public static void main(String[] args) {

     // Set up a simple configuration that logs on the console.

     BasicConfigurator.configure();

     logger.info("Entering application.");

     Bar bar = new Bar();

     bar.doIt();

     logger.info("Exiting application.");

   }

 }

 package com.foo;

 import org.apache.log4j.Logger;


 public class Bar {

   static Logger logger = Logger.getLogger(Bar.class);

   public void doIt() {

     logger.debug("Did it again!");

   }

 }

　　BasicConfigurator.configure给根记录器增加一个ConsoleAppender，输出格式通过PatternLayout设为"%-4r [%t] %-5p %c %x - %m%n"，还有根记录器的默认级别是Level.DEBUG.
　　记录器之间的关系如下图：
　　

　　输出结果如下：

　　下面的代码结合配置信息，会得到与上述程序一样的结果。

import com.foo.Bar;

 import org.apache.log4j.Logger;

 import org.apache.log4j.PropertyConfigurator;

 public class MyApp {

   static Logger logger = Logger.getLogger(MyApp.class.getName());

   public static void main(String[] args) {

     // BasicConfigurator replaced with PropertyConfigurator.

     PropertyConfigurator.configure(args[0]);

     logger.info("Entering application.");

     Bar bar = new Bar();

     bar.doIt();

     logger.info("Exiting application.");

   }

 }

配置文件的内容如下：

利用配置文件，可以很方便地修改配置。如下例

对于tomcat4，利用环境变量传递参数的，可参见以下几个例子

配置文件位置如果没有明确指明，则要放在WEB-INF/classes目录下。
4、用servlet配置log4j
以下都是参考冰之火的文章，抄来放在这儿，并做了一些必要的修改。需要说明的是，下面的代码需要自己写并发布，下的jar中没有这个类。待我以后写一个，也放上来。我也写了两个，在笔记（三）中。
在Application目录下的web.xml文件加入以后代码

  <servlet>

    <servlet-name>log4jlog4j-init</servlet-name>

    <servlet-class>com.apache.jakarta.log4j.Log4jInit</servlet-class>

    <init-param>

      <param-name>log4j</param-name>

      <param-value>/WEB-INF/log4j.properties</param-value>

    </init-param>

    <load-on-startup>1</load-on-startup>

  </servlet>

这段代码的意思是说，在Tomcat启动时加载com.apache.jakarta.log4j.Log4jInit这个名叫Log4jInit.class这个类文件。
其中Log4jInit.class的源代码如下

 

package com.apache.jakarta.log4j;

import org.apache.log4j.PropertyConfigurator;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

public class Log4jInit extends HttpServlet {


  public void init() {

	String prefix =  getServletContext().getRealPath("/");

	String file = getInitParameter("log4j");

	// if the log4j-init-file is not set, then no point in trying

	System.out.println("................log4j start");

	if(file != null) {

	  PropertyConfigurator.configure(prefix+file);

	}

  }

public void doGet(HttpServletRequest req, HttpServletResponse res) {

  }

}

在加载的过程中，程序会读取/WEB-INF/log4j.properties这个文件。
配置文件讲解如下：

配置根Logger，其语法为：

level 是日志记录的优先级
appenderName就是指定日志信息输出到哪个地方。您可以同时指定多个输出目的地。

配置日志信息输出目的地Appender，其语法为

Log4j提供的appender有以下几种：
org.apache.log4j.ConsoleAppender（控制台），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

配置日志信息的格式（布局），其语法为：

Log4j提供的layout有以下几种：
org.apache.log4j.HTMLLayout（以HTML表格形式布局），
org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）




简单的Log4j使用只需要导入下面的包就可以了
// import log4j packages
import org.apache.log4j.Logger;

然后你需要在类的开头写上下面一句
private final static Logger log =
Logger.getLogger(ClassName.class);//注意这里写的是当前类的类名。
这样你就有了一个日志对象叫做 log，这个log有以下集中用法
log.info();//一般信息
log.debug();//调试信息
log.error();//错误信息
log.warn();//警告信息
log.fatal();//致命错误信息
上面列出的就是所谓log4j的输出级别，log4j建议只使用4个级别，它们从上到下分别为
ERROR、WARN、INFO、DEBUG，假设你定义的级别是info，那么error和warn的日志可以显示而比他低的debug信息就不显示了。
知道了上面的内容还不够，要想很好的使用log4j你还需要配置log4j的环境。因为每个log都可以通过配置它的属性文件来达到控制日志输出的格式的目的，下面我给出一个在weblogic下使用log4j的配置过程，首先给出这个配置文件的完整信息。

#log4j.rootLogger=INFO,A1,R //这一句指定了日志输出的级别为info,A1和R分别代表日志输出到什么地方。
log4j.category.hybl_wshabcm=debug,A1,R //这一句指定了日志具体输出哪个包的信息，以及输出位置
log4j.appender.A1=org.apache.log4j.ConsoleAppender //这里指定了日志输出的第一个位置A1是控制台ConsoleAppender
/*
*其中，Log4j提供的appender有以下几种：
*org.apache.log4j.ConsoleAppender（控制台），
*org.apache.log4j.FileAppender（文件），
*org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
*org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），
*org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）
*
*/
log4j.appender.A1.layout=org.apache.log4j.PatternLayout //指定A1的布局模式

/*
*其中，Log4j提供的layout有以下几种：
×org.apache.log4j.HTMLLayout（以HTML表格形式布局），
*org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
*org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
*org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）
*/
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n //指定日志的输出格式

log4j.appender.R=org.apache.log4j.RollingFileAppender //指定以文件的方式输出日志
log4j.appender.R.File=c:/sys.html //文件位置
log4j.appender.R.MaxFileSize=500KB //文件最大尺寸
log4j.appender.R.MaxBackupIndex=1 //备份数
log4j.appender.R.layout=org.apache.log4j.HTMLLayout //文件的格式为Html格式
#log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

有了上面的这个文件我们还要在weblogic启动的时候通过一个类加载这个文件，可以使用下面的方式
1、加载配置文件的Servlet

package hybl_wshabcm.servelet;

import java.io.File;
import java.io.LineNumberReader;
import java.io.FileReader;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.Vector;
import java.sql.Driver;
import java.sql.DriverManager;

// import servlet packages
import javax.servlet.http.HttpServlet;
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;

// import log4j packages
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
public class SetupServlet extends HttpServlet{

public void init(ServletConfig config) throws ServletException{

super.init(config);

// first thing to do, is to set up the Driver that we might be using
// in case of JDBCAppender
try{
Driver d =
(Driver)(Class.forName(
"org.gjt.mm.mysql.Driver").newInstance());
DriverManager.registerDriver(d);
//加载JDBC驱动程序，当准备将日志记录到数据库的时候可以使用
}catch(Exception e){ System.err.println(e); }

// next load up the properties
//启动时从web.xml中获得配置文件的信息
String props = config.getInitParameter("props");

if(props == null || props.length() == 0 ||
!(new File(props)).isFile()){

System.err.println(
"ERROR: Cannot read the configuration file. " +
"Please check the path of the config init param in web.xml");
throw new ServletException();
}
}

public void destroy(){
super.destroy();
}
}

2、web.xml文件的部署
上面的这个Servlet在服务器启动的时候将一些初始化信息加载，那么如何在weblogic启动的时候将这个类也
加载呢？看一个例子

setup
hybl_wshabcm.servelet.SetupServlet//启动时装载的类

props
/WEB-INF/log4j.properties//部署文件的位置

2//这句很重要

好了，现在你可以象开头那样使用log4j来记录日志了