Log4j使用

Jun 14, 2013


  log4j的使用主要关注的是三个概念,分别是记录器(Loggers)、输出源(Appenders)和布局器(Layouts)

一、记录器

1.1 记录器的介绍

一个记录器就是一个Logger实例,调用记录器的debug(),info(),warning(),error()等方法可以写日志,java中获取记录器的代码如下: private static Logger logger = Logger.getLogger(“test”); 或者 private static Logger logger = Logger.getLogger(Test.class);
或者 private static Logger logger = Logger.getRootLogger();//获取根记录器

1.2 记录器的层次结构

   层次结构类似于继承,根记录器是所有记录器的祖先,例如,Logger.getLogger(“com.foo”)获取的记录器就是Logger.getLogger(“com.foo.Bar”)获取的记录器的父记录器(getLogger的参数可以是字符串或者是class对象,如果是字符串的话可以是包名或者是类名)。了解记录器的层次结构时,最主要的两个内容是级别的继承和输出源的继承

 级别的继承:

  一个记录器如果没有设置级别,它可以继承于最近一个带有指定级别的祖先,如果设置了级别,将会覆盖掉父记录器的级别(因为一个记录器只有一个级别)

   例如:在log4j.properties中可以这样设置:
    log4j.rootLogger=INFO,ROLLINGFILE //定义一个根记录器,级别是INFO,输出源是ROLLINGFILE
    log4j.logger.test=,TEST //定义一个名为test的记录器,级别省略,输出源为TEST,实际上该记录器级别是继承于根记录器的级别:INFO
    log4j.logger.cg=WARN,CG //定义一个名为cg的记录器,级别覆盖掉根记录器为:WARN,在程序中调用setLevel(Level.WARN)方法可以实现相同效果

 输出源的继承:

  如果不设置输出源附加特性的话,子记录器的输出源将会包括所有祖先记录器的输出源    例如: <br/>     log4j.rootLogger=INFO,ROLLINGFILE <br/>     log4j.logger.cg=WARN,CG //输出源为:CG和ROLLINGFILE这两个(因为输出源可以为多个) <br/>     Log4j.logger.foo=,FOO <br/>       Log4j.additivity.foo=FALSE//表示设置输出源的附加特性为FALSE,那么foo子记录器的输出源将不会包括foo的父记录器的输出源(但是包括foo记录器的输出源),
   在程序调用setAdditivity(false)方法可以实现相同效果

二、输出源

  输出源用来设置日志的存储方式、格式、地址等信息

  常用的日志信息输出目的地有: org.apache.log4j.ConsoleAppender:将日志信息输出到控制台 org.apache.log4j.FileAppender:将日志信息输出到一个文件 org.apache.log4j.DailyRollingFileAppender:将日志信息输出到一个日志文件,并且每天输出到一个新的日志文件 org.apache.log4j.RollingFileAppender:将日志信息输出到一个日志文件,并且指定文件的尺寸,当文件大小达到指定尺寸时,会自动把文件改名,同时产生一个新的文件 org.apache.log4j.WriteAppender:将日志信息以流格式发送到任意指定地方   org.apache.log4j.jdbc.JDBCAppender:通过JDBC把日志信息输出到数据库中

三、布局器

org.apache.log4j.HTMLLayout(以HTML表格形式布局)
org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息)

ConversionPattern属性的字段含义如下:
%p: 输出日志信息优先级,即DEBUG,INFO,WARN,ERROR,FATAL,
%d: 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:
%d{yyy MMM dd HH:mm:ss,SSS},输出类似:2002年10月18日 22:10:28,921
%r: 输出自应用启动到输出该log信息耗费的毫秒数
%c: 输出日志信息所属的类目,通常就是所在类的全名
%t: 输出产生该日志事件的线程名
%l: 输出日志事件的发生位置,相当于%C.%M(%F:%L)的组合,包括类目名、发生的线程,以及在代码中的行数。举例:Testlog4.main (TestLog4.java:10)
%x: 输出和当前线程相关联的NDC(嵌套诊断环境),尤其用到像java servlets这样的多客户多线程的应用中。%%: 输出一个"%"字符
%F: 输出日志消息产生时所在的文件名称
%L: 输出代码中的行号
%m: 输出代码中指定的消息,产生的日志具体信息
%n: 输出一个回车换行符,Windows平台为"\r\n",Unix平台为"\n"输出日志信息换行