log4j日志配置之java和 javaWeb

转自:http://baike.baidu.com/view/25347.htm 

log4j

<script type="text/javascript"></script>

   
log4j

Log4j是Apache的一个开放源代码项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等;我们也可以控制每一条日志的输出格式;通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是,这些可以通过一个配置文件来灵活地进行配置,而不需要修改应用的代码。

目录

介绍 Log4j配置
  1. 第一步
  2. 第二步
  3. 第三步
  4. 第四步
Log4j说明 log4j详解
  1. 定义配置文件
  2. 格式化日志信息
  3. 在代码中使用Log4j
log4j与J2EE的结合介绍 Log4j配置
  1. 第一步
  2. 第二步
  3. 第三步
  4. 第四步
Log4j说明 log4j详解
  1. 定义配置文件
  2. 格式化日志信息
  3. 在代码中使用Log4j
log4j与J2EE的结合
展开

<script type="text/javascript"></script>

编辑本段介绍

  log4j--log for java (java的日志)   在强调可重用组件开发的今天,除了自己从头到尾开发一个可重用的日志操作类外,Apache为我们提供了一个强有力的日志操作包-Log4j。   官方站点:http://logging.apache.org/log4j/   此外,通过Log4j其他语言接口,您可以在C、C++、.Net、PL/SQL程序中使用Log4j,其语法和用法与在Java程序中一样,使得多语言分布式系统得到一个统一一致的日志组件模块。而且,通过使用各种第三方扩展,您可以很方便地将Log4j集成到J2EE、JINI甚至是SNMP应用中。   说明:下面分为三部分,   第一部分讲解如何配置log4j;   第二部分为对log4j.properties配置文件中的各个属性的讲解;   第三部分为对log4j的详细讲解。   如果只想配置上log4j,那么只需要看前两个部分就可以,如果想对log4j深入了解,则还需看第三部分。   使用的license: Apache License V2.0 (www.apache.org/licenses/LICENSE-2.0)

编辑本段Log4j配置

第一步

  加入log4j-1.2.8.jar到lib下。

第二步

  在CLASSPATH下建立log4j.properties。内容如下:   1 log4j.rootCategory=INFO, stdout , R   2   3 log4j.appender.stdout=org.apache.log4j.ConsoleAppender   4 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout   5 log4j.appender.stdout.layout.ConversionPattern=[QC] %p [%t] %C.%M(%L) | %m%n   6   7 log4j.appender.R=org.apache.log4j.DailyRollingFileAppender   8 log4j.appender.R.File=D:\\Tomcat 5.5\\logs\\qc.log   9 log4j.appender.R.layout=org.apache.log4j.PatternLayout   10 log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n   11   12 log4j.logger.com.neusoft=DEBUG   13 log4j.logger.com.opensymphony.oscache=ERROR   14 log4j.logger.net.sf.navigator=ERROR   15 log4j.logger.org.apache.commons=ERROR   16 log4j.logger.org.apache.struts=WARN   17 log4j.logger.org.displaytag=ERROR   18 log4j.logger.org.springframework=DEBUG   19 log4j.logger.com.ibatis.db=WARN   20 log4j.logger.org.apache.velocity=FATAL   21   22 log4j.logger.com.canoo.webtest=WARN   23   24 log4j.logger.org.hibernate.ps.PreparedStatementCache=WARN   25 log4j.logger.org.hibernate=DEBUG   26 log4j.logger.org.logicalcobwebs=WARN

第三步

  相应的修改其中属性,修改之前就必须知道这些都是干什么的,在第二部分讲解。

第四步

  在要输出日志的类中加入相关语句:   定义属性:protected final Log log = LogFactory.getLog(getClass());   在相应的方法中:   if (log.isDebugEnabled()){   log.debug(“System …..”);   }

