Java Log4j配置说明

来源:互联网 发布:乐知英语待遇 编辑:程序博客网 时间:2024/04/19 21:35

    Log4j可以通过java程序动态设置,该方式明显缺点是:如果需要修改日志输出级别等信息,则必须修改java文件,重新编译,很是麻烦;

    log4j也可以通过配置文件的方式进行设置,目前支持两种格式的配置文件:

  • xml文件
  • properties文件(推荐)

下面是一个log4j配置文件的完整内容:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.rootCategory=INFO, stdout  
  2. log4j.rootLogger=info, stdout  
  3.    
  4. ### stdout ###  
  5. log4j.appender.stdout=org.apache.log4j.ConsoleAppender  
  6. log4j.appender.stdout.Target=System.out  
  7. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout  
  8. log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p - %m%n  
  9.    
  10. ### set package ###  
  11. log4j.logger.org.springframework=info  
  12. log4j.logger.org.apache.catalina=info  
  13. log4j.logger.org.apache.commons.digester.Digester=info  
  14. log4j.logger.org.apache.catalina.startup.TldConfig=info  
  15. log4j.logger.chb.test=debug  

 1.2 配置根Logger

根logger主要定义log4j支持的日志级别及输出目的地,其语法为:

log4j.rootLogger = [ level ] , appenderName, appenderName, …

其中,level 是日志记录的优先级,分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。

建议只使用四个级别,优先级从高到低分别是ERROR、WARN、INFO、DEBUG

appenderName指定日志信息输出到哪个地方,可同时指定多个输出目的地。

1.3 配置输出目的地Appender

Appender主要定义日志信息输出在什么位置,主要语法为:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.appender.appenderName = classInfo  
  2. log4j.appender.appenderName.option1 = value1  
  3.   …  
  4. log4j.appender.appenderName.optionN = valueN  

Log4j提供的appender有以下几种: 

  • org.apache.log4j.ConsoleAppender(控制台), 
  • org.apache.log4j.FileAppender(文件), 
  • org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件),
  • org.apache.log4j.RollingFileAppender(文件大小到达指定尺寸的时候产生一个新的文件) 
  • org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

以ConsoleAppender为例,如:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.appender.stdout=org.apache.log4j.ConsoleAppender  
  2. log4j.appender.stdout.Target=System.out  
[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. 输出级别的种类  
  2. [html] view plaincopy  
  3. OFF 、FATAL 、ERROR、WARN、INFO、DEBUG、TRACE 、ALL    
  4.  OFF 为最高等级 关闭了日志信息    
  5.  FATAL  为可能导致应用中止的严重事件错误    
  6.  ERROR 为严重错误 主要是程序的错误    
  7.  WARN 为一般警告,比如session丢失    
  8.  INFO 为一般要显示的信息,比如登录登出    
  9.  DEBUG 为程序的调试信息    
  10.  TRACE 为比DEBUG更细粒度的事件信息    
  11.  ALL 为最低等级,将打开所有级别的日志    

1.4 配置日志信息的格式Layout

  Layout 负责格式化Appender的输出,其语法为:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.appender.appenderName.layout = classInfo  
  2. log4j.appender.appenderName.layout.option1 = value1  
  3. …  
  4. 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(包含日志产生的时间、线程、类别等等信息)
  • [html] view plaincopy在CODE上查看代码片派生到我的代码片
    1. <strong>控制台选项</strong>  
    2. Threshold=DEBUG:指定日志消息的输出最低层次。  
    3.  ImmediateFlush=true:默认值是true,意味着所有的消息都会被立即输出。  
    4.  Target=System.err:默认情况下是:System.out,指定输出控制台  
    5.   
    6.  <strong>FileAppender 选项</strong>  
    7.  Threshold=DEBUF:指定日志消息的输出最低层次。  
    8.  ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。  
    9.  File=mylog.txt:指定消息输出到mylog.txt文件。  
    10.  Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。  
    11.   
    12.  <strong>RollingFileAppender 选项</strong>  
    13.  Threshold=DEBUG:指定日志消息的输出最低层次。  
    14.  ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。  
    15.  File=mylog.txt:指定消息输出到mylog.txt文件。  
    16.  Append=false:默认值是true,即将消息增加到指定文件中,false指将消息覆盖指定的文件内容。  
    17.  MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时,将会自动滚动,即将原来的内容移到mylog.log.1文件。  
    18.  MaxBackupIndex=2:指定可以产生的滚动文件的最大数。  
    19.  log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n  

    日志信息格式中几个符号所代表的含义:
    [html] view plaincopy在CODE上查看代码片派生到我的代码片
    1. -X号: X信息输出时左对齐;  
    2. %p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL,  
    3. %d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921  
    4. %r: 输出自应用启动到输出该log信息耗费的毫秒数  
    5. %c: 输出日志信息所属的类目,通常就是所在类的全名  
    6. %t: 输出产生该日志事件的线程名  
    7. %l: 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main (TestLog4.java:10)  
    8. %x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。  
    9. %%: 输出一个"%"字符  
    10. %F: 输出日志消息产生时所在的文件名称  
    11. %L: 输出代码中的行号  
    12. %m: 输出代码中指定的消息,产生的日志具体信息  
    13. %n: 输出一个回车换行符,Windows平台为"/r/n",Unix平台为"/n"输出日志信息换行  
    14. 可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如:  
    15. 1)%20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,默认的情况下右对齐。  
    16. 2)%-20c:指定输出category的名称,最小的宽度是20,如果category的名称小于20的话,"-"号指定左对齐。  
    17. 3)%.30c:指定输出category的名称,最大的宽度是30,如果category的名称大于30的话,就会将左边多出的字符截掉,但小于30的话也不会有空格。  
    18. 4)%20.30c:如果category的名称小于20就补空格,并且右对齐,如果其名称长于30字符,就从左边较远输出的字符截掉。  

