Log4j笔记
一、概述：
1. Log4j简介：Apache开源项目，用于管理和打印输出log信息。
分为三个部分：Logger + Appender + Layout
1. Logger :
日志器，生成和记录日志的程序
2. Appender :
日志器存放位置，console/文件/GUI组件等，一个Logger可有多个Appender.
3. Layout :
控制日志的格式、输出和显示级别等
注意：log的5个级别：Debug > Info > Warn> Error > Fatal。
显示方式：高于配置级别的信息才会显示。
2. 为什么要日志？
原因： 1. 开发阶段à排错； 2. 产品阶段à记录运行状况。
3. Log4j的优点：
设置开关：运行时可以选择打开或关闭日志的输出；
定义作用域：自定义部分类或包输出或关闭；
分级：对日志进行分级；
多样：不只文本信息，还能输出其他信息；
位置：可以改变输出log的位置。
4. 其他log插件：comments-log，JDK-log等。
二、如何使用：
1. 导入jar包，编写配置文件（Log4j支持两种格式的配置文件，即properties文件和xml文件）；（properties文件配置方式比较常见）
2. properties配置文件基本格式：
log4j.properties配置文件如下：
#log4j.rootLogger=debug,stdout,R
log4j.rootLogger=debug,stdout
log4j.logger.com.test.log4j=debug,R
log4j.logger.com.test.log4j.hehe=debug,R2
log4j.logger.com.test.hehe.Test=info,R3
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=[%t] %d{yy/mm/dd HH:mm:ss} %p (%F:%L) - %m%n
log4j.appender.R=org.apache.log4j.RollingFileAppender
#log4j.appender.R.File=example.log
log4j.appender.R.File=c:/example.log
#log4j.appender.R.File=${webappHome}/example.log
log4j.appender.R.MaxFileSize=1KB
log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=${catalina.home}/logs/rfidtest.log
log4j.appender.R.MaxFileSize=10MB
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,SSS} %5p %t %c{1}:%L- %m%n
*其中rootLogger为根日志器，log4j.logger.com.Alvin.dao.AddUserDao为该类的日志器，如果设置，将覆盖根日志器。
3. 参照信息：
|
参数 |
说明 |
例子 |
||
|
%c |
列出logger名字空间的全称，如果加上{<层数>}表示列出从最内层算起的指定层数的名字空间 |
Log4j配置文件参数举例 |
输出显示媒介 |
|
|
假设当前logger名字空间是”a.b.c” |
||||
|
%c |
a.b.c |
|||
|
%c{2} |
b.c |
|||
|
%20c |
（若名字空间长度小于20，则左边用空格填充） |
|||
|
%-20c |
（若名字空间长度小于20，则右边用空格填充） |
|||
|
%.30c |
（若名字空间长度超过30，截取多余字符） |
|||
|
%20.30c |
（若名字空间长度小于20，则左边用空格填充；若名字空间长度超过30，截去多余字符） |
|||
|
%-20.30c |
（若名字空间长度小于20，则右边用空格填充；若名字空间长度超过30，截去多余字符） |
|||
|
%C |
列出调用logger的类的全名（包含路径名） |
假设当前是”org.apache.xyz.SomeClass” |
||
|
%C |
Org.apache.xyz.SomeClass |
|||
|
%C{1} |
SomeClass |
|||
|
%d |
显示日志记录的时间，{<日期格式>}使用ISO8601定义的格式 |
%d{yyyy/MM/dd HH:mm:ss,SSS} |
2005/10/12 22:23:30,117 |
|
|
%d{ABSOLUTE} |
22:23:30,117 |
|||
|
%d{DATE} |
12 Oct 2005 22:23:30,117 |
|||
|
%d{ISO8601} |
2005-10-12 22:23:30,117 |
|||
|
%F |
显示调用logger的源文件名 |
%F |
MyClass.java |
|
|
%I |
输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数 |
%I |
MyClass.main(MyClass.java:129) |
|
|
%L |
显示调用logger的代码行 |
%L |
129 |
|
|
%m |
显示输出的消息 |
%m |
This is a message for debug. |
|
|
%M |
显示调用logger的方法名 |
%M |
Main |
|
|
%n |
当前平台下的换行符 |
%n |
Windows平台下m UNIX平台下n |
|
|
%p |
显示该条日志的优先级 |
%p |
INFO |
|
|
%r |
显示从程序启动时到记录该条日志时已经经过的毫秒数 |
%r |
1215 |
|
|
%t |
输出产生该日志事件的线程名 |
%t |
MyClass |
|
|
%x |
按NDC（Nested Diagnostic Context，线程堆栈）顺序输出的日志 |
假设某程序调用顺序是MyApp调用com.foo.Bar |
||
|
%c %x - %m%n |
MyApp – Call com.foo.Bar. Com.foo.Bar – Log in Bar MyApp – Return to MyApp. |
|||
|
%X |
按照MDC（Mapped Diagnostic Context，线程映射表）输出日志。通常用于多个客户端连接同一台服务器，方便服务器区分那个客户端访问留下来的日志。 |
%X{5} |
（记录代号为5的客户端的日志） |
|
|
%% |
显示一个百分号 |
%% |
% |
|
4. 通常log以文件形式输出的话，在properties配置文件中配置相对路径，以免项目发布后产生的问题，配置方法是建一个servlet，并在web.xml文件中设置其开始加载，servlet中Init()方法里读取当前项目所在路径并放入配置，然后配置文件中读取作用域${webappHome}。
5. 程序中如何用：
声明：private static Logger logger =Logger.getLogger(类名.class);
使用： logger.debug(“….”); logger.info(“….”); logger.warn(“….”);即可打印log.
6. 如果需要改变输出，只需要在properties里改一下级别就可以了。
三、注意点：
1. properties配置文件必须放在src根目录下，不可放进包内。
2. properties配置文件的名称也不能改，必须是：log4j.properties
3. 通常log以文件形式输出的话，在配置文件里设置相对路径而非绝对路径，以防项目上线后目录有变。设置方法如下：
<1>. 创建servlet，实现其Init()方法，再起在Init()方法中获取当前项目路径存入配置，即：System.setProperty(“webappHome”,this.getServletContext().getRealPath(“”));
<2>. 配置web.xml配置文件，设置<loan-on-start>为1或大于1的正数，让server启动时实例化此类，注意：不用配置<servlet-mapping>标签；
<3>. 在log4j.properties配置文件中讲路径改为${webappHome}。
4. Log4j.properties配置文件中，配置输出log到文件需要做两步：
<1>. log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
<2>. log4j.appender.stdout.layout.ConversionPattern=”输出格式”