log4j框架logger的继承关系以及使用场景

log4j框架logger的继承关系以及使用场景

log4j日志框架logger是存在继承关系的，我们一般都会在log4j.properties文件中定义log4j.rootLogger。其他所有logger都继承自这个rootLooger。考虑下面这种场景：假如我们有2个类HelloLog4j和A。

1. package aty.log;
2. import org.apache.log4j.Logger;
3. import aty.log.service.A;
4. public class HelloLog4j {
5. private static Logger logger = Logger.getLogger(HelloLog4j.class);
6. public static void main(String[] args) {
7. logger.debug("log in main.");
8. new A().run();
9. }
10. }

1. package aty.log.service;
2. import org.apache.log4j.Logger;
3. public class A {
4. private static Logger logger = Logger.getLogger(A.class);
5. public void run() {
6. logger.error("log in A.java");
7. }
8. }

log4j.properties文件配置如下：

1. #rootLogger can print DEBUG to console
2. log4j.rootLogger=debug, console
3. log4j.appender.console=org.apache.log4j.ConsoleAppender
4. log4j.appender.console.Threshold=debug
5. log4j.appender.console.ImmediateFlush=true
6. log4j.appender.console.Target=System.err
7. log4j.appender.console.layout=org.apache.log4j.PatternLayout

运行HelloLog4j.java控制台日志如下：可以看到这2个类使用的logger都是rootLogger。

现在我们有这个需求：让A.java中日志的打印到单独的a.log日志文件中，而HelloLog4j中的日志还是打印到控制台。也就是说：我们想让A和HelloLog4j这2个类使用不同的logger。java代码不用修改，我们将log4j.properties修改如下：

1. #rootLogger can print DEBUG to console
2. log4j.rootLogger=debug, console
3. log4j.appender.console=org.apache.log4j.ConsoleAppender
4. log4j.appender.console.Threshold=debug
5. log4j.appender.console.ImmediateFlush=true
6. log4j.appender.console.Target=System.err
7. log4j.appender.console.layout=org.apache.log4j.PatternLayout
8. log4j.appender.console.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss,SSS}]-[%t]-[%X{ip}]-[%l]-[%p] %m%n
9. #A.java is special.we use a individual appender for it.
10. #A class's full qulified qualified name is logger's name.
11. log4j.logger.aty.log.service.A=DEBUG, testA
12. log4j.appender.testA=org.apache.log4j.FileAppender
13. log4j.appender.testA.Threshold=warn
14. log4j.appender.testA.ImmediateFlush=true
15. log4j.appender.testA.Append=true
16. log4j.appender.testA.File=c:/a.log
17. log4j.appender.testA.layout=org.apache.log4j.PatternLayout
18. log4j.appender.testA.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss,SSS}]-[%t]-[%X{ip}]-[%l]-[%p] %m%n
19. #avoid print to parent logger.
20. log4j.additivity.aty.log.service.A= false

再次运行HelloLog4j可以看到：A.java中的日志并没有打印到控制台上，而是打印到了a.log文件中。

我们来解释下上面的配置：

log4j.logger.aty.log.service.A=DEBUG, testA    我们用A的全类名定义了一个logger。

log4j.additivity.aty.log.service.A= false     避免日志打印到rootLogger中。如果这里设置成true，那么A.java中的日志既会打印到控制台上，也会打印到a.log文件中。

现在我们可以介绍下logger的继承关系了，比如我们上面的类aty.log.service.A中使用了logger来写日志。那么log4j会先查找名称是"aty.log.service.A"的logger，如果没有找到，向上查找名称是"aty.log.service"的logger，如果还没有找到那么继续向上查找，查找的最顶层就是rootLogger。这就是log4j中logger的继承关系。rootLogger一定要在配置，其他特定类或者特定包的logger可以不用配置。知道了这个继承特性之后，如果我们要aty.log.dao包下所有的类都打印到同一个日志文件，那么可以进行如下配置。

1. # a package appender
2. log4j.logger.aty.log.dao=DEBUG, daoAppender
3. log4j.appender.daoAppender=org.apache.log4j.FileAppender
4. log4j.appender.daoAppender.Threshold=warn
5. log4j.appender.daoAppender.ImmediateFlush=true
6. log4j.appender.daoAppender.Append=true
7. log4j.appender.daoAppender.File=c:/dao.log
8. log4j.appender.daoAppender.layout=org.apache.log4j.PatternLayout
9. log4j.appender.daoAppender.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss,SSS}]-[%t]-[%X{ip}]-[%l]-[%p] %m%n
10. log4j.additivity.aty.log.dao= false

可以看到：利用logger的继承特性，我们可以很容易将不同的日志打印到不同的文件中，这样可以避免各种日志混杂在一起。如果我们想将A.java中有的日志打印到a.log中，有的日志打印到控制台上也是可以的。

1. package aty.log.service;
2. import org.apache.log4j.Logger;
3. public class A {
4. private static Logger logger = Logger.getLogger(A.class);
5. private static Logger rootLogger = Logger.getRootLogger();
6. public void run() {
7. logger.error("log in A.java");
8. rootLogger.error("a to console.");
9. }
10. }

最后提一下：log4j默认是使用类名或者包名来查找logger的。log4j允许我们自己定义logger的名称。

1. package aty.log.service;
2. import org.apache.log4j.Logger;
3. public class A {
4. private static Logger logger = Logger.getLogger("atyAlogger");
5. public void run() {
6. logger.error("log in A.java");
7. }
8. }

1. #use atyAlogger as appender name.
2. log4j.logger.atyAlogger=DEBUG, testA
3. log4j.appender.testA=org.apache.log4j.FileAppender
4. log4j.appender.testA.Threshold=warn
5. log4j.appender.testA.ImmediateFlush=true
6. log4j.appender.testA.Append=true
7. log4j.appender.testA.File=c:/a.log
8. log4j.appender.testA.layout=org.apache.log4j.PatternLayout
9. log4j.appender.testA.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss,SSS}]-[%t]-[%X{ip}]-[%l]-[%p] %m%n
10. #avoid print to parent logger.
11. log4j.additivity.atyAlogger= false

一般来说，我们都是使用默认的名称，这样虽然将类名和包名在log4j.properties写死了。但是方便java类里面获取logger。因为各个类都是根据自己类的全限定名来查找logger的，具体日志到底打印到哪里去，由配置文件决定。