Netty的ByteBuf API(2)

继上一章 Netty之ByteBuf 之后,我们继续来谈 ByteBuf 的 API

清理操作

discardReadBytes 操作

因为 TCP 底层可能粘包,几百个整包消息被 TCP 粘包后作为一个整包发送。这样,通过 discardReadBytes 操作可以重用之前已经解码过的缓冲区,从而防止接收缓冲区因为容量不足导致的扩张。
需要指出的是,调用 discardReadBytes 会发生字节数组的内存复制,所以频繁调用将会导致性能下降,因此在调用它之前要确认你确实需要这样做,例如牺牲性能来换取更多的可用内存。
Netty的ByteBuf API(2)
如图所示,capacity 保持不变,reaerIndex = 0,writerIndex -= readerIndex,红色部分的数据发生拷贝。

clear 操作

clear 操作主要用来操作位置指针,并不会清空缓冲区内容本身。

mark 操作

mark 操作针对之前的操作进行回滚

  • markReaderIndex() : markedReaderIndex = readerIndex
  • resetReaderIndex() : readerIndex = markedReaderIndex
  • markWriterIndex() : markedWriterIndex = writerIndex
  • resetWriterIndex() : writerIndex = markedReaderIndex

查找操作

查找操作的返回值特点:找到了符合条件的,返回索引,否则返回-1
查找操作的参数特点 :可以指定起始坐标和查找长度,但是起始坐标+查找长度不能超过可读字节数。

  • 第一类:从当前 ByteBuf 定位中首次出现 value 的位置
indexOf(fromIndex:int, toIndex:int, value:byte) // 起始索引 fromIndex,终点 toIndex
bytesBefore(value:byte)                         // 起始索引 readerIndex,终点 writerIndex
bytesBefore(length:int, value:byte)             // 起始索引 readerIndex,终点 readerIndex+length <= writerIndex
bytesBefore(index:int, length:int, value:byte)  // 起始索引 index,终点 index+length <= writerIndex
  • 第二类:指明一个函数参数 ByteBufProcessor
forEachByte(processor:ByteBufProcessor)                        // 起始索引 readerIndex,终点 writerIndex
forEachByte(index:int, length:int, processor:ByteBufProcessor) // 起始索引 index,终点 index+length
forEachByteDesc(processor:ByteBufProcessor)                    // 起始索引 writerIndex-1,直到 readerIndex
forEachByteDesc(index:int, length:int, processor:ByteBufProcessor) // 起始索引 index,直到 index+length

ByteBufProcessor

  • 可以查找非某字节 以 FIND_NOT_ 为前缀
  • 寻找空字节 FIND_NUL : NUL (0x00)
  • 寻找回车 FIND_CR : CR (‘\r‘)
  • 寻找换行符 FIND_LF : LF (‘\n‘)
  • 寻找回车或者换行符 FIND_CRLF : CR (‘\r‘) or LF (‘\n‘)
  • 寻找空格 FIND_ASCII_SPACE : (‘ ‘)
  • 寻找行内空白 FIND_LINEAR_WHITESPACE : (‘ ‘) or (‘\t‘)
  • 寻找分号 FIND_SEMI_COLON : (‘;‘)
  • 寻找逗号 FIND_COMMA : (‘,‘)

Derived buffers

类似于数据库的视图,ByteBuf 提供了多个接口用于创建某个 ByteBuf 的视图或者复制 ByteBuf,具体方法如下:

创建共享缓冲区的视图

duplicate():ByteBuf

  • 共享缓冲区:复制后的缓冲区与操作的 ByteBuf 共享缓冲区内容
  • 独立索引:复制后的新 ByteBuf 对象维护自己独立的读写索引,复制操作本身不修改原 ByteBuf 读写索引。

创建独立的副本

copy():ByteBuf
copy(int index, int length):ByteBuf

  • 独立缓冲区:复制后的缓冲区,独立于操作的 ByteBuf 缓冲区,包含操作的 ByteBuf 中的全部或者局部的内容
  • 独立索引:新 ByteBuf 对象的读写索引与之前的独立

创建子缓冲区

创建缓冲区可读字节的切片
slice():ByteBuf // 起始位置从 readerIndex 到 writerIndex
slice(int index, int length) // 起始位置从 index 到 index + length

  • 共享缓冲区:返回后的 ByteBuf 与 原 ByteBuf 内容共享
  • 独立索引:读写索引独立维护。初始化时,readerIndex=0,writerIndex 等于可读字节数,或者等于参数 length

转换成标准 ByteBuffer

nioBuffer():ByteBuffer
nioBuffer(int index, int length):ByteBuffer
两者共享同一个缓冲区内容引用。对 ByteBuffer 的读写操作不会改变 ByteBuf 的读写索引。
需要注意的是,返回后的 ByteBuffer 无法感知原 ByteBuf 的动态拓展操作。

Netty的ByteBuf API(2)

上一篇:win10下安装虚拟环境


下一篇:潜谈Restful API