日志工具 Log4j控件初识

Log4j概述
Log4j是目前应用最为广泛的日志控件，他把日志分为ALL 、TRACE(跟踪)、DEBUG(调试)、INFO(信息)、WARNING(警告)、ERROR(错误)、FITAL(致命)、OFF等几个级别。级别高的Level会屏蔽级别低的信息。

Log4j配置中有三个重要的概念：日志记录器（Logger）、输出地（Appender）以及日志格式化器（Layout），Logger负责记录日志，Appender负责输出到什么地方，Layout负责以什么格式输出，输出附加哪些信息。

---

日志记录器 Logger
Logger就是java代码中的Logger,例如：

public Logger logger=Logger.getLogger(Log4jConfigTest.class)

Logger是有名字的，名字就是Logger.getLogger()方法中的参数，且Logger是单例模式，一般以类名作为Logger的名称。Log4j中有一个根记录器rootLogger，它是所有Logger的父亲。

Logger的配置
Log4j.logger后面配置的是Logger,Log4j.appender后面配置的是Appender，如果某个Logger没有配置，则使用它的父亲配置，直到找到为止，一般情况下，只需配置根记录器rootLogger即可，所有的Logger都会沿用rootLogger的配置。

rootLogger配置
根记录器rootLogger直接用log4j.rootLogger配置：

# level : 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者您定义的级别log4j.rootLogger=DEBUG,CONSOLE,Alog4j.addivity.org.apache=false# 应用于控制台log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender# 本处设置为"DEBUG"以上级别在控制台输出(默认情况使用rootLogger中的设置)log4j.appender.CONSOLE.Threshold=DEBUGlog4j.appender.CONSOLE.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss} -%-4r [%t] %-5p  %x - %m%nlog4j.appender.CONSOLE.Target=System.outlog4j.appender.CONSOLE.Encoding=gbklog4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout# 每天新建日志log4j.appender.A=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.A.File=${catalina.home}/logs/FH_log/PurePro_log4j.appender.A.DatePattern=yyyy-MM-dd'.log'log4j.appender.A.layout=org.apache.log4j.PatternLayoutlog4j.appender.A.layout.ConversionPattern=[FH_sys]  %d{yyyy-MM-dd HH\:mm\:ss} %5p %c{1}\:%L \: %m%n

---

输出地（Appender）

常用的输出地有：控制台、文件、数据库、远程服务器等。

控制台

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppenderlog4j.appender.CONSOLE.Threshold=DEBUGlog4j.appender.CONSOLE.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss} -%-4r [%t] %-5p  %x - %m%nlog4j.appender.CONSOLE.Target=System.outlog4j.appender.CONSOLE.Encoding=gbklog4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout

控制台输出 需要配置Layout属性，最常用的是正则表达式格式。

输出到文件

log4j.appender.f=org.apache.log4j.FileAppender  #文件输出log4j.appender.f.File=D:\\tomcat.log4j          #文件位置log4j.appender.f.Append=true                    #追加文件内容log4j.appender.A.layout=org.apache.log4j.PatternLayout  #输出文件格式内容log4j.appender.A.layout.ConversionPattern=[FH_sys]  %d{yyyy-MM-dd HH\:mm\:ss} %5p %c{1}\:%L \: %m%n

此外还可以输出到按大小滚动文件、输出到按日期滚动文件、输出到JDBC数据库、输出到SOCKET套接字、输出到SMTP邮件、自定义输出。

---

日志格式化器（Layout）

PatternLayout布局
PatternLayout是最常用的格式化器，用户可以自定义输出信息，例如日期、时间、所在的线程、类名、文件名、信息级别、文件行数等。

HTMLLayout布局
HTMLLayout将日志格式化为HTML代码，输出到文件后，直接用浏览器浏览。

XMLLayout布局
XMLLayout将日志格式化为XML文件，XML文件的好处是解析比较容易，有现成的DOM技术和SAX技术。

---

---

log4j.properties配置详解
1. 配置文件

Log4j提供的日志输出地有以下几种：org.apache.log4j.ConsoleAppender（控制台）org.apache.log4j.FileAppender（文件）org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

Log4j提供的日志输出格式有以下几种：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平台为“\r\n”，Unix平台为“\n” %d   输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，输出类似：2002年10月18日  22 ： 10 ： 28 ， 921  %l   输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。举例：Testlog4.main(TestLog4.java: 10 ) 

控制台Threshold=DEBUG:指定日志消息的输出最低层次。ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。Target=System.err：默认情况下是：System.out,指定输出控制台FileAppender Threshold=DEBUF:指定日志消息的输出最低层次。ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。File=newlog.txt:指定消息输出到newlog.txt文件。Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。RollingFileAppenderThreshold=DEBUG:指定日志消息的输出最低层次。ImmediateFlush=true:默认值是true,意谓着所有的消息都会被立即输出。File=newlog.txt:指定消息输出到newlog.txt文件。Append=false:默认值是true,即将消息增加到指定文件中，false指将消息覆盖指定的文件内容。MaxFileSize=100KB: 后缀可以是KB, MB 或者是 GB. 在日志文件到达该大小时，将会自动滚动，即将原来的内容移到newlog.log.1文件。MaxBackupIndex=2:指定可以产生的滚动文件的最大数。log4j.appender.A1.layout.ConversionPattern=%-4r %-5p %d{yyyy-MM-dd HH:mm:ssS} %c %m%n日志信息格式中几个符号所代表的含义： -X号: X信息输出时左对齐； %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"输出日志信息换行 可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如： 1)%20c：指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，默认的情况下右对齐。 2)%-20c:指定输出category的名称，最小的宽度是20，如果category的名称小于20的话，"-"号指定左对齐。 3)%.30c:指定输出category的名称，最大的宽度是30，如果category的名称大于30的话，就会将左边多出的字符截掉，但小于30的话也不会有空格。 4)%20.30c:如果category的名称小于20就补空格，并且右对齐，如果其名称长于30字符，就从左边较远输出的字符截掉。