logback -- 配置詳解 -- 三 --

附：

logback.xml執行個體

logback -- 配置詳解 -- 一 -- <configuration>及子節點

logback -- 配置詳解 -- 二 -- <appender>

logback -- 配置詳解 -- 三 -- <encoder>

logback -- 配置詳解 -- 四 -- <filter>

-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

一：節點<appender>的子節點<encoder>：

　　<encoder> ：負責兩件事，一是把日志資訊轉換成位元組數組，二是把位元組數組寫入到輸出流。

　　目前PatternLayoutEncoder 是唯一有用的且預設的encoder ，有一個<pattern>節點，用來設定日志的輸入格式。使用“%”加“轉換符”方式，如果要輸出“%”，則必須用“\”對“\%”進行轉義。

　　XML ： <encoder>

<appender name="limeFileLogger" class="ch.qos.logback.core.FileAppender">
        <file>limeFileLogger.log</file>
        <append>true</append>
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <prudent>false</prudent>
    </appender>

　　<pattern>裡面的轉換符說明：

轉換符作用

c {length }

lo {length }

logger {length }

輸出日志的logger名，可有一個整形參數，功能是縮短logger名，設定為0表示隻輸入logger最右邊點符号之後的字元串。

Conversion specifier	Logger name	Result
%logger	mainPackage.sub.sample.Bar	mainPackage.sub.sample.Bar
%logger{0}	mainPackage.sub.sample.Bar	Bar
%logger{5}	mainPackage.sub.sample.Bar	m.s.s.Bar
%logger{10}	mainPackage.sub.sample.Bar	m.s.s.Bar
%logger{15}	mainPackage.sub.sample.Bar	m.s.sample.Bar
%logger{16}	mainPackage.sub.sample.Bar	m.sub.sample.Bar
%logger{26}	mainPackage.sub.sample.Bar	mainPackage.sub.sample.Bar

C {length }

class {length }

輸出執行記錄請求的調用者的全限定名。參數與上面的一樣。盡量避免使用，除非執行速度不造成任何問題。

contextName

輸出上下文名稱。

d {pattern }

date {pattern }

輸出日志的列印日志，模式文法與

java.text.SimpleDateFormat

相容。

Conversion Pattern	Result
%d	2006-10-20 14:06:49,812
%date	2006-10-20 14:06:49,812
%date{ISO8601}	2006-10-20 14:06:49,812
%date{HH:mm:ss.SSS}	14:06:49.812
%date{dd MMM yyyy ;HH:mm:ss.SSS}	20 oct. 2006;14:06:49.812

F / file 輸出執行記錄請求的java源檔案名。盡量避免使用，除非執行速度不造成任何問題。

caller{depth}caller{depth, evaluator-1, ... evaluator-n}

輸出生成日志的調用者的位置資訊，整數選項表示輸出資訊深度。

例如， %caller{2} 輸出為：

0    [main] DEBUG - logging statement 
Caller+0   at mainPackage.sub.sample.Bar.sampleMethodName(Bar.java:22)
Caller+1   at mainPackage.sub.sample.Bar.createLoggingRequest(Bar.java:17)

例如， %caller{3} 輸出為：

16   [main] DEBUG - logging statement 
Caller+0   at mainPackage.sub.sample.Bar.sampleMethodName(Bar.java:22)
Caller+1   at mainPackage.sub.sample.Bar.createLoggingRequest(Bar.java:17)
Caller+2   at mainPackage.ConfigTester.main(ConfigTester.java:38)

L / line 輸出執行日志請求的行号。盡量避免使用，除非執行速度不造成任何問題。

m / msg / message 輸出應用程式提供的資訊。

M / method 輸出執行日志請求的方法名。盡量避免使用，除非執行速度不造成任何問題。

n 輸出平台先關的分行符“\n”或者“\r\n”。

p / le / level 輸出日志級别。

r / relative 輸出從程式啟動到建立日志記錄的時間，機關是毫秒

t / thread 輸出産生日志的線程名。

replace(p ){r, t}

p 為日志内容，r 是正規表達式，将p 中符合r 的内容替換為t 。

例如， "%replace(%msg){\'\s\', \'\'}"

　　格式修飾符，與轉換符共同使用：

　　　　可選的格式修飾符位于“%”和轉換符之間。

　　　　第一個可選修飾符是左對齊标志，符号是減号“-”；接着是可選的最小寬度修飾符，用十進制數表示。如果字元小于最小寬度，則左填充或右填充，預設是左填充（即右對齊），填充符為空格。如果字元大于最小寬度，字元永遠不會被截斷。最大寬度修飾符，符号是點号"."後面加十進制數。如果字元大于最大寬度，則從前面截斷。點符号“.”後面加減号“-”在加數字，表示從尾部截斷。

　　　　例如：%-4relative 表示，将輸出從程式啟動到建立日志記錄的時間進行左對齊且最小寬度為4。

啦啦啦