1.5 设置package输出级别

可以设置不同package的日志输出级别,语法为:

log4j.logger.packageName=level

其中,packageName为实际的包名,level为日志级别,例如:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.logger.org.springframework=info  
  2. log4j.logger.org.apache.catalina=info  
  3. log4j.logger.org.apache.commons.digester.Digester=info  
  4. log4j.logger.org.apache.catalina.startup.TldConfig=info  
  5. log4j.logger.chb.test=debug  

2 Log4j与J2ee结合

2.1 使用spring架构

Spring真是不错,替我们做了很多事情,如果系统使用了spring框架,则要集成log4j就很简单了,主要分为3个步骤,如下:

2.1.1 定义log4j配置文件

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.rootCategory=INFO, stdout  
  2. log4j.rootLogger=info, stdout  
  3.    
  4. ### stdout ###  
  5. log4j.appender.stdout=org.apache.log4j.ConsoleAppender  
  6. log4j.appender.stdout.Target=System.out  
  7. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout  
  8. log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p - %m%n  
  9.    
  10. ### log to file ###  
  11. log4j.logger.org.springframework=info  
  12. log4j.logger.org.apache.catalina=info  
  13. log4j.logger.org.apache.commons.digester.Digester=info  
  14. log4j.logger.org.apache.catalina.startup.TldConfig=info  
  15. log4j.logger.chb.test=debug  

2.1.2  定义监听器

监听器需要定义在web.xml,主要包括:定义log4j配置文件目录、log4j监听器,如下:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <web-app version="2.4"  
  3.     xmlns="http://java.sun.com/xml/ns/j2ee"  
  4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  5.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee  
  6.     http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">  
  7.      
  8.     <!--由Spring载入的Log4j配置文件位置-->  
  9.     <context-param>  
  10.        <param-name>log4jConfigLocation</param-name>  
  11.        <param-value>/WEB-INF/log4j.properties</param-value>  
  12.     </context-param>  
  13.      
  14.     <context-param>  
  15.        <param-name>contextConfigLocation</param-name>  
  16.        <param-value>  
  17.            /WEB-INF/classes/applicationContext*.xml  
  18.        </param-value>  
  19.     </context-param>  
  20.      
  21.     <!--Spring log4j Config loader-->  
  22.     <listener>  
  23.        <listener-class>  
  24.            org.springframework.web.util.Log4jConfigListener  
  25.        </listener-class>  
  26.     </listener>  
  27.      
  28.     <listener>  
  29.        <listener-class>  
  30.            org.springframework.web.context.ContextLoaderListener  
  31.        </listener-class>  
  32.     </listener>  
  33.      
  34.     <servlet>  
  35.        <servlet-name>InitiaServlet</servlet-name>  
  36.     <servlet-class>chb.test.web.InitiaServlet</servlet-class>  
  37.        <load-on-startup>1</load-on-startup>  
  38.     </servlet>  
  39.      
  40.   <welcome-file-list>  
  41.     <welcome-file>index.jsp</welcome-file>  
  42.   </welcome-file-list>  
  43. </web-app>  

