HDFS源码分析之编辑日志编辑相关双缓冲区EditsDoubleBuffer

EditsDoubleBuffer是为edits准备的双缓冲区。新的编辑被写入第一个缓冲区，同时第二个缓冲区可以被flush。为edits准备的双缓冲区。新的编辑被写入第一个缓冲区，同时第二个缓冲区可以被flush。在其内部，有两个重要的缓冲区成员变量，如下：

// 当前被写入的缓冲区bufCurrent
private TxnBuffer bufCurrent; // current buffer for writing

// 正在进行flush的缓冲区bufReady
private TxnBuffer bufReady; // buffer ready for flushing

// 初始化缓冲区大小initBufferSize
private final int initBufferSize;

        其中，bufCurrent是当前被写入的缓冲区，当前被写入的缓冲区是正在进行flush的缓冲区，而initBufferSize则是初始化缓冲区大小。我们再看下EditsDoubleBuffer的构造函数，如下：

 // 构造函数
 public EditsDoubleBuffer(int defaultBufferSize) {
   // 根据入参赋值initBufferSizeinitBufferSize
initBufferSize = defaultBufferSize;

// 创建当前被写入的缓冲区bufCurrent
bufCurrent = new TxnBuffer(initBufferSize);

// 创建正在进行flush的缓冲区bufReady
   bufReady = new TxnBuffer(initBufferSize);

 }

        根据入参赋值initBufferSizeinitBufferSize，然后分别创建上述两个缓冲区：创建当前被写入的缓冲区bufCurrent、创建正在进行flush的缓冲区bufReady。

        而EditsDoubleBuffer最基本的写入功能有两个，一个是用于写入操作符的writeOp()方法，另外一个就是用于写入事务的writeRaw()方法，代码分别如下：

// 写入操作符至bufCurrent
public void writeOp(FSEditLogOp op) throws IOException {
  bufCurrent.writeOp(op);
}

// 写入事务至bufCurrent
public void writeRaw(byte[] bytes, int offset, int length) throws IOException {
  bufCurrent.write(bytes, offset, length);
}

        均是将操作符或事物写入bufCurrent缓冲区。而在准备flush前，需要先调用setReadyToFlush()方法，设置缓冲区可以进行flush，代码如下：

 // 设置双缓冲区为可以进行flsuh
 public void setReadyToFlush() {

// 确保之前的数据已经被flush完毕，调用isFlushed()方法判断bufReady的大小是否为0即可
   assert isFlushed() : "previous data not flushed yet";

   // 交换bufReady、bufCurrent
   TxnBuffer tmp = bufReady;
   bufReady = bufCurrent;
   bufCurrent = tmp;
 }

        它首先会确保之前的数据已经被flush完毕，调用isFlushed()方法判断bufReady的大小是否为0即可，然后交换bufReady、bufCurrent。

        接着，我们需要调用flushTo()方法，将bufReady的内容写入指定输出流，并清空bufReady。此时不交换任何缓冲区，代码如下：

/**
 * Writes the content of the "ready" buffer to the given output stream,
 * and resets it. Does not swap any buffers.
 * 将bufReady的内容写入指定输出流，并清空bufReady。此时不交换任何缓冲区。
 */
public void flushTo(OutputStream out) throws IOException {
  bufReady.writeTo(out); // write data to file
  bufReady.reset(); // erase all data in the buffer
}

        而bufCurrent、bufReady都是一个TxnBuffer类型的缓冲区，这个TxnBuffer是对DataOutputBuffer的一个封装，保存了第一个事务艾迪firstTxId、事务数量numTxns、写入者writer等变量，它主要的两个方法，一个是写入操作符的writeOp()方法，实现如下：

// 写入操作符
public void writeOp(FSEditLogOp op) throws IOException {

  // 首次事务艾迪firstTxId被赋值为操作符的事务ID
  if (firstTxId == HdfsConstants.INVALID_TXID) {
    firstTxId = op.txid;
  } else {

    // 之后确保操作符的事务ID永远大于首次事务ID
    assert op.txid > firstTxId;
  }

  // 调用writer写入操作符
  writer.writeOp(op);

  // 事务数量numTxns累加
  numTxns++;
}

        首次事务艾迪firstTxId被赋值为操作符的事务ID，之后确保操作符的事务ID永远大于首次事务ID，然后调用writer写入操作符，并将事务数量numTxns累加。