前言
log4j其实是一个非常普遍和常用的一个apache的日志记录工具。虽然一直都在使用,但是还没真自己写过,昨天跟朋友讨论到了日志,于是今天又将log4j的语法什么的看了一遍。今天就主要跟大家分享下最常用的log4j.properties和log4j.xml。
正题
1. 配置
log4j.properties是我们以前比较常用的一种配置文件,它使用起来比较简单方便,我们先来看下它的配置:
<span style="font-family:KaiTi_GB2312;font-size:18px;"># 将根日志级别设为INFO,文件输出到两个位置,ERRORFILE和WELCOMEFILE.
log4j.rootLogger=INFO, ERRORFILE,WELCOMEFILE
# 将ERRORFILE的输出端设置为控制台输出,而WELCOMEFILE则输出到名为welcome.log的文件.
log4j.appender.ERRORFILE=org.apache.log4j.ConsoleAppender
log4j.appender.WELCOMEFILE=org.apache.log4j.RollingFileAppender
log4j.appender.WELCOMEFILE.File=welcome.log
# 设置ERRORFILE的输出端模式和显示的信息
log4j.appender.ERRORFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ERRORFILE.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n
log4j.appender.WELCOMEFILE.layout=org.apache.log4j.PatternLayout
log4j.appender.WELCOMEFILE.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n
# 将com.dan.test包下的日志级别设置为DEBUG,并输出到welcome.log文件
log4j.logger.com.dan.test=DEBUG, WELCOMEFILE</span>
2. 配置详解
上面的小段配置文件中已经解释了每个设置的意图,下面我再将比较细致的解释说明下:
1) log4j.rootLogger=INFO, ERRORFILE,WELCOMEFILE
此句为将等级为INFO的日志信息输出到ERRORFILE和WELCOMEFILE这两个目的地,WELCOMEFILE和WELCOMEFILE的定义在下面的代码,可以任意起名。等级可分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL,如果配置OFF则不打出任何信息,如果配置为INFO这样只显示INFO, WARN, ERROR的log信息,而DEBUG信息不会被显示。
2) log4j.appender.ERRORFILE=org.apache.log4j.ConsoleAppender
此句为定义名为ERRORFILE的输出端是哪种类型,可以是
org.apache.log4j.ConsoleAppender(控制台),
org.apache.log4j.FileAppender(文件),
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)
org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)
3) log4j.appender.ERRORFILE.layout=org.apache.log4j.PatternLayout
此句为定义名为stdout的输出端的layout是哪种类型,可以是
org.apache.log4j.HTMLLayout(以HTML表格形式布局),
org.apache.log4j.PatternLayout(可以灵活地指定布局模式),
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)
4) log4j.appender.stdout.layout.ConversionPattern= [QC] %p [%t] %C.%M(%L) | %m%n
如果使用pattern布局就要指定的打印信息的具体格式ConversionPattern,打印参数如下:
%m 输出代码中指定的消息
%p 输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL
%r 输出自应用启动到输出该log信息耗费的毫秒数
%c 输出所属的类目,通常就是所在类的全名
%t 输出产生该日志事件的线程名
%n 输出一个回车换行符,Windows平台为“rn”,Unix平台为“n”
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyyy MMM dd HH:mm:ss,SSS},输出类似:2015年04月30日 12:10:28,921
%l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。
[QC]是log信息的开头,可以为任意字符,一般为项目简称。
输出的信息
[TS] DEBUG [main] com.dan.test.TestClass - debug msg
5) log4j.appender.WELCOMEFILE.File=welcome.log
此句为定义名为WELCOMEFILE的输出端的文件名为welcome.log可以自行修改。
6) log4j.logger.com.dan.test=DEBUG, WELCOMEFILE
指定com.dan.testt包下的所有类的等级为DEBUG的日志信息输出到WELCOMEFILE指定的文件,
可以把
com.dan.test
改为自己项目所用的包名。
小结:
日志在我们项目里面起到了很重要的作用,有助于帮助我们分析问题,如果我们能够灵活的对日志进行配置,会大大提高我们解决问题的效率。