log4j使用

                           

　　类图镇楼

 

                          

 

 

1.先谈部署

　　别怕，这可不是部署Tomcat。把log4j的包和commons-logging的包（加在一起才两个）放到classpath下面。然后把配置文件保存为log4j.properties，也放在classpath下面（如果用Eclipse的话，放在src目录下即可）。然后你就可以跑了。

 

2.再谈配置

　　虽然可以用xml或者在运行时用Java来配置Log4j，但还是properties文件好用啊！

　　样例：

#日志级别DEBUG，目的地consoleAppender1,这是根日志组件，经测试，mybatis的SQL输出收这个影响
log4j.rootLogger=DEBUG,consoleAppender1,debugfile

#--------------配置  输出对象的目的  格式 -----------------
#目的地consoleAppender1输出到控制台
log4j.appender.consoleAppender1=org.apache.log4j.ConsoleAppender
#目的地consoleAppender1输出格式
log4j.appender.consoleAppender1.layout=org.apache.log4j.PatternLayout
log4j.appender.consoleAppender1.layout.ConversionPattern=%5p %d  %C: %m%n

#debug 输出错误日志文件
log4j.appender.errorfile=org.apache.log4j.RollingFileAppender
log4j.appender.errorfile.File=${catalina.home}/logs/outside-error.log //${catalina.home} : tomcat服务器文件夹目录

log4j.appender.errorfile.MaxFileSize=10240KB
# Keep three backup files.
log4j.appender.errorfile.MaxBackupIndex=3
# Pattern to output: date priority [category] - message
log4j.appender.errorfile.layout=org.apache.log4j.PatternLayout
log4j.appender.errorfile.layout.ConversionPattern=%d %p - %m%n
log4j.additivity.errorfile = false

#debug 输出其他日志文件
log4j.appender.debugfile=org.apache.log4j.RollingFileAppender
log4j.appender.debugfile.File=${catalina.home}/logs/outside-debug.log

log4j.appender.debugfile.MaxFileSize=10240KB
# Keep three backup files.
log4j.appender.debugfile.MaxBackupIndex=10
# Pattern to output: date priority [category] - message
log4j.appender.debugfile.layout=org.apache.log4j.PatternLayout
log4j.appender.debugfile.layout.ConversionPattern=%d %p - %m%n
log4j.additivity.debugfile = false

#--------------配置  具体内容输出到  输出对象------------------------------
#日志级别DEBUG，目的地consoleAppender2,和debugfile
log4j.logger.service=DEBUG,debugfile
#spring统一异常处理，日志级别ERROE，目的地consoleAppender2,和errorfile
log4j.logger.util.web.CustomSimpleMappingExceptionResolver=info,errorfile
#spring统一异常处理，日志级别ERROE，目的地consoleAppender2,和errorfile
log4j.logger.util.web.ExceptionAdvisor=info,errorfile
#mongodb，日志级别DEBUG，目的地consoleAppender1,和debugfile
log4j.logger.common.mongodb.service.FileOptService=DEBUG,consoleAppender1,debugfile
#指定SQL 输出
#log4j.logger.java.sql.ResultSet=INFO,consoleAppender1
log4j.logger.org.apache=ERROR,errorfile
#log4j.logger.java.sql.Connection=DEBUG,debugfile
#log4j.logger.java.sql.Statement=DEBUG,consoleAppender2
#log4j.logger.java.sql.PreparedStatement=DEBUG,debugfile
#输出sql到文件
#处理Spring,mybatis错误级别日志的写到异常文件
log4j.logger.org.springframework=ERROR,errorfile
log4j.logger.org.mybatis=ERROR,errorfile
#cxf
log4j.logger.org.apache.cxf=info,consoleAppender1,debugfile

#不附加，作用就是 避免重复打印
log4j.additivity.controller=false
log4j.additivity.service=false
log4j.additivity.dao=false
log4j.additivity.org.apache.cxf=false
log4j.additivity.common.mongodb.service.FileOptService=false

 