编辑本段Log4j说明

  1 log4j.rootCategory=INFO, stdout , R   此句为将等级为INFO的日志信息输出到stdout和R这两个目的地,stdout和R的定义在下面的代码,可以任意起名。等级可分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL,如果配置OFF则不打出任何信息,如果配置为INFO这样只显示INFO, WARN, ERROR的log信息,而DEBUG信息不会被显示,具体讲解可参照第三部分定义配置文件中的logger。   3 log4j.appender.stdout=org.apache.log4j.ConsoleAppender   此句为定义名为stdout的输出端是哪种类型,可以是   org.apache.log4j.ConsoleAppender(控制台),   org.apache.log4j.FileAppender(文件),   org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),   org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件)   org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)   具体讲解可参照第三部分定义配置文件中的Appender。   4log4j.appender.stdout.layout=org.apache.log4j.PatternLayout   此句为定义名为stdout的输出端的layout是哪种类型,可以是   org.apache.log4j.HTMLLayout(以HTML表格形式布局),   org.apache.log4j.PatternLayout(可以灵活地指定布局模式),   org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),   org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)   具体讲解可参照第三部分定义配置文件中的Layout。   5log4j.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},输出类似:2002年10月18日 22:10:28,921   %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。   [QC]是log信息的开头,可以为任意字符,一般为项目简称。   输出的信息   [TS] DEBUG [main] AbstractBeanFactory.getBean(189) | Returning cached instance of singleton bean 'MyAutoProxy'   具体讲解可参照第三部分定义配置文件中的格式化日志信息。   7log4j.appender.R=org.apache.log4j.DailyRollingFileAppender   此句与第3行一样。定义名为R的输出端的类型为每天产生一个日志文件。   8log4j.appender.R.File=D:\\Tomcat 5.5\\logs\\qc.log   此句为定义名为R的输出端的文件名为D:\\Tomcat 5.5\\logs\\qc.log可以自行修改。   9log4j.appender.R.layout=org.apache.log4j.PatternLayout   与第4行相同。   10log4j.appender.R.layout.ConversionPattern=%d-[TS] %p %t %c - %m%n   与第5行相同。   12log4j.logger.com. neusoft =DEBUG   指定com.neusoft包下的所有类的等级为DEBUG。   可以把com.neusoft改为自己项目所用的包名。   13log4j.logger.com.opensymphony.oscache=ERROR   14log4j.logger.net.sf.navigator=ERROR   这两句是把这两个包下出现的错误的等级设为ERROR,如果项目中没有配置EHCache,则不需要这两句。   15log4j.logger.org.apache.commons=ERROR   16log4j.logger.org.apache.struts=WARN   这两句是struts的包。   17log4j.logger.org.displaytag=ERROR   这句是displaytag的包。(QC问题列表页面所用)   18log4j.logger.org.springframework=DEBUG   此句为Spring的包。   24log4j.logger.org.hibernate.ps.PreparedStatementCache=WARN   25log4j.logger.org.hibernate=DEBUG   此两句是hibernate的包。   以上这些包的设置可根据项目的实际情况而自行定制。

编辑本段log4j详解

定义配置文件

  Log4j支持两种配置文件格式,一种是XML格式的文件,一种是Java特性文件log4j.properties(键=值)。下面将介绍使用log4j.properties文件作为配置文件的方法:   ①、配置根Logger   Logger 负责处理日志记录的大部分操作。   其语法为:   log4j.rootLogger = [ level ] , appenderName, appenderName, …   其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG。通过在这里定义的级别,您可以控制到应用程序中相应级别的日志信息的开关。比如在这里定义了INFO级别,只有等于及高于这个级别的才进行处理,则应用程序中所有DEBUG级别的日志信息将不被打印出来。ALL:打印所有的日志,OFF:关闭所有的日志输出。 appenderName就是指定日志信息输出到哪个地方。可同时指定多个输出目的地。   ②、配置日志信息输出目的地 Appender   Appender 负责控制日志记录操作的输出。   其语法为:   log4j.appender.appenderName = fully.qualified.name.of.appender.class   log4j.appender.appenderName.option1 = value1   …   log4j.appender.appenderName.optionN = valueN   这里的appenderName为在①里定义的,可任意起名。   其中,Log4j提供的appender有以下几种:   org.apache.log4j.ConsoleAppender(控制台),   org.apache.log4j.FileAppender(文件),   org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),   org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件),可通过log4j.appender.R.MaxFileSize=100KB设置文件大小,还可通过log4j.appender.R.MaxBackupIndex=1设置为保存一个备份文件。   org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)   例如:log4j.appender.stdout=org.apache.log4j.ConsoleAppender   定义一个名为stdout的输出目的地,ConsoleAppender为控制台。   ③、配置日志信息的格式(布局)Layout   Layout 负责格式化Appender的输出。   其语法为:   log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class   log4j.appender.appenderName.layout.option1 = value1   …   log4j.appender.appenderName.layout.optionN = valueN   其中,Log4j提供的layout有以下几种:   org.apache.log4j.HTMLLayout(以HTML表格形式布局),   org.apache.log4j.PatternLayout(可以灵活地指定布局模式),   org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串),   org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)

