java日志框架系列（6）：logback框架encoder详解

1.Encoder

1.encoder功能

Encoder 负责两件事，一是 把事件转换为字节数组，二是 把字节数组写入输出流。

注意：在logback 0.9.19 版以前没有 encoder。

在以前的版本里，多数 appender 依靠 layout 来把事件转换成字符串并用 java.io.Writer 把字符串输出。在以前的版本里，用户须要在 FileAppender里嵌入一个 PatternLayout。 而从 0.9.19 版开始，FileAppender 和其子类使用 encoder，不接受 layout。

 

encoder相比layout的优势：

 2.Encoder接口详解

Encoder负责把事件转换为字节数组，并把字节数组写到合适的输出流。所以，encoder能够控制在何时、把什么样的字节数组写入到其拥有者维护的输出流中。Encoder接口有两个实现类，LayoutWrappingEncoder与PatternLayoutEncoder。

Encoder接口代码以下：

package ch.qos.logback.core.encoder;
import java.io.IOException;
import java.io.OutputStream;
import ch.qos.logback.core.spi.ContextAware;
import ch.qos.logback.core.spi.LifeCycle;
public interface Encoder<E> extends ContextAware, LifeCycle {
/**
* This method is called when the owning appender starts or 
* whenever output needs to be directed to a new OutputStream, 
* for instance as a result of a rollover.
*/
void init(OutputStream os) throws IOException;
/**
* Encode and write an event to the appropriate {@link OutputStream}.
* Implementations are free to differ writing out of the encoded
* event andinstead write in batches.
*/
void doEncode(E event) throws IOException;
/**
* This method is called prior to the closing of the underling
* {@link OutputStream}. Implementations MUST not close the underlying
* {@link OutputStream} which is the responsibility of the
* owning appender.
*/
void close() throws IOException;
}

1.LayoutWrappingEncoder类详解

 

 下面经过LayoutWrappingEncoder类的部分源码，阐述如何把工做委托给Layout：

package ch.qos.logback.core.encoder;
import java.io.IOException;
import java.nio.charset.Charset;
import ch.qos.logback.core.Layout;
public class LayoutWrappingEncoder<E> extends EncoderBase<E> {
　　protected Layout<E> layout;
　　private Charset charset;
　　public void doEncode(E event) throws IOException {
　　　　String txt = layout.doLayout(event);
　　　　outputStream.write(convertToBytes(txt));
　　　　outputStream.flush();
　　}
　　private byte[] convertToBytes(String s) {
　　　　if (charset == null) {
　　　　　　return s.getBytes();
　　　　} else {
　　　　　　return s.getBytes(charset);
　　　　} 
　　}
}

doEncode()方法首先让被包裹的 layout 把传入的事件转换成字符串，再根据用户选择的字符集编码把字符串转换成字节，而后把本身写入其拥有者 appender 指定的输出流，输出 流被当即冲出（flush）。

 2.PatternLayoutEncoder类详解

因为PatternLayout是最经常使用的Layout，所以logback提供了PatternLayoutEncoder，它扩展了LayoutWrappingEncoder，且仅使用PatternLayout。

注意：从logback0.9.19版起，FileAppender或其子类（好比，RollingFileAppender）在只要用到PatternLayout时，都必须换成PatternLayoutEncoder。