2.1.3  测试类
[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. package com.dheaven.mip.web;  
  2.    
  3.    
  4. import javax.servlet.ServletException;  
  5. import javax.servlet.http.HttpServlet;  
  6.    
  7. import org.apache.log4j.Logger;  
  8.    
  9. public class InitiaServlet extends HttpServlet {  
  10.      
  11.     protected Logger log = Logger.getLogger(InitiaServlet.class);  
  12.    
  13.     private static final long serialVersionUID = 8550329576989690578L;  
  14.    
  15.     /**  
  16.      * Constructor of the object.  
  17.      */  
  18.     public InitiaServlet() {  
  19.        super();  
  20.     }  
  21.    
  22.     /**  
  23.      * Destruction of the servlet. <br>  
  24.      */  
  25.     public void destroy() {  
  26.        super.destroy();  
  27.     }  
  28.    
  29.     /**  
  30.      * Initialization of the servlet. <br>  
  31.      *  
  32.      * @throws ServletException if an error occure  
  33.      */  
  34.     public void init() throws ServletException {  
  35.        log.debug("服务器启动了,log4j开始工作了");  
  36.     }  
  37. }  

 

2.2不使用spring架构

如果系统没有使用spring,我们以servlet为例,很简单,大家按照步骤执行即可,只贴代码,不说废话。

2.2.1 定义log4j配置文件

放在web工程的WEB-INF目录下,内容如:

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. log4j.rootCategory=INFO, stdout  
  2. log4j.rootLogger=info, stdout  
  3.    
  4. ### stdout ###  
  5. log4j.appender.stdout=org.apache.log4j.ConsoleAppender  
  6. log4j.appender.stdout.Target=System.out  
  7. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout  
  8. log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p - %m%n  
  9.    
  10. ### set package ###  
  11. log4j.logger.org.apache.catalina=info  
  12. log4j.logger.org.apache.commons.digester.Digester=info  
  13. log4j.logger.org.apache.catalina.startup.TldConfig=info  
  14. log4j.logger.com.dheaven=debug  

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. package com.dheaven.mip.web;  
  2.    
  3. import javax.servlet.ServletException;  
  4. import javax.servlet.http.HttpServlet;  
  5.    
  6. import org.apache.log4j.PropertyConfigurator;  
  7.    
  8. public class InitLog4j extends HttpServlet {  
  9.    
  10.     private static final long serialVersionUID = 1L;  
  11.    
  12.     public void init() throws ServletException {  
  13.        String prefix = getServletContext().getRealPath("/");  
  14.        prefix = prefix.replace("//", "/");  
  15.        String file = getInitParameter("log4j-init-file");  
  16.        // if the log4j-init-file is not set, then no point in trying  
  17.        if (file != null) {  
  18.            PropertyConfigurator.configure(prefix + file);  
  19.        }  
  20.     }  
  21. }  

 2.2.3  Web.xml中定义初始化类
[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. <servlet>  
  2.    <servlet-name>log4j-init</servlet-name>  
  3.    <servlet-class>chb.test.web.InitLog4j</servlet-class>  
  4.   
  5.    <init-param>  
  6.        <param-name>log4j-init-file</param-name>  
  7.        <param-value>WEB-INF/log4j.properties</param-value>  
  8.    </init-param>  
  9.     
  10.    <load-on-startup>1</load-on-startup>  
  11. </servlet>  

2.2.4 测试类
[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. package chb.test.web;  
  2.    
  3.    
  4. import javax.servlet.ServletException;  
  5. import javax.servlet.http.HttpServlet;  
  6.    
  7. import org.apache.log4j.Logger;  
  8.    
  9. public class InitiaServlet extends HttpServlet {  
  10.      
  11.     protected Logger log = Logger.getLogger(InitiaServlet.class);  
  12.    
  13.     private static final long serialVersionUID = 8550329576989690578L;  
  14.    
  15.     /**  
  16.      * Constructor of the object.  
  17.      */  
  18.     public InitiaServlet() {  
  19.        super();  
  20.     }  
  21.    
  22.     /**  
  23.      * Destruction of the servlet. <br>  
  24.      */  
  25.     public void destroy() {  
  26.        super.destroy();  
  27.     }  
  28.    
  29.     /**  
  30.      * Initialization of the servlet. <br>  
  31.      *  
  32.      * @throws ServletException if an error occure  
  33.      */  
  34.     public void init() throws ServletException {  
  35.        log.debug("服务器启动了,log4j开始工作了");  
  36.     }  
  37. }  

2.2.5    log4j.xml配置如下,log4j.xml存放在WEB-INF目录下

[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. <?xml version="1.0" encoding="GBK" ?>    
  2. <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">    
  3. <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">      
  4.     <!-- 输出日志到控制台  ConsoleAppender -->   
  5.         <appender name="console"   
  6.         class="org.apache.log4j.ConsoleAppender">  
  7.         <param name="Threshold" value="info"></param>  
  8.         <layout class="org.apache.log4j.TTCCLayout">  
  9.             <param name="ConversionPattern" value="TTCCLayout"></param>  
  10.         </layout>  
  11.     </appender>  
  12.   
  13.     <!-- 输出日志到文件  每天一个文件 -->  
  14.     <appender name="dailyRollingFile"  
  15.         class="org.apache.log4j.DailyRollingFileAppender">  
  16.         <param name="Threshold" value="info"></param>  
  17.         <param name="ImmediateFlush" value="true"></param>  
  18.         <param name="File" value="c:/logs/dailyRollingFile.log"></param>  
  19.         <param name="DatePattern" value="'.'yyyy-MM-dd'.log'"></param>  
  20.         <layout class="org.apache.log4j.PatternLayout">  
  21.             <param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss\} %-5p] [%t] {%c:%L}-%m%n"></param>  
  22.         </layout>  
  23.     </appender>   
  24.       
  25.     <!-- 输出日志到文件  文件大小到达指定尺寸的时候产生一个新的文件 -->  
  26.     <appender name="railyFile"   
  27.         class="org.apache.log4j.RollingFileAppender">  
  28.         <param name="File" value="c:/logs/railyFile.log"></param>  
  29.         <param name="ImmediateFlush" value="true"/>  
  30.         <param name="Threshold" value="info"></param>  
  31.         <param name="Append" value="true"></param>  
  32.         <param name="MaxFileSize" value="30KB"></param>  
  33.         <param name="MaxBackupIndex" value="100"></param>  
  34.         <layout class="org.apache.log4j.PatternLayout">  
  35.             <param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss\} %-5p] [%t] {%c:%L}-%m%n"></param>  
  36.         </layout>  
  37.     </appender>  
  38.   
  39.     <!-- 输出日志到文件 -->  
  40.     <appender name="file"  
  41.         class="org.apache.log4j.FileAppender">  
  42.         <param name="File" value="c:/logs/file.log"></param>  
  43.         <param name="Threshold" value="info"></param>  
  44.         <layout class="org.apache.log4j.PatternLayout">  
  45.             <param name="ConversionPattern" value="[%d{yyyy-MM-dd HH:mm:ss\} %-5p] [%t] {%c:%L}-%m%n"></param>  
  46.         </layout>  
  47.     </appender>  
  48.   
  49.     <!--   
  50.         定义全局的日志输出级别,但是在输出目的地的配置中配置的具体输出级别优先级高于全局定义的优先级。  
  51.         如果在railyFile中定义<param name="Threshold" value="info"></param>,那么将会把info以上级别的信息输出  
  52.      -->  
  53.     <root>       
  54.         <priority value="debug" />       
  55.         <appender-ref ref="console" />    
  56.         <appender-ref ref="dailyRollingFile" />    
  57.         <appender-ref ref="railyFile" />    
  58.         <appender-ref ref="file" />    
  59.     </root>         
  60.   
  61. </log4j:configuration>   

在web.xml中添加log4j.xml配置
[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. <!-- log4j 系统日志-->  
  2. <context-param>   
  3.     <param-name>log4jConfigLocation</param-name>   
  4.     <param-value>/WEB-INF/log4j.xml</param-value>   
  5. </context-param>   
  6. <listener>   
  7.     <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>   
  8. </listener>  

最后只需在代码中调用即可,格式如下:
[html] view plaincopy在CODE上查看代码片派生到我的代码片
  1. public class HelloLog4j {  
  2.   
  3.     private static Logger logger = Logger.getLogger(HelloLog4j.class);  
  4.   
  5.     public  String getURL(){  
  6.         logger.info("getURL() ... ");  
  7.         return null;  
  8.     }  
  9. }
0 0
原创粉丝点击