apche 通用日志包 和log4j使用指南

Apache通用日志包提供一组通用的日志接口,用户可以自由选择实现日志接口的第三方软件
通用日志目前支持以下日志实现
Log4j日志器
JDK1.4Logging
SimpleLog日志器
NoOpLog日志器

Log 接口
通用日志包把日志消息分为6种级别Fatal,Error,Warn,Info,Debug和Trace

org.apache.commons.logging.Log接口代表日志器,它提供了一组输出日志的方法
   fatal(Object message);
   error(Object message);
   warn (Object message);
   info (Object message);
   debug(Object message);
   trace(Object message);
  这里需要注意的是,只有当输出日志的级别大于等于日志器配置的日志级别时,这个方法
  才会真正被执行.例如日志器设置日志级别为Warn,那么程序中,它的
  fatal(),error(),warn()方法会被执行,而info(),debug(),trace()
  不会被执行.
 
  Log接口还提供了一组判断是否允许输出特定级别日志消息的方法
   isFatalEnable();
   isErrorEnable();
   isWarnEnable();
   isInfoEnable();
   isDebugEnable();
   isTraceEnable();
  
  LogFactory接口
 
  org.apache.commons.logging.LogFactory接口提供了获得日志器实例的两个静态方法
   public static Log getLog(String name)throws LogConfigurationException
   public static Log getLog(Class class)throws LogConfigurationException
  
   public static Log getLog(Class class)
   {
    getLog(class.getName());
   }
 
 
 Log4J 日志器
 
 Log4J 是Apache的一个开放源代码的项目.
 
 Log4J由三大组件构成
 
 Logger: 负责生成日志,并能根据配置的日志器级别来决定什么日志消息应该被输出.
 
 Appender: 定义日志消息输出的目的地,指定日志消息应该被输出到什么地方,
 这些地方可以是控制台,文件和网络设备等.
 
 Layout:指定日志消息的输出格式
 
        配置通用日志接口
 
 在web应用中使用通用日志包,首先必须进行以下配置
 
 准备有关的jar文件
 在commons-logging.properties 属性文件中指定日志器(即日志实线类)
 为特定的日志器设置日志级别,输出格式和输出地点等.
 
 准备有关jar文件
 这里主要是准备 commons-logging.jar和 log4j.jar 放到lib目录下
 
 指定日志器
 
 通用日志接口从名为 commons-logging.properties的属性文件中获取实现日志
 接口的日志器信息,这个文件放在web-inf/class目录下
 在该文件的org.apache.commons.logging.Log属性指定日志实现类
 例如用Log4J日志器,那么设置
 org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JCategoryLog
 
 设置日志器属性
 
 多数日志器允许以配置的方式,指定日志器的输出格式,地点,或者级别.
 配置Log4J
 Log4J,由三个重要的组件构成,Logger,Appender和Layout.
 Log4J支持两种配置文件格式:一种是XML格式文件,一种是java属性文件.
 
 配置Log4J组件
 Logger组件支持继承关系,所有的Logger组件都直接或者间接继承rootLogger,
 配置rootLogger的语法为
 log4j.rootLogger=[priority],appenderName,appenderName,..
 
其中priority是日志级别,可选值OFF,FATAL,ERROR,WARN,INFO,DEBUG,TRACE和ALL
appenderName指定Appender组件,用户可以同时指定多个Appender组件,例如
以下代码指定rootLogger的日志级别为INFO,它有两个Appender,名为console和flie
log4j.rootLogger=INFO,console,file

配置Appender组件
配置日志消息输出目的地Appender,有以下几种
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender(文件大小达到指定尺寸的时候产生一个新文件)
org.apache.log4j.WriterAppender(将日志信息以流个格式发送到任意指定的地方)

 例如以下代码定义了一个名了file的Appender,它把日志信息输出到log.txt文件
  log4j.appender.file=org.apache.log4j.RollingFileAppender
  log4j.appender.file.File=log.txt
 
 配置Layout组件
 
 Log4j提供下面几种Layout
 org.apache.log4j.HTMLLayout(以html表格形式布局)
 org.apache.log4j.PatterLayout(可以灵活的指定布局模式)
 org.apache.log4j.SimpleLayout(包含日志消息的级别和信息字符串)
 org.apache.log4j.TTCCLayout(包含日志产生的时间线程和类别)

 Log4J采用类似C语言中的printf函数的打印格式格式化日志信息，打印参数如下： %m 输出代码中指定的消息

　　%p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL
　　%r 输出自应用启动到输出该log信息耗费的毫秒数
　　%c 输出所属的类目，通常就是所在类的全名
　　%t 输出产生该日志事件的线程名
　　%n 输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”
　　%d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，输出类似：2002年10月18日 22：10：28，921
　　%l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java:10)

 如果为名"file"的Appender配置PatterLayout布局,则可以采用如下代码
   log4j.appender.file.layout=org.apache.log4j.PatterLayout
   log4j.appender.file.layout.ConversionPattern=%t%p-%m%n
  
   采用以上PatternLayout布局,从日志文件中看到的输出日志的形式如下
     http8080-Processor24 INFO -This is an info message
   %t对应"http8080-Processor24" %p对应INFO,%m%n对应后面具体的日志消息
  
   一个简单的应用
 
  
   新建log4j.properties
   log4j.rootLogger=INFO,a
   log4j.appender.a=org.apache.log4j.RollingFileAppender
   log4j.appender.a.File=log.txt
   log4j.appender.a.layout=org.apache.log4j.SimpleLayout
  
   import org.apache.commons.logging.Log;
    import org.apache.commons.logging.LogFactory;

public class Log4JTest {

    /**
     * @param args
     */
    private static Log log=LogFactory.getLog(Log4JTest.class);
    public static void main(String[] args) {
        // TODO Auto-generated method stub
      log.info("aaa");
   
    }

}