log4j.properties详解

fpcm 10年前

前言

    log4j其实是一个非常普遍和常用的一个apache的日志记录工具。虽然一直都在使用,但是还没真自己写过,昨天跟朋友讨论到了日志,于是今天又将 log4j的语法什么的看了一遍。今天就主要跟大家分享下最常用的log4j.properties和log4j.xml。


正题
    1. 配置
    log4j.properties是我们以前比较常用的一种配置文件,它使用起来比较简单方便,我们先来看下它的配置:
# 将根日志级别设为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

    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改为自己项目所用的包名。

小结:
    日志在我们项目里面起到了很重要的作用,有助于帮助我们分析问题,如果我们能够灵活的对日志进行配置,会大大提高我们解决问题的效率。
</div>