log4j的使用及参数配置详解
开发阶段的调试信息
运行时的日志记录日志代码占代码总量的4%
if (someCondition) { System.out.println("some
information.");
}
使用log4j的步骤
1、编写Property文件(log4j的配置信息)
2、在程序中获得logger对象,通过下列方法输出日志信息
public void debug(Object message);
public void info(Object message);
public void warn(Object message);
public void error(Object message);
Log4J有三个主要部件
记录器(Loggers)
输出源(Appenders)
布局(Layouts)
配置:
log4j.rootLogger=DEBUG, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern= %-4r [%t] %-5p %c %x - %m%n
org.apache.log4j.ConsoleAppender(控制台)
org.apache.log4j.FileAppender(文件)
org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)
org.apache.log4j.RollingFileAppender (文件到达指定大小时产生一个新文件)
org.apache.log4j.WriterAppender (将日志信息以流格式发送到任何地方)
org.apache.log4j.HTMLLayout(以HTML表格形式布局)
org.apache.log4j.PatternLayout(可以灵活地指定布局模式)
org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)
org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等信息)
布局layout:
%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)基本应用
参数 |
说明 |
例子 |
|
%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{2} |
xyz.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 |
%l |
输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数 |
%l |
MyClass.main(MyClass.java:129) |
%L |
显示调用logger的代码行 |
%L |
129 |
%m |
显示输出消息 |
%m |
This is a message for debug. |
%M |
显示调用logger的方法名 |
%M |
main |
%n |
当前平台下的换行符 |
%n |
Windows平台下表示rn |
%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. |
||
%X |
按MDC(Mapped Diagnostic Context,线程映射表)输出日志。通常用于多个客户端连接同一台服务器,方便服务器区分是那个客户端访问留下来的日志。 |
%X{5} |
(记录代号为5的客户端的日志) |
%% |
显示一个百分号 |
%% |
% |