格式化日志信息

  Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,打印参数如下:   %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},输出类似:2002年10月18日 22:10:28,921   %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数。

在代码中使用Log4j

  我们在需要输出日志信息的类中做如下的三个工作:   1、导入所有需的commongs-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类的成员方法输出日志信息:   if (log.isDebugEnabled()){   log.debug("111");   }   if (log.isInfoEnabled()){   log.info("222");   }   if (log.isWarnEnabled()){   log.warn("333");   }   if (log.isErrorEnabled()){   log.error("444");   }   if (log.isFatalEnabled()){   log.fatal("555")   }   2.3 如何应用记录器的层次   2.3.1 如果定义及获取不同层次的记录器   任何一个记录器的使用都有两个步骤:   1) 在配置文件中定义相应的记录器。   在配置文件中定义记录器的格式有两种   ? 定义根记录器的格式为   log4j.rootLogger = [ level ], appendName1, appendName2, …appendNameN   ? 定义一个非根记录器的格式为   log4j.logger.loggerName1 = [ level ], appendName1,…appendNameN   ……   log4j.logger.loggerNameM = [ level ], appendName1, …appendNameN   我们可以定义任意个非根记录器。   2) 在代码中调用Logger类的取得记录器方法取得相应的记录器对象。   要取得根记录器对象可通过Logger.getRootLogger()函数,要取得非根记录器可通过Logger.getLogger()函数。   理论知道就讲到这里,纸上得来终觉浅,下面,我们来小小演练一下。   例4-a:   package TestLog4j;   import org.apache.log4j.Logger;   import org.apache.log4j.PropertyConfigurator;   import org.apache.log4j.Priority;   import TestLog4j.TestLog4j2.TestLog4j2;   public class TestLog4j   {   static Logger logger = Logger.getLogger(TestLog4j.class.getName()); //(2)   public TestLog4j(){}   public static void main(String[] args)   {   //同时输出到控制台和一个文件的实例并实现了Logger的继承   PropertyConfigurator.configure("F:\\nepalon\\log4j2.properties");   logger.debug("Start of the main() in TestLog4j");   logger.info("Just testing a log message with priority set to INFO");   logger.warn("Just testing a log message with priority set to WARN");   logger.error("Just testing a log message with priority set to ERROR");   logger.fatal("Just testing a log message with priority set to FATAL");   logger.log(Priority.WARN, "Testing a log message use a alternate form");   logger.debug(TestLog4j.class.getName());   TestLog4j2 testLog4j2 = new TestLog4j2(); //(1)   testLog4j2.testLog();   }   }   在类TestLog4j中我们调用了另一个类TestLog4j2,下面看一下类TestLog4j2的代码。   例4-b:   package TestLog4j.TestLog4j2;   import org.apache.log4j.Logger;   import org.apache.log4j.PropertyConfigurator;   import org.apache.log4j.Priority;   public class TestLog4j2   {   static Logger logger = Logger.getLogger(TestLog4j2.class.getName()); //(1)   public TestLog4j2(){}   public void testLog()   {   //同时输出到控制台和一个文件的实例   PropertyConfigurator.configure("F:\\nepalon\\log4j2.properties");   logger.debug("2Start of the main()");   logger.info("2Just testing a log message with priority set to INFO");   logger.warn("2Just testing a log message with priority set to WARN");   logger.error("2Just testing a log message with priority set to ERROR");   logger.fatal("2Just testing a log message with priority set to FATAL");   logger.log(Priority.DEBUG, "Testing a log message use a alternate form");   logger.debug("2End of the main()");   }   }   最后我们来看一下配置文件。   例4-c:   log4j2.properties文件内容   #1区   #### Use two appenders, one to log to console, another to log to a file   log4j.rootLogger = debug, stdout   #2区   #Print only messages of priority WARN or higher for your category   log4j.logger.TestLog4j= , R   log4j.logger.TestLog4j.TestLog4j2=WARN   #3区   #### First appender writes to console   log4j.appender.stdout=org.apache.log4j.ConsoleAppender   log4j.appender.stdout.layout=org.apache.log4j.PatternLayout   # Pattern to output the caller's file name and line number.   log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n   #4区   #### Second appender writes to a file   log4j.appender.R=org.apache.log4j.RollingFileAppender   log4j.appender.R.File=F:\\nepalon\\classes\\TestLog4j\\example.log   # Control the maximum log file size   log4j.appender.R.MaxFileSize=100KB   # Archive log files (one backup file here)   log4j.appender.R.MaxBackupIndex=1   log4j.appender.R.layout=org.apache.log4j.PatternLayout   log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd hh:mm:ss}:%p %t %c - %m%n   先看一下运行结果。   在控制台中的结果为:   DEBUG [main] (?:?) - Start of the main() in TestLog4j   INFO [main] (?:?) - Just testing a log message with priority set to INFO   WARN [main] (?:?) - Just testing a log message with priority set to WARN   ERROR [main] (?:?) - Just testing a log message with priority set to ERROR   FATAL [main] (?:?) - Just testing a log message with priority set to FATAL   WARN [main] (?:?) - Testing a log message use a alternate form   DEBUG [main] (?:?) - TestLog4j.TestLog4j   WARN [main] (?:?) - 2Just testing a log message with priority set to WARN   ERROR [main] (?:?) - 2Just testing a log message with priority set to ERROR   FATAL [main] (?:?) - 2Just testing a log message with priority set to FATAL   输出文件的结果为:   2003-12-19 04:19:44:DEBUG main TestLog4j.TestLog4j - Start of the main() in TestLog4j   2003-12-19 04:19:44:INFO main TestLog4j.TestLog4j - Just testing a log message with priority set to INFO   2003-12-19 04:19:44:WARN main TestLog4j.TestLog4j - Just testing a log message with priority set to WARN   2003-12-19 04:19:44:ERROR main TestLog4j.TestLog4j - Just testing a log message with priority set to ERROR   2003-12-19 04:19:44:FATAL main TestLog4j.TestLog4j - Just testing a log message with priority set to FATAL   2003-12-19 04:19:44:WARN main TestLog4j.TestLog4j - Testing a log message use a alternate form   2003-12-19 04:19:44:DEBUG main TestLog4j.TestLog4j - TestLog4j.TestLog4j   2003-12-19 04:19:44:WARN main TestLog4j.TestLog4j2.TestLog4j2 - 2Just testing a log message with priority set to WARN   2003-12-19 04:19:44:ERROR main TestLog4j.TestLog4j2.TestLog4j2 - 2Just testing a log message with priority set to ERROR   2003-12-19 04:19:44:FATAL main TestLog4j.TestLog4j2.TestLog4j2 - 2Just testing a log message with priority set to FATAL   首先,先来看一下配置文件都有些什么东西。   1) 在1区中定义了一个根记录器。这个根记录器具有DEBUG级别并有一个名称为stdout的输出端appender。   2) 2区中的内容是这一节的重点,也是应用到记录器层次的地方,但其实也只有两句,充分体现了log4j的简单性。在这里,我们定义了两个名称分别为TestLog4j和TestLog4j.TestLog4j2设计器。   ? 在定义TestLog4j记录器时没有指定级别,所以它的级别继承自它的父记录器,即根记录器,所以它的级别也为DEBUG。在定义TestLog4j记录器时又定义了一个名称为R的输出端,所以它的输出端有两个,一个从根记录器继承而来的名为stdout的输出端,另一个为在此定义的名为R的输出端。在此需要注意的是,在定义记录器时必须先定义记录器的级别,然后才是记录器的输出端。如果只想定义输出端而不定义级别,则虽然级别可以为空,但逗号分隔符不能省略。如定义TestLog4j记录器的做法。   ? 在定义TestLog4j.TestLog4j2记录器时又指定了它的级别,由于一个记录器的级别只能有一个,所以新指定的级别将覆写掉它的父记录器的级别(这就象Java中的多态)。我们没有定义TestLog4j.TestLog4j2记录器的输出端,所以它的输出端将从它的父记录器中继承而来。它的父记录器为estLog4j记录器,所以它和estLog4j记录器一样具有两个名称分别为 stdout和R的输出端。   3) 剩下的3区和4区分别设置了两个输出端的参数值。   接下来,回到我们的代码,看一下是如何取得记录器,在取记录器时又发生了什么。   1) 例4-a中的代码(2)中,语句Logger.getLogger()中的参数TestLog4j.class.getName()的值为 TestLog4j. TestLog4j,所以此语句的结果是取得一个名为TestLog4j. TestLog4j的记录器的对象。但在配置文件中并没有定义这样的记录器,所以最终将返回与所需的名称TestLog4j. TestLog4j最接近的记录器对象,即名为TestLog4j的记录器的对象。   2) 例4-b中的代码(1)的原理与例4-a中的代码(2)相似,期望取得的是名为TestLog4j.TestLog4j2. TestLog4j2的记录器对象,但最终返回的是TestLog4j.TestLog4j2记录器的对象。

编辑本段log4j与J2EE的结合

  到目前为止,这篇文章讲的都是如何在application中应用log4j,而Java现在的应用主流是J2EE和J2ME。现在,我们来看一下要如何在 J2EE开发中应用log4j。其实在Web application中应用log4j也很简单,与在application中应用log4j不同之处就是要在所有应用log4j的代码之前对log4j进行初始化。所以,我们在web application中就要把log4j的初始化工作独立出来,把它放在Servlet中。下面,我们看一个例子。   例5-a:   进行初始化的Servlet:   import org.apache.log4j.PropertyConfigurator;   import javax.servlet.http.HttpServlet;   import javax.servlet.http.HttpServletRequest;   import javax.servlet.http.HttpServletResponse;   /**   * log4j.jar的初始化类,参考web.xml   */   public class Log4jInit extends HttpServlet   {   public void init()   {   //通过web.xml来动态取得配置文件   String prefix = getServletContext().getRealPath("/");   String file = getInitParameter("log4j-init-file");   // 如果没有给出相应的配置文件,则不进行初始化   if(file != null)   {   PropertyConfigurator.configure(prefix+file); //(1)   }   }   public void doGet(HttpServletRequest req, HttpServletResponse res)   {}   }   下面来看一下这个Servlet在web.xml中的定义。   例5-b:   <servlet>   <servlet-name>log4j-init</servlet-name>   <servlet-class>TestLog4j.Log4jInit</servlet-class>   <init-param>   <param-name>log4j-init-file</param-name>   <param-value>sort.properties</param-value>   </init-param>   <load-on-startup>1</load-on-startup>   </servlet>   因为log4j的初始化要在所有的log4j调用之前完成,所以在web.xml文件中,我们一定要把对应的Servlet定义的load-on-startup应设为1,以便在Web容器启动时即装入该Servlet。   完成了这两个步骤这后,我们就可以象在application开发中一样在web application任何地方应用log4j了。下面是在javabean中的应用的一个例子。   例5-c:   import org.apache.log4j.Logger;   public class InfoForm   {   static Logger logger = Logger.getLogger(InfoForm.class);   protected String title;   protected String content;   public InfoForm() {}   public void setTitle(Object value)   {   logger.debug("nepalon:title = " + title);   title = value;   }   public String getTitle()   {   logger.debug("nepalon:title = " + title);   return title;   }   public void setContent(String value)   {   content = value;   logger.debug("nepalon: content() = " + content);   }   public String getContent()   {   logger.debug("nepalon: content = \n" + content);   return content;   }   }

相关推荐