位置:首頁 > Java技術 > Log4j教學 > log4j PatternLayout

log4j PatternLayout

如果想生成基於模式的特定格式的日誌信息,那麼可以使用 org.apache.log4j.PatternLayout 格式化日誌信息。

PatternLayout類擴展抽象 org.apache.log4j.Layout 類並覆蓋format()方法根據提供的模式構建日誌信息。 

PatternLayout也是一個簡單的布局對象,它提供下列Bean屬性,可以通過配置文件進行設置:

S.N. 屬性和說明
1 conversionPattern
設置轉換模式。默認為 %r [%t] %p %c %x - %m%n

模式轉換字符:

下表說明了以上模式使用的字符和所有其他字符,可以在自定義模式中使用:

轉換字符 表示的意思
c 用於輸出的記錄事件的類彆。例如,對於類彆名稱"a.b.c" 模式  %c{2} 會輸出 "b.c"
C 用於輸出呼叫者發出日誌請求的完全限定類名。例如,對於類名 "org.apache.xyz.SomeClass", 模式 %C{1} 會輸出 "SomeClass".
d 用於輸出的記錄事件的日期。例如, %d{HH:mm:ss,SSS} 或 %d{dd MMM yyyy HH:mm:ss,SSS}.
F 用於輸出被發出日誌記錄請求,其中的文件名
l 用於將產生的日誌事件調用者輸出位置信息
L 用於輸出從被發出日誌記錄請求的行號
m 用於輸出使用日誌事件相關聯的應用程序提供的消息
M 用於輸出發出日誌請求所在的方法名稱
n 輸出平台相關的行分隔符或文字
p 用於輸出的記錄事件的優先級
r 用於輸出毫秒從布局的結構經過直到創建日誌記錄事件的數目
t 用於輸出生成的日誌記錄事件的線程的名稱
x 用於與產生該日誌事件的線程相關聯輸出的NDC(嵌套診斷上下文)
X 在X轉換字符後麵是鍵為的MDC。例如  X{clientIP} 將打印存儲在MDC對鍵clientIP的信息
% 文字百分號 %%將打印%標誌

格式修飾符:

默認情況下,相關資料原樣輸出。然而,隨著格式修飾符的幫助下,可以改變最小字段寬度,最大字段寬度和對齊。

下表涵蓋了各種各樣的修飾符的情況:

Format modifier left justify minimum width maximum width 注釋
%20c false 20 none 用空格左墊,如果類彆名稱少於20個字符長
%-20c true 20 none 用空格右墊,如果類彆名稱少於20個字符長
%.30c NA none 30 從開始截斷,如果類彆名稱超過30個字符長
%20.30c false 20 30 用空格左側墊,如果類彆名稱短於20個字符。但是,如果類彆名稱長度超過30個字符,那麼從開始截斷。
%-20.30c true 20 30 用空格右側墊,如果類彆名稱短於20個字符。但是,如果類彆名稱長度超過30個字符,那麼從開始截斷。

PatternLayout 示例:

以下是針對 PatternLayout 一個簡單的配置文件:

# Define the root logger with appender file
log = /usr/home/log4j
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=
      %d{yyyy-MM-dd}-%t-%x-%-5p-%-10c:%m%n

現在考慮下麵產生日誌信息的Java例子:

import org.apache.log4j.Logger;

import java.io.*;
import java.sql.SQLException;
import java.util.*;

public class log4jExample{
  /* Get actual class name to be printed on */
  static Logger log = Logger.getLogger(
                      log4jExample.class.getName());

  public static void main(String[] args)
                throws IOException,SQLException{
   
     log.debug("Hello this is an debug message");
     log.info("Hello this is an info message");
  }
}

編譯並運行上述程序,它會創建 log.out文件在 /usr/home/log4j 目錄,該文件將有如下的日誌信息:

2010-03-23-main--DEBUG-log4jExample:Hello this is an debug message
2010-03-23-main--INFO -log4jExample:Hello this is an info message