一、日志实例
上图是log4j核心类图
创建Logger实例:
使用log4j的日志功能时,首先需要创建一个Logger类的实例,才能使用打印日志的功能:
Logger logger = Logger.getLogger(Test.class);
Logger类中getLogger()方法的实现是:
static public Logger getLogger(Class clazz) {
return LogManager.getLogger(clazz.getName());
}
实际上使用 LogManager.getLogger(Test.class)获取Logger实例
通过实现方式可以看到最后还是使用了Test类的全限定类名去获取Logger实例,实际上,完全可以直接传递Test类的全限定类名,这里是com.xgd.Test,来构建一个Logger实例:
Logger logger = Logger.getLogger("com.xgd.Test");
com.xgd.Test就是这个日志实例的实例名。
日志实例指定appender:
创建好了日志实例,还需要给该实例关联一个Appender(如上类图),才能将通过该实例打印的日志输出到制定Appender中。
在log4j的properties配置中,可以使用log4j.logger后加上日志实例名来指定一个日志实例,并进行输出配置,如:
log4j.logger.com.xgd.Test=debug, console
#console是名为console的appender,给名为com.xgd.Test的日志实例指定了输出目的地appender
在log4j的xml的配置方式为:
<logger name="实例名"> <!--com.xgd.Test-->
<level value=""/>
<appender-ref ref="AppenderName" />
</logger>
二、继承与覆盖
继承性:
log4j的配置中有一个根logger:rootLogger/root,其配置为:
log4j.rootLogger=DEBUG,consoleAppender
或者是:
<root>
<priority value="debug" />
<appender-ref ref="CONSOLE" />
</root>
隐式继承:
root配置决定了所有日志实例打印日志都必须遵守的规则——日志级别以及输出目的地,也即是说所有的日志实例继承了rootLogger/的输出配置,即appender和输出级别。root配置就像java中的Object类一样,任何日志实例都默认“继承”于root,以使得所有日志实例具有root的特性。
显式继承:
日志实例名或配置logger时使用了英文句号 . 作为分隔名称,那么日志实例的世界就精彩了起来,“.” 的出现使日志实例具有了显示继承性,通过使用“.”,我们可以
log4j.logger.parent = Console, debug (实例名parent)
那么,
private static final Logger logger= Logger.getLogger("parent.child");
实例名为parent.child的日志实例,其打印出来的日志具有名为parent的日志实例的特性,日志级别为debug,输出目的地为console。子日志实例(parent.child)继承了父日志实例(parent)。
日志实例的继承有以下特性:
1)输出级别的覆盖:
如下配置:
log4j.rootLogger=DEBUG, Console
以下子日志实例的日志输出级别覆盖了父logger实例
log4j.logger.parent=INFO
那么
private static final Logger logger= Logger.getLogger("parent");
名为parent的日志实例,打印出来的日志具有info级别而不是debug级别,缩减了日志的级别范围。
同样,扩大了父logger实例的日志级别的子logger实例也会造成覆盖
log4j.rootLogger=INFO, Console
#以下配置的logger,重写了日志输出级别
log4j.logger.parent=DEBUG
无论子logger实例扩大还是缩减了父logger实例的日志级别,都会造成对父logger实例日志级别的覆盖。
2)输出目的地的追加:
如下配置:
<logger name="third">
<level value="info" />
<appender-ref ref="Console" />
</logger>
<root>
<level value= "trace" />
<appender-ref ref= "Console" />
</root>
那么继承自名为third的日志实例会输出两次的info级别以上的日志信息,不同于子logger实例对父logger实例输出日志级别的覆盖,子logger实例 的appender配置会在父logger实例的基础上追加。
就像这样:
3)放弃追加
additivity,添加的意思。
additivity属性用于屏蔽对父logger实例appender的追加,通过设置子实例logger的additivity属性为false,使子logger屏蔽掉父logger的appender。
如下配置:
<logger name="third" additivity="false" >
<level value="info" />
<appender-ref ref="fileappende" />
</logger>
<root>
<level value= "trace" />
<appender-ref ref= "Console" />
</root>
则继承自名为third的日志实例打印的日志不会输出到父日志实例中指定的appender(Console),只输出到fileappender中。
当然,若子logger实例没有指定appender,并且指定了additivity为false,那么在打印日志时,会找不到输出目的地appender,从而产生异常。
如以下third没有指定appender,且放弃追加root实例的appender
<logger name="third" additivity="false" >
<level value="info" />
</logger>
<root>
<level value= "trace" />
<appender-ref ref= "Console" />
</root>
使用继承自third的日志实例输出日志,会报错:
log4j:WARN No appenders could be found for logger (third.log.CommonsLogTest).