1. 什么是encoder??

1.1. Encoder負(fù)責(zé)兩件事, 一是把事件轉(zhuǎn)換為字節(jié)數(shù)組, 二是把字節(jié)數(shù)組寫入輸出流。在logback 0.9.19版之前沒有encoder。在之前的版本里, 多數(shù)appender依靠layout來把事件轉(zhuǎn)換成字符串并用java.io.Writer把字符串輸出。在之前的版本里, 用戶需要在FileAppender里嵌入一個(gè)PatternLayout。而從0.9.19版開始, FileAppender和其子類使用encoder, 不接受layout。

2. 為什么變了??

2.1. Layout只負(fù)責(zé)把事件轉(zhuǎn)換為字符串。此外, 因?yàn)閘ayout不能控制事件何時(shí)被寫出, 所以不能成批地聚集事件。相比之下, encoder不但可以完全控制待寫出的字節(jié)的格式, 而且可以控制字節(jié)何時(shí)及是否被寫出。

2.2. 目前, PatternLayoutEncoder是唯一有用的encoder, 它基本上是封裝了PatternLayout, 讓PatternLayout負(fù)責(zé)大多數(shù)工作。因此, 似乎encoder并沒有帶來多少好東西, 反而只有不需要的復(fù)雜性。然而, 我們希望當(dāng)新的、強(qiáng)大的encoder到來時(shí), 這種印象會改變。

3. Encoder接口?

3.1. Encoder負(fù)責(zé)把事件轉(zhuǎn)換為字節(jié)數(shù)組并把字節(jié)數(shù)組寫出到合適的輸出流。因此, encoder可以完全控制在什么時(shí)候、把什么樣的字節(jié)寫入到由其擁有者appender維護(hù)的輸出流。

3.2. Encoder接口

4. LayoutWrappingEncoder類?

4.1. 在logback0.9.19版之前, appender依賴layout提供輸出格式的靈活性。因?yàn)橛写罅楷F(xiàn)存代碼是基于layout接口的, 所以我們需要想辦法讓encoder與layout實(shí)現(xiàn)互操作。 LayoutWrappingEncoder連接了encoder和layout, 它實(shí)現(xiàn)encoder接口, 并且包裹了一個(gè)layout, layout負(fù)責(zé)把事件轉(zhuǎn)換成字符串。

4.2. 下面是LayoutWrappingEncoder類的代碼片段, 闡述了如何把工作委托給layout實(shí)例。

4.3. encode方法首先讓被包裹的layout把傳入的事件轉(zhuǎn)換成字符串, 再根據(jù)用戶選擇的字符集編碼把字符串轉(zhuǎn)換成字節(jié)。start方法自己寫入其擁有者appender指定的輸出流。

5. PatternLayoutEncoder類

5.1. 既然PatternLayout是最常用的layout, logback便提供了PatternLayoutEncoder, 它擴(kuò)展了LayoutWrappingEncoder, 且僅使用PatternLayout。從logback 0.9.19版起, FileAppender或其子類在只要用到PattternLayout時(shí), 都必須換成PatternLayoutEncoder。

5.2. PatternLayoutEncoder類

總結(jié)

以上是生活随笔為你收集整理的016_logback中的Encoder的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。