log4j配置及运用

Log4j支持两种配置文件格式，

• 一种是XML格式的文件
• 一种是Java特性文件log4j.properties（键=值）

log4j.properties配置文件

配置根Logger

Logger 负责处理日志记录的大部分操作。

语法：log4j.rootLogger = [ level ] , appenderName, appenderName, …

• level 是日志记录的优先级，Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。例如在这里定义了INFO级别，只有等于及高于这个级别的才进行处理，则应用程序中所有DEBUG级别的日志信息将不被打印出来。
• appenderName就是指定日志信息输出到哪个地方。可同时指定多个输出目的地。
  例如：log4j.rootCategory=INFO, stdout , R

配置日志信息输出目的地 Appender

Appender 负责控制日志记录操作的输出。

定义输出端是哪种类型，可以是
（1）org.apache.log4j.ConsoleAppender（控制台），
（2）org.apache.log4j.FileAppender（文件），
（3）org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
（4）org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）
（5）org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

例如：log4j.appender.stdout=org.apache.log4j.ConsoleAppender
定义一个名为stdout的输出目的地，ConsoleAppender为控制台。

配置日志信息的格式（布局）Layout

Layout 负责格式化Appender的输出。

定义输出端的layout是哪种类型，可以是
（1）org.apache.log4j.HTMLLayout（以HTML表格形式布局），
（2）org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
（3）org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
（4）org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

格式化日志

使用pattern布局就要指定的打印信息的具体格式，参数如下：

• %m 输出代码中指定的消息；
• %M 输出打印该条日志的方法名；
• %p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL；
• %r 输出自应用启动到输出该log信息耗费的毫秒数；
• %c 输出所属的类目，通常就是所在类的全名；
• %t 输出产生该日志事件的线程名；
• %n 输出一个回车换行符，Windows平台为"rn”，Unix平台为"n”；
• %d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyyy-MM-dd HH:mm:ss,SSS}，输出类似：2002-10-18 22:10:28,921；
• %l 输出日志事件的发生位置，及在代码中的行数；
• [QC]是log信息的开头，可以为任意字符，一般为项目简称。

例如：log4j.appender.stdout.layout.ConversionPattern= [QC] %p [%t]
%C.%M(%L) | %m%n
打印：[TS] DEBUG [main] AbstractBeanFactory.getBean(189)
| Returning cached instance of singleton bean ‘MyAutoProxy’

举例：

• log4j.appender.R=org.apache.log4j.DailyRollingFileAppender
  定义名为R的输出端的类型为每天产生一个日志文件。
• log4j.appender.R.File=D:\Tomcat 5.5\logs\qc.log
  此句为定义名为R的输出端的文件名为D:\Tomcat 5.5\logs\qc.log可以自行修改
• log4j.logger.com. neusoft =DEBUG
  指定com.neusoft包下的所有类的等级为DEBUG。可以把com.neusoft改为自己项目所用的包名。

应用记录器的层次

任何一个记录器的使用都有两个步骤：
1、在配置文件中定义相应的记录器，在配置文件中定义记录器的格式有两种：
(1)定义根记录器的格式为
log4j.rootLogger = [ level ], appendName1, appendName2, …appendNameN
(2)定义一个非根记录器的格式为

log4j.logger.loggerName1 = [ level ], appendName1,…appendNameN

可以定义任意个非根记录器。
2、在代码中调用Logger类的取得记录器方法取得相应的记录器对象：

• 要取得根记录器对象可通过Logger.getRootLogger()函数
• 要取得非根记录器可通过Logger.getLogger()函数

运用

在需要输出日志信息的类中做如下的三个工作：
1、导入所有需的commons-logging类：
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;

2、在自己的类中定义一个org.apache.commons.logging.Log类的私有静态类成员：
private final Log log = LogFactory.getLog(getClass());
LogFactory.getLog()方法的参数使用的是当前类的class。

3、使用org.apache.commons.logging.Log类的成员方法输出日志信息：