log4j使用整理材料(3)

(2) 在log4j.xml中如下配置：

<appender name="PROJECT" class="org.apache.log4j.FileAppender">
    <param name="file" value="${myApp.root}/logs/mylog.log"/>
    <param name="append" value="false"/>
    <param name="encoding" value="utf-8"/>
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
    </layout>

</appender>

这样就可以实现日志输出目录的动态配置了！

如果配置的是配置文件，需要如下的配置：

log4j.appender.info.File=${myApp.root}/WEB-INF/logs/info.log

(3) 注意：要将log4j.xml或log4j.property放在WEB-INF目录下面，如果放在通常的classes下面的话会有一个问题，当Tomcat启动的时候，Log4j会到classes下面去找这个配置 文件，然后因为这时候还没有设置系统变量，那么就会报找不到对应文件的错误了！但其实这个错误是不会影响接下来的功能，就是为了避免出现这个异常将配置文件放到WEB-INF下面。

1.1.1           使用log4j将log写入mysql

在log4j 1.2.8 的api中JDBCAppender类的说明中有一段红字
WARNING: This version of JDBCAppender is very likely to be
completely replaced in the future. Moreoever, it does
not log exceptions.
1. 在mysql中创建库logdb
create database;
2. 在库logdb中创建表muglog,
create table muglog{
   id INT(4) UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
   logdate DATE,
   logger VARCHAR(50),
   priority VARCHAR(50),
   message VARCHAR(255)
};
3. 修改log4j.properties
### 限制com.bob.digester(名:dig)才会log on JDBCAppender ###
log4j.logger.com.bob.digester=info, dig

log4j.appender.dig=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.dig.URL=jdbc:mysql://localhost/logdb
log4j.appender.dig.driver=com.mysql.jdbc.Driver
log4j.appender.dig.user=root
log4j.appender.dig.password=
log4j.appender.dig.sql=INSERT INTO MUGLOG (LOGDATE, LOGGER, PRIORITY, MESSAGE) VALUES ('%d', '%c', '%p', '%m')
log4j.appender.dig.layout=org.apache.log4j.PatternLayout

4. 注意，这里mysql的driver是mysql-connector-java-3.0.14-production-bin.jar里的com.mysql.jdbc.Driver
   所以，把它放到classpath里, 如在Eclipse测试，需放到project的java build path的Libraries里

1. log4j的一个简单例子
把日志输出到MySQL数据库
Hello.java

import org.apache.log4j.*;
public class Hello {
     static Logger logger = Logger.getLogger(Hello.class);
     public static void main(String[] args) {
        PropertyConfigurator.configure("log4j.properties");
         logger.info("Entering Application");
         for(int i = 1; i < 10; i++) {
       logger.debug("" + i);
     }
         logger.info("Exit Application");
   }
}

log4j.properties

log4j.rootLogger=DEBUG,DATABASE
log4j.addivity.org.apache=true
########################
# JDBC Appender
#######################
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.URL=jdbc:mysql://127.0.0.1:3306/JAVA002?characterEncoding=utf8
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=username
log4j.appender.DATABASE.password=123
log4j.appender.DATABASE.sql=INSERT INTO log4j(DATE, THREAD, LEVEL, CLASS, MESSAGES) VALUES ('%d{yyyy-MM-dd HH:mm:ss}', '%t', '%p', '%l', '%m')

四、log4j与Commons-logging的结合

1.1.1           Commons-logging简介

Jakarta Commons Logging (JCL)提供的是一个日志(Log)接口(interface)，同时兼顾轻量级和不依赖于具体的日志实现工具。它提供给中间件/日志工具开发者一个简单的日志操作抽象，允许程序开发人员使用不同的具体日志实现工具。用户被假定已熟悉某种日志实现工具的更高级别的细节。JCL提供的接口，对其它一些日志工具，包括Log4J, Avalon LogKit, and JDK 1.4等，进行了简单的包装，此接口更接近于Log4J和LogKit的实现。

log4j与commons-logging两个包,都是记日志的,为什么要两个一起用呢? commons-logging是为"所有的Java日志实现"提供一个统一的接口,它自身的日志功能平常弱,而log4j功能非常强大全面,所以拿两者配合使用。

强调一点，“同时使用commons-logging和Log4j”，与“单独使用Log4j”相比，并不会带来更大的学习、配置和维护成本，反而更加简化了我们的工作。

1.1.2           Commons-logging工作原理

Commons-logging提供一个统一的日志接口，简单了操作，同时避免项目与某个日志实现系统紧密耦合，很贴心的帮开发者自动选择适当的日志实现系统，它甚至不需要配置。

commons-logging工作原理:

