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

標籤：format   文法   方法   lin   back   表示   寫入   輸出   add   

附：

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  cn	輸出上下文名稱。
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 是Regex，將p 中符合r 的內容替換為t 。 例如， "%replace(%msg){‘\s‘, ‘‘}"

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

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

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

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

啦啦啦

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