日志打印字符串的结果,结果取决于转换模式。在转换模式,您可以自由插入任意文字。
每个转换符开始于一个百分号(%),其次是可选的的格式修饰符和一个转换字符。转换字符指定的数据类型,如类别,优先级,日期,线程的名称。格式修饰符控制字段宽度,填充,左,右对齐这样的事情。
需要注意的是没有明确的分隔符和文本之间的转换符。模式解析器知道什么时候已经结束的转换符时,它会读取一个转换字符。认可的转换字符
转换字符 | 效果 |
c | %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 | %C 列出调用logger的类的全名(包含包路径) 假设当前类是"org.apache.xyz.SomeClass" %C org.apache.xyz.SomeClass %C{1} SomeClass 警告:生成类信息缓慢,所以因避免使用,除非不考虑性能。 |
d | %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 | %F 显示调用logger的源文件名 %F MyClass.java 警告:生成位置信息及其缓慢,所以因避免使用,除非不考虑性能。 |
l | %l 输出日志事件的发生位置,包括类目名、发生的线程,以及在代码中的行数 %l MyClass.main(MyClass.java:129) |
L | %L 显示调用logger的代码行 %L 129 警告:生成位置信息及其缓慢,所以因避免使用,除非不考虑性能。 |
m | %m 显示输出消息 %m This is a message for debug. |
M | %M 显示调用logger的方法名 %M main 警告:生成位置信息及其缓慢,所以因避免使用,除非不考虑性能。 |
n | %n 当前平台下的换行符 %n Windows平台下表示rn UNIX平台下表示n |
p | %p 显示该条日志的优先级 %p INFO |
r | %r 显示从程序启动时到记录该条日志时已经经过的毫秒数 %r 1215 |
t | %t 输出产生该日志事件的线程名 %t MyClass |
x | %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 | %X 按MDC(Mapped Diagnostic Context,线程映射表)输出日志。通常用于多个客户端连接同一台服务器,方便服务器区分是那个客户端访问留下来的日志。 %X{5} (记录代号为5的客户端的日志) |
% | %% 显示一个百分号 %% % |
#log4j config
log4j.rootLogger=DEBUG,OUTPUT
log4j.appender.OUTPUT.layout=org.apache.log4j.PatternLayout
log4j.appender.OUTPUT.layout.ConversionPattern=%d{DATE} %-4r [%t] %-5p %c %x - %m%n
……
那么一个可能的输出是:
12 Jan 2013 22:23:30,117 0 [main] INFO MyApp - Entering application.
……
12 Jan 2013 22:23:30,162 45 [main] INFO MyApp - Exiting application.