日志列印字元串的結果,結果取決于轉換模式。在轉換模式,您可以自由插入任意文字。
每個轉換符開始于一個百分号(%),其次是可選的的格式修飾符和一個轉換字元。轉換字元指定的資料類型,如類别,優先級,日期,線程的名稱。格式修飾符控制字段寬度,填充,左,右對齊這樣的事情。
需要注意的是沒有明确的分隔符和文本之間的轉換符。模式解析器知道什麼時候已經結束的轉換符時,它會讀取一個轉換字元。認可的轉換字元
轉換字元 | 效果 |
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.