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的优点:
java日志框架系列(6):logback框架encoder详解_第1张图片

 2.Encoder接口详解

Encoder负责把事件转换为字节数组,并把字节数组写到合适的输出流。因此,encoder可以控制在什么时候、把什么样的字节数组写入到其拥有者维护的输出流中。Encoder接口有两个实现类,LayoutWrappingEncoderPatternLayoutEncoder

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 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类详解

java日志框架系列(6):logback框架encoder详解_第2张图片

 

 下面通过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 extends EncoderBase {   protected Layout 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。

 

 

你可能感兴趣的:(java日志框架系列(6):logback框架encoder详解)