Log4j由三个重要的组件构成:日志信息的优先级,日志信息的输出目的地,日志信息的输出格式。
1、日志信息的优先级(level)值可以是: OFF(关闭)FATAL(致命的) ERROR(错误)WARN(警告) INFO(信息)DEBUG (调试) ALL(所有)。Log4j建议只使用四个级别,优先级从高到低有ERROR、WARN、 INFO、DEBUG,分别用来指定这条日志信息的重要程度;
如果logger的Level设置为INFO,那么系统只输出INFO以及以上(WARN、ERROR、FATAL)信息。
如果当前logger没有设定Level,那么它在输出日志时采用的策略是:它会使用它继承的Logger的Level作为它自己的Level来处理。如果它的上级也没有设置Level,那么就找上上级,几次类推,直到root为止,(root的Level是不能设为空的,所以最终一定会找到一个Level)。默认root的Level是INFO,其他logger的Level默认都是null,需要手动指定。
配置根Logger,其语法为:
log4j.rootLogger = [ level ] , appenderName, appenderName, …
2、日志信息的输出目的地(Appender)指定了日志将打印到控制台还是文件中;其语法为:
log4j.appender.appenderName = fully.qualified.name.of.appender.class
log4j.appender.appenderName.option1 = value1
log4j.appender.appenderName.Threshold = INFO;输出Info级别以上的信息
Log4j提供的appender有以下几种:
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
特殊的地方:
log4j.additivity 是 子Logger 是否继承父Logger 的 输出源(appender)的标志位。具体说,默认情况下,子Logger 会继承父Logger 的appender,也就是说 子Logger 会在父Logger 的appender里输出。若是additivity设为false,则子Logger 只会在自己的appender里输出,而不会在父Logger 的appender里输出。如果不想继承上级的Level,那么可以设置(additivity和logger要同时设置)
log4j.additivity.MyLogger = false
log4j.logger.MyLogger =[ level ] , appenderName, appenderName…
这样,MyLogger 的日志只输出到指定的appender,而不继承父类的appender.
3、而输出格式(layout)则控制了日志信息的显 示内容。其语法为:
log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
log4j.appender.appenderName.layout.option1 = value1
Log4j提供的layout有以下几种:
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
4、Log4J采用类似C语言中的printf函数的打印格式格式化日志信息:
%m 输出代码中指定的消息
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符,Windows平台为“rn”,Unix平台为“n”
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main(TestLog4.java:10)
实例测试
1、在maven中导入依赖包
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
2、项目结构
3、配置文件
3.1、资源没有设置级别,那按照root级别,如果资源已经配置级别,那按照级别输出:
#配置根Logger
log4j.rootLogger=debug,stdout,MyApp01,MyApp02
##输出信息到控制台
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
###默认就是System.out,另外一个值是System.error
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%c:%t:%r] - [%p] %m%n
##输出debug级别日志到文件
log4j.appender.MyApp01=org.apache.log4j.DailyRollingFileAppender
log4j.appender.MyApp01.File=E:/dataTest/logDebug.log
#默认就是true,系统启动时追加至文件中,否则会覆盖原有内容
log4j.appender.MyApp01.Append=true
##输出debug级别以上的信息
log4j.appender.MyApp01.Threshold=INFO
log4j.appender.MyApp01.layout=org.apache.log4j.PatternLayout
log4j.appender.MyApp01.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%c:%t:%r] - [%p] %m%n
##输出ERROR级别日志到文件
log4j.appender.MyApp02=org.apache.log4j.DailyRollingFileAppender
log4j.appender.MyApp02.File=E:/dataTest/logError.log
log4j.appender.MyApp02.Append=true
log4j.appender.MyApp02.Threshold=error
log4j.appender.MyApp02.layout=org.apache.log4j.PatternLayout
log4j.appender.MyApp02.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} [%c:%t:%r] - [%p] %m%n
控制台结果:
文件logDebug.log结果
文件logerror.log结果
3.2为某个资源单独配置输出目的地,并且不使用继承父级别的输出
#可以设置指定资源的输出目的地,只会输出该资源的设定的日志以上级别
log4j.additivity.AgainLog4jTest=false
log4j.logger.AgainLog4jTest=warn,stdout,MyApp01
不继承,控制窗口输出:
如果继承父级别的输出,结果会是:
参考文章:
http://liuzhijun.iteye.com/blog/1746571
http://www.codeceo.com/article/log4j-usage.html
http://blog.youkuaiyun.com/finelife/article/details/1613282