log4j使用

[size=x-large][align=center]log4j使用总结[/align][/size]
淳刚 2013-06-17

[size=large]使用篇[/size]
　　log4j的使用主要关注的是三个概念，分别是记录器(Loggers)、输出源(Appenders)和布局器(Layouts)
[size=medium]一、记录器[/size]
[b]1.1 记录器的介绍[/b]
一个记录器就是一个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();//获取根记录器

[b]1.2 记录器的层次结构[/b]
　　　层次结构类似于继承，根记录器是所有记录器的祖先，例如，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)方法可以实现相同效果
　　　
　　　输出源的继承：如果不设置输出源附加特性的话，子记录器的输出源将会包括所有祖先记录器的输出源
　　　例如：
　　　 log4j.rootLogger=INFO,ROLLINGFILE
　　　 log4j.logger.cg=WARN,CG //输出源为：CG和ROLLINGFILE这两个(因为输出源可以为多个)
　　　 Log4j.logger.foo=,FOO
　　　 Log4j.additivity.foo=FALSE //表示设置输出源的附加特性为FALSE，那么foo子记录器的输出源将不会包括foo的父记录器的输出源(但是包括foo记录器的输出源)，在程序调用setAdditivity(false)方法可以实现相同效果
　　　
　　　
[size=medium]二、输出源[/size]
　　输出源用来设置日志的存储方式、格式、地址等信息
　　
　　常用的日志信息输出目的地有:
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把日志信息输出到数据库中
　　
　　例如：
log4j.appender.ROLLINGFILE=org.apache.log4j.RollingFileAppender

log4j.appender.ROLLINGFILE.Threshold=INFO //设置过滤级别
log4j.appender.ROLLINGFILE.File=log/DocLogger.log //设置输出地址

[size=medium]三、布局器[/size]
布局器的格式：
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"输出日志信息换行