Log4j使用说明文档.docVIP

文档编号：SINOSOFT-001 Log4j使用说明文档 中科软科技股份有限公司 寿险事业部 2009年01月 目 录 1 Log4j简介 3 1.1 简介 3 2 原理说明 3 2.1 记录器Logger 3 2.2 打印方法和级别 4 3 配置方法 4 4 配置文件说明 7 5 Log4j配置详解 8 5.1 定义配置文件 8 5.2 格式化日志信息 10  Log4j简介 简介 我们在编程时经常不可避免地要使用到一些日志操作，比如开发阶段的调试信息、运行时的日志记录及审计。调查显示，日志代码占代码总量的4％。通常大家可以简单地使用System.out.println()语句输出日志信息，但是在发布时，通常不想在正式的版本中打印这些开发时的调试信息，于是又要手工地把这些语句删除，所以大量的这样的System.out.println()调试语句会带来麻烦。Log4j是Apache软件基金会Jakarta项目下的一个子项目，是用Java编写的优秀日志工具包。通过Log4可以在不修改代码的情况下，方便、灵活地控制任意粒度的日志信息的开启或关闭，然后使用定制的格式，把日志信息输出到一个或多个需要的地方。并且，Log4还有一条平滑的学习曲线，在三分钟内就可学会它的简单使用。随着使用深入，你会发现Log4J功能的强大，几乎可以满足日志方面的所有需要。Logger类是在log4j1.2以后才有的，以前是用Category类来实现现在的Logger类的功能的。从API可知，Logger类是Category类的子类。Logger类的代码如下： package?org.apache.log4j;? public?class?Logger?{? //?创建和取回方法:public?static?Logger?getRootLogger(); public?static?Logger?getLogger(String?name); public?static?Logger?getLogger(Class?class1);? //?打印方法:?public?void?debug(Object?message); public?void?info(Object?message); public?void?warn(Object?message); public?void?error(Object?message); public?void?fatal(Object?message);? //?常用打印方法:public?void?log(Level?l,?Object?message); } 打印方法和级别 Log4j中的日志级别分为五种：DEBUG、INFO、WARN、ERROR和FATAL，这五种级别从左到右级别依次增加。对于每一个记录器，我们都可对它赋于一定的级别，而打印函数打印的即是相应级别的信息。当对一个级别为A的Logger调用级别为B的打印方法时，只有当B=A时才会进行打印。例如，如果有一个级别为WARN的Logger对象logger，只有对它调用logger.warn?(message)、logger.error?(message)和logger.fatal?(message)这三个打印函数才会打印信息；而调用logger.debug?(message)和?(message)则不会打印信息，因为debug()函数只有当logger的级别为DEBUG时才打印信息，info()函数只有当logger的级别为INFO时才打印信息。除了对应于每一个级别有一个打印函数外，在Logger类中还有一个log()，它可以让你通过参数来指定一个打印信息的打印级别。 引入级别后就可通过修改调试的级别来控制某个调试信息是否输出。假设我们有的信息是在开发时才需要输出的（称为测试信息），那么我们把输出测试信息的Logger的级别在开发时设为DEBUG级别的，并用debug(Object?message)函数来进行打印。当要发布系统时，只需把相应的Logger的级别调高就可以屏蔽掉测试信息。perties文件，并将其放在WEB-INF目录下，文件内容如下： log4j.rootLogger=DEBUG, stdout, R, logfile log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout # Pattern to output the callers file name and line number. log4j.a