1. 首先在classpath下寻找自己的配置文件commons-logging.properties中当前factory中名叫org.apache.commons.logging.Log配置属性的值,如果找到,则使用其中定义的Log实现类。

2. 如果找不到commons-logging.properties文件,则在查找是否已定义系统环境变量org.apache.commons.logging.Log对应的值,找到则使用其定义的Log实现类。

建立一个叫 ：CATALINA_OPTS 的环境变量
给他的值 ： - Dorg.apache.commons.logging.Log = org.apache.commons.logging.impl.SimpleLog - Dorg.apache

.commons.logging.simplelog.defaultlog = warn

3. 查看classpath中是否有Log4j的包,如果发现,则自动使用Log4j作为日志实现类则，使用相关的包装(wrapper)类(Log4JLogger)。

4. 使用JDK自身的日志实现类(JDK1.4以后才有日志实现类) ，使用相关的包装类(Jdk14Logger)。

5. 使用commons-logging自己提供的一个简单的日志实现类SimpleLog 。

org.apache.commons.logging.Log的具体实现有如下：

-org.apache.commons.logging.impl.Jdk14Logger　 //使用JDK1.4。

-org.apache.commons.logging.impl.Log4JLogger　 //使用Log4J。

-org.apache.commons.logging.impl.LogKitLogger　//使用 avalon-Logkit。

-org.apache.commons.logging.impl.SimpleLog　

common-logging自带日志实现类。它实现了Log接口，把日志消息都输出到系统错误流System.err 中。 

-org.apache.commons.logging.impl.NoOpLog　common-logging自带日志实现类。它实现了Log接口。 其输出日志的方法中不进行任何操作。

总之，commons-logging总是能找到一个日志实现类,并且尽可能找到一个"最合适"的日志实现类。

1、可以不需要配置文件。

2、自动判断有没有Log4j包,有则自动使用之。

3、最悲观的情况下也总能保证提供一个日志实现(SimpleLog)。

为了简化配置commons-logging，一般不使用commons-logging的配置文件，也不设置与commons-logging相关的系统环境变量，而只需将Log4j的Jar包放置到classpash中就可以了。这样就很简单地完成了commons-logging与Log4j的融合。如果不想用Log4j了怎么办？只需将classpath中的Log4j的Jar包删除即可。

1.1.3           使用JCL开发

因为Log4j的强大，同时开发者又不希望对Log4j的依赖性太强。所以目前比较流行的是Commons-logging和Log4j结合使用。

1. 部署日志器

下载commons-logging.jar和log4j.jar包，能后把它们放到工程的lib目录下，引入工程中。

2. 指定日志器

在属性文件common-logging.properties中设置实现接口的类。如下(这里设置Log4j为所使用的日志包)：

#commons-logging.properties文件配置信息

#org.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog

# Must be one of ("trace", "debug", "info", "warn", "error", or "fatal").

#利用log4j为输出介质

org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JCategoryLog

#JDK5 Logger

#org.apache.commons.logging.Log=org.apache.commons.logging.impl.Jdk14Logger

3．org.apache.commons.logging.Log接口中定义的方法,按严重性由高到低的顺序有：

log.fatal(Object message);

log.fatal(Object message, Throwable t);

log.error(Object message);

log.error(Object message, Throwable t);

log.warn(Object message);

log.warn(Object message, Throwable t);

log.info(Object message);

log.info(Object message, Throwable t);

log.debug(Object message);

log.debug(Object message, Throwable t);

log.trace(Object message);

log.trace(Object message, Throwable t);

除此以外，还提供下列方法以便代码保护。

log.isFatalEnabled();

log.isErrorEnabled();

log.isWarnEnabled();

log.isInfoEnabled();

log.isDebugEnabled();

log.isTraceEnabled();

4．信息级别

确保日志信息在内容上和反应问题的严重程度上的恰当，是非常重要的。

1）fatal非常严重的错误，导致系统中止。期望这类信息能立即显示在状态控制台上。

2）error其它运行期错误或不是预期的条件。期望这类信息能立即显示在状态控制台上。

3）warn使用了不赞成使用的API、非常拙劣使用API, '几乎就是'错误, 其它运行时不合需要和不合预期的状态但还没必要称为 "错误"。期望这类信息能立即显示在状态控制台上。

4）info运行时产生的有意义的事件。期望这类信息能立即显示在状态控制台上。

5）debug系统流程中的细节信息。期望这类信息仅被写入log文件中。

6）trace更加细节的信息。期望这类信息仅被写入log文件中。

　　通常情况下，记录器的级别不应低于info.也就是说，通常情况下debug的信息不应被写入log文件中。