　　配置分析：

　　1>. 最最重要的两个概念：Logger（继承层次）和Appender（输出控制）；（请参考Log4J手册）

　　2>. rootLogger 总是存在于log4j中，即使没有显示配置也是存在的，并且默认输出级别为DEBUG；

　　3>. ConsoleAppender 输出到控制台；RollingFileAppender 输出到指定路径下的文件中；两者为log4j中的类，都实现了Appender类；

　　4>. File，MaxBackupIndex(保留文件数量)，layout，MaxFileSize 皆为设置的属性；

　　5>. additivity 限制appender的叠加性，使同一输出不至于多次输出；

　　6>. logger 为 rootLogger 的子集，可以自定义子集的输出级别。

　　7>.输出级别越低，输出的数量更多；级别更高，就不会输出低级别的日志；

 

　　日志级别：

　　　　TRACE->DEBUG-> INFO-> WARN->ERROR->FATAL

 

　　图一：

　　

 

　　图二：

　　

 

　　输出格式：

　　　　

 

　

3.谈下思想

　　思想：Log4j真的很简单，简单到令人发指的地步。不是要记录日志吗？那就给你一个Log，然后你用Log来写东西就行了；

 

　　Log.class中输出级别对应的方法

　　　　

 

　　样例

package test;

import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;

public class Test {

        static Log log = LogFactory.getLog(Test.class);//这里的“Test.class”事实上传进去的是Test这个类的完整路径（包名+类名），“test.Test” 这样如果存在“test”这个Log那么Test这个Log就继承它，否则就继承rootLogger

        public void log(){

           log.debug("Debug info.");

           log.info("Info info");

           log.warn("Warn info");

           log.error("Error info");

           log.fatal("Fatal info");

        }

        /**

         * @param args

         */

        public static void main(String[] args) {

           Test test = new Test();

           test.log();

        }

}

 

　　

 

4.默认的log4j初始化过程

　　Logger类的静态初始化块(static initialization block)中对log4j的环境做默认的初始化。

　　* 如果程序员已经通过设置系统属性的方法来配置了log4j环境，则不需要再显式地调用XXXConfigurator.configure()方法来配置log4j环境了。

 

　　Logger的静态初始化块在完成初始化过程时将检查一系列log4j定义的系统属性。它所做的事情如下：

　　　　1>. 检查系统属性log4j.defaultInitOverride，如果该属性被设置为false，则执行初始化；否则（只要不是false，无论是什么值，甚至没有值，都是否则），跳过初始化。

　　　　2>. 把系统属性log4j.configuration的值赋给变量resource。如果该系统变量没有被定义，则把resource赋值为"log4j.properties"。注意：在apache的log4j文档中建议使用定义log4j.configuration系统属性的方法来设置默认的初始化文件是一个好方法。

　　　　3>. 试图把resource变量转化成为一个URL对象url。如果一般的转化方法行不通，就调用org.apache.log4j.helpers.Loader.getResource(resource, Logger.class)方法来完成转化。

　　　　4>. 如果url以".xml"结尾，则调用方法DOMConfigurator.configure(url)来完成初始化；否则，则调用方法PropertyConfigurator.configure(url)来完成初始化。如果url指定的资源不能被获得，则跳出初始化过程。

 

　5.Logger 两点说明

　　1>. 用同名参数调用Logger.getLogger(String name)将返回同一个logger的引用。故可以在一个地方配置logger，在另外一个地方获得配置好的logger，而无须相互间传递logger的引用。

　　2>. logger的创建可以按照任意的顺序，即，父logger可以后于子logger被创建。log4j将自动维护logger的继承树。

 

 

参考资料：

1>.  http://www.cnblogs.com/Fskjb/archive/2011/01/29/1947592.html

2>.  https://logging.apache.org/log4j/2.x/manual/architecture.html

3>.  http://www.cnblogs.com/suman/archive/2010/10/23/1858864.html