Log4j

1. Log4j 实在是很熟悉，几乎所有的 Java 项目都用它啊。但是我确一直没有搞明白。终于有一天我受不了了，定下心去看了一把文档，才两个小时，我终于搞明白了。一般情况下 Log4j 总是和 Apache Commons-logging 一起用的，我也就一起介绍吧。多了个东西不是更麻烦，而是更简单！   
2.   
3.   
4. <!--[if !supportLists]-->一、<!--[endif]-->Log4j的简单思想  
5.   
6. Log4j 真的很简单，简单到令人发指的地步。不是要记录日志吗？那就给你一个 Log ，然后你用 Log 来写东西就行了，先来一个完整类示例：   
7.   
8. package test;   
9.   
10. import org.apache.commons.logging.Log;   
11.   
12. import org.apache.commons.logging.LogFactory;   
13.   
14. public class Test {   
15.   
16.         static Log log = LogFactory.getLog(Test. class );  
17.         //protected final Log log = LogFactory.getLog(this.getClass());  
18.   
19.   
20.         public void log(){   
21.   
22.            log .debug( "Debug info." );   
23.   
24.            log .info( "Info info" );   
25.   
26.            log .warn( "Warn info" );   
27.   
28.            log .error( "Error info" );   
29.   
30.            log .fatal( "Fatal info" );   
31.   
32.         }   
33.   
34.         /**  
35.  
36.            * @param args  
37.  
38.            */   
39.   
40.         public static void main(String[] args) {   
41.   
42.            Test test = new Test();   
43.   
44.            test.log();   
45.   
46.         }   
47.   
48. }   
49.   
50.   
51. 别怕，看完这篇文章你就会觉得很简单了。   
52.   
53.         Log4j 默认把日志信息分为五个等级   
54.   
55.         debug < info < warn < error < fatal   
56.   
57. 虽然可以自己添加等级，但是我觉得没有必要，五个够用了吧！你要写入信息的时候就把信息归为五个等级中的一个，然后调用相应的函数即可。   
58.   
59.   
60.     分五个等级到底有什么用呢？日志信息到底写到哪里去了？   
61.   
62.     “ LogFactory.getLog(Test. class ) ”又是什么意思捏？接着往下看吧！   
63.   
64.   
65. Log4j 的关键之处在于它的继承思想。也就是一个 Log 可以继承另外一个 Log 的属性（输出到哪里，日志等级，日志格式等等）。怎么继承？   
66.   
67. Log4j 是根据 Log 的名字来判断继承关系的，比如：   
68.   
69. 名字为“ com.zhlmmc.lib ”的 Log 就是“ com.zhlmmc.lib.log ”的 parent ，明白了吧！ Log4j 还有一个 rootLogger ，相当于 Java 的 Object 。   
70.   
71. 回过头来看“ LogFactory.getLog(Test. class ) ”这里的“ Test. class ”事实上传进去的是 Test 这个类的完整路径（包名 + 类名），“ test.Test ”。这样如果存在“ test ”这个 Log 那么 Test 这个 Log 就继承它，否则就继承 rootLogger 。   
72.   
73.   
74.     那具体的 Log 属性是在哪里定义的呢？   
75.   
76.   
77. <!--[if !supportLists]-->二、<!--[endif]-->常见的配置文件  
78.   
79. 虽然可以用 xml 或者在运行时用 Java 来配置 Log4j ，但还是 properties 文件好用啊！   
80.   
81. log4j.rootLogger= info, stdout   
82.   
83. log4j.appender.stdout= org.apache.log4j.ConsoleAppender   
84.   
85. log4j.appender.stdout.layout= org.apache.log4j.PatternLayout   
86.   
87. # Pattern to output the caller's file name and line number.   
88.   
89. log4j.appender.stdout.layout.ConversionPattern= %5p [%t] (%F : %L) - %m%n   
90.   
91.   
92. 分析一下：   
93.   
94. 第一行，配置 log4j.rootLogger 你明白吧。应为它是根，总得配置一下，否则别的 Log 继承什么啊。其他的 Log 可以配置也可以不配置。等号后面的第一个参数表示日志级别，可以填五个级别中的一种，后面的参数都是让 Log 知道输出到哪里，如果你想让日志输出到两个地方就加两个输出参数，比如：   
95.   
96.   
97. log4j.rootLogger= info, stdout, file   
98.   
99.   
100. 这里的 info 表示，该 Log 的日志级别为 info ，所有级别小于 info 的日志都不会被记录。比如使用这个配置文件的话，我刚开始举的那个类中   
101.   
102.   
103. log .debug( "Debug info." );   
104.   
105.   
106. 这句话是不起作用的，因为 debug 的级别小于 info 。这样就很容易控制什么信息在调试的时候要显示，什么信息在发布的时候要去掉。这些都不用改代码，很方便吧。   
107.   
108.   
109. 但， stdout 和 file 又是什么呢？   
110.   
111. 接着往下看，就是配置 stdout 了，这个名字是随便取的，你可以叫它 A ：   
112.   
113.   
114. log4j.appender.A= org.apache.log4j.ConsoleAppender   
115.   
116.   
117. 那么上面的 rootLogger 的参数 stdout 也要改成 A ，其他用到的地方当然也要改。这里的关键不是名字，而是 appender 类型，比如这里的“ ConsoleAppender ”，看明白了吧，输出到 Console 。后面两行都是设置日志格式的，一般情况下你就照抄吧。既然是最简入门关注于理解 Log4j 的工作原理，我就不介绍 file 类型的 appender 了，一搜一大把。   
118.   
119.   
120. 在实际的项目开发中，很可能遇到所引用的包用 Log4j 来记录日志，比如 Hibernate 。那么在这里你可以很容易的控制这个包如何记录日志。比如在上面的配置文件中加一行：   
121.   
122.   
123. log4j.logger.org.hibernate= fatal   
124.   
125.   
126.     那么所有 org.hibernate 包下面的类就只会显示很少的信息，因为 fatal 的级别最高啊。   
127.   
128.   
129. <!--[if !supportLists]-->三、<!--[endif]-->部署  
130.   
131. 别怕，这可不是部署 Tomcat 。把 log4j 的包和 commons-logging 的包（加在一起才两个）放到 classpath 下面。然后把配置文件保存为 log4j.properties ，也放在 classpath 下面（如果用 Eclipse 的话，放在 src 目录下即可）。然后你就可以跑了。