一、创建
1、池化创建
ByteBufAllocator
获取ByteBufAllocator
Channel channel = ...;ByteBufAllocator allocator = channel.alloc();
//1
....ChannelHandlerContext ctx = ...;ByteBufAllocator allocator2 = ctx.alloc();
//2
ByteBufAllocator中创建byteBuf的方法
名称
|
描述
|
buffer() buffer(int) buffer(int, int)
|
Return a ByteBuf with heap-based or direct data storage.
|
heapBuffer() heapBuffer(int) heapBuffer(int, int)
|
Return a ByteBuf with heap-based storage.
|
directBuffer() directBuffer(int) directBuffer(int, int)
|
Return a ByteBuf with direct storage.
|
compositeBuffer() compositeBuffer(int) heapCompositeBuffer() heapCompositeBuffer(int) directCompositeBuffer()directCompositeBuffer(int)
|
Return a CompositeByteBuf that can be expanded by adding heapbased or direct buffers.
|
ioBuffer()
|
Return a ByteBuf that will be used for I/O operations on a socket.
|
2、Unpooled (非池化)缓存
当未引用 ByteBufAllocator 时,上面的方法无法访问到 ByteBuf。对于这个用例 Netty 提供一个实用工具类称为 Unpooled,,它提供了静态辅助方法来创建非池化的 ByteBuf 实例。表5.9列出了最重要的方法
Table 5.9 Unpooled helper class
名称
|
描述
|
buffer() buffer(int) buffer(int, int)
|
Returns an unpooled ByteBuf with heap-based storage
|
directBuffer() directBuffer(int) directBuffer(int, int)
|
Returns an unpooled ByteBuf with direct storage
|
wrappedBuffer()
|
Returns a ByteBuf, which wraps the given data.
|
copiedBuffer()
|
Returns a ByteBuf, which copies the given data
|
在 非联网项目,该 Unpooled 类也使得它更容易使用的 ByteBuf API,获得一个高性能的可扩展缓冲 API,
3、
ByteBufUtil创建 (ByteBufUtil中有很多操作buf的API)
二、读 get/read get不会改变读索引,read会改变读索引
getBoolean(int)
|
返回当前索引的 Boolean 值
|
getByte(int) getUnsignedByte(int)
|
返回当前索引的(无符号)字节
|
getMedium(int) getUnsignedMedium(int)
|
返回当前索引的 (无符号) 24-bit 中间值
|
getInt(int) getUnsignedInt(int)
|
返回当前索引的(无符号) 整型
|
getLong(int) getUnsignedLong(int)
|
返回当前索引的 (无符号) Long 型
|
getShort(int) getUnsignedShort(int)
|
返回当前索引的 (无符号) Short 型
|
getBytes(int, ...)
|
字节
|
方法名称
|
描述
|
readBoolean()
|
返回当前索引的Boolean值,读索引加一
|
readByte()
readUnsignedByte()
|
返回当前索引的(无符号)字节,读索引加一
|
readMedium()
readUnsignedMedium()
|
返回当前索引的 (无符号) 24-bit 中间值,读索引加3
|
readInt()
readUnsignedInt()
|
返回当前索引的(无符号) 整型,读索引加4
|
readLong()
readUnsignedLong()
|
返回当前索引的 (无符号) Long 型,读索引加8
|
readShort()
readUnsignedShort()
|
返回当前索引的 (无符号) Short 型,读索引加2
|
readBytes(int,int, ...)
|
、放回当前位置到length
得一个字节数组,读索引加length
|
三、写操作 set/write
方法名称
|
描述
|
setBoolean(int, boolean)
|
在指定的索引位置设置 Boolean 值
|
setByte(int, int)
|
在指定的索引位置设置 byte 值
|
setMedium(int, int)
|
在指定的索引位置设置 24-bit 中间 值
|
setInt(int, int)
|
在指定的索引位置设置 int 值
|
setLong(int, long)
|
在指定的索引位置设置 long 值
|
setShort(int, int)
|
在指定的索引位置设置 short 值
|
方法名称
|
描述
|
writeBoolean(boolean)
|
在指定的索引位置设置 Boolean 值,写索引加一
|
writeByte(int)
|
在指定的索引位置设置 byte 值,写索引加一
|
writeMedium(int)
|
在指定的索引位置设置 24-bit 中间 值,写索引加3
|
writeInt(int)
|
在指定的索引位置设置 int 值,写索引加4
|
writeLong(long)
|
在指定的索引位置设置 long 值,写索引加8
|
writeShort(int)
|
在指定的索引位置设置 short 值,写索引加2
|
writeBytes(int,...)
|
在当前索引写入一个Byte数组,写索引加数组长度
|
四、索引管理
markReaderIndex(),
markWriterIndex()
|
标记读(写)索引
|
resetReaderIndex()
resetWriterIndex()
|
读(写)索引回到mark标记的索引值
|
readerIndex(int)
writerIndex(int)
|
将读(写)索引设置到指定位置
|
clear()
|
可以同时设置 readerIndex 和 writerIndex 为 0。这不会清除内存中的内容
|
五、查找
for
EachByte(ByteBufProcessor.FIND_NUL)
|
查找byte,返回byte的索引
|
六、副本
duplicate()
slice()
slice(int, int)
readOnly(),
order(ByteOrder)
|
所有这些都返回一个新的 ByteBuf 实例包括它自己的 reader, writer 和标记索引。然而,内部数据存储共享就像在一个 NIO 的 ByteBuffer
|
copy()
copy(int, int)
|
返回的 ByteBuf 有数据的独立副本。
|
七、其他
方法名称
|
描述
|
isReadable()
|
返回是否有字节可读
|
isWritable()
|
返回是否可以写
|
readableBytes()
|
返回可以读的字节长度
|
writablesBytes()
|
返回可以写的字节场地
|
capacity()
|
返回byteBuf的容量
|
maxCapacity()
|
返回byteBuf可以有的最大容量
|
hasArray()
|
如果byteBuf可以直接返回一个数组就返回true
(heap buf才会为true)
|
array()
|
hasArray返回true,该方法就会返回一个数组
|