log4j - 輸出格式控制, PatternLayout參數含義以及詳細配置

做項目被log4j的輸出格式化參數搞煩了，索性把API的相關部分大緻翻譯一下 

參數	說明	例子
%c	列出logger名字空間的全稱，如果加上{<層數>}表示列出從最内層算起的指定層數的名字空間	log4j配置檔案參數舉例	輸出顯示媒介
假設目前logger名字空間是"a.b.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"
	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的源檔案名		MyClass.java
%l	輸出日志事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數		MyClass.main(MyClass.java:129)
%L	顯示調用logger的代碼行		129
%m	顯示輸出消息		This is a message for debug.
%M	顯示調用logger的方法名		main
%n	目前平台下的換行符		Windows平台下表示rn UNIX平台下表示n
%p	顯示該條日志的優先級		INFO
%r	顯示從程式啟動時到記錄該條日志時已經經過的毫秒數		1215
%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的用戶端的日志）
%%	顯示一個百分号		%

列了這麼多，舉幾個實際的例子吧，比如log4j.properties的内容為：

#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 Oct 2005 22:23:30,117 0 [main] INFO MyApp - Entering application.