文档章节

netty io.netty.buffer简介

andyyuan5546
 andyyuan5546
发布于 2015/08/11 23:39
字数 2394
阅读 2860
收藏 1

io.netty.util.ReferenceCounted

此接口代表一个引用计数的对象,此对象需要显示的释放.

当一个ReferenceCounted对象被实例化的时候,该对象的引用数量就是1,调用retain()方法会增加引用数量,调用 release()
方法会减少引用数量,如果引用数量减少到0,该对象就需要显示释放掉。访问释放掉的对象通常会导致访问冲突。

如果实现ReferenceCounted接口的对象是一个包含同样实现ReferenceCounted接口的对象的容器。当容器的引用数量变为0的时候,容器中的对象也要通过release()方法来释放掉。

主要方法:

int refCnt(); //返回当前对象的引用数量,如果返回零,说明当前对象已经被释放掉了

ReferenceCounted retain();//引用数量增加1

ReferenceCounted retain(int increment);//引用计数增加给定值increment

ReferenceCounted touch();\\此方法记录对象的当前访问位置,主要用来调试。如果确定当前对象内存泄露,通过此操作记
\\录的信息将通过ResourceLeakDetector提供给你

ReferenceCounted touch(Object hint);\\此方法记录对象的当前访问位置并附加一个hint对象,主要用来调试。如果
\\确定当前对象内存泄露,通过此操作记录的信息将通过ResourceLeakDetector提供给你

boolean release();\\引用计数减1,如果引用计数变为0了,则显示的释放掉该对象,当且仅当引用计数变为0且该对象已
\\被释放掉才返回ture,否则返回false

boolean release(int decrement);\\引用计数减少给定值decrement,如果引用计数变为0了,则显示的释放掉该对象,
当且仅当引用计数变为0且该对象已被释放掉才返回ture,否则返回false

io.netty.buffer.ByteBuf

这是一个随机和顺序访问的序列其包含0或者多个字节,此接口为一个或者多字节数组和NIO buffers提供了一个抽象试图

  • 创建buffer

    建议使用辅助方法创建一个新的缓冲区不要调用具体实现的构造函数。

  • 随进访问索引

    就像普通的byte数组一样ByteBuf使用基于0的索引,也就是第一个的索引是0最后一个元素的索引是capacity-1,下面举例迭代访问buffer中的所有字节,做如下操作的时候你可以忽略其内部实现:

ByteBuf buffer = ...;
 for (int i = 0; i < buffer.capacity(); i ++) {
     byte b = buffer.getByte(i);
     System.out.println((char) b);
 }

  • 顺序访问索引

    ByteBuf 提供了两个指针变量来分别支持读和写操作, readerIndex 用于读操作writerIndex 用于写操作. 下面的图展示了一个buffer使如何被两个指针分割成三个区域的:

      +-------------------+------------------+------------------+
      | discardable bytes |  readable bytes  |  writable bytes  |
      |                   |     (CONTENT)    |                  |
      +-------------------+------------------+------------------+
      |                   |                  |                  |
      0      <=      readerIndex   <=   writerIndex    <=    capacity

    discardable bytes代表可废弃的区域,readable bytes代码可读区域,writable bytes代表可写区域 readerIndex代表读的起点,writerIndex代表写的起点,capacity代表容量

  • 可读区域(实际内容)

        这个区域存储的是实际的数据或者叫有效的数据.  任何以read或者skip开头的操作(任何是指本类中的任何方法)都会得到或者跳过当前readerIndex指示的数据,并且readerIndex会根据读取或者跳过的字节数自增。如果读取         操作的参数也是一个Byte并且没有指定目标ByteBuf的起始index,则该参数ByteBuf的writerIndex也要跟着一起增长。

        如果没有足够的数据供读取则报IndexOutOfBoundsException。新分配、wrapped或者拷贝的buffer,其readerIndex是0.相关读取操作如下:

 // Iterates the readable bytes of a buffer. ByteBuf buffer = ...;
 while (buffer.readable()) {
     System.out.println(buffer.readByte());
 }

  • 可写数据区域

    此区域是未定义的区域也就是需要往里面写数据的区域。任何以write开始的操作(任何是指本类中的任何方法)将会从writerIndex开始写数据,并且writerIndex会根据写入的数量增加。如果write操作的参数也是一个ByteBuf并且没有制定源Buff的开始index, 那么该参数ByteBuf的readerInx也要跟着一起增长.

    如果没有足够的空间供写入报IndexOutOfBoundsException,新分配的buffer的writerIndex是0.   wrapped 或者copy的 bufferwriterIndex 等于capacity。写入操作代码:

// Fills the writable bytes of a buffer with random integers. ByteBuf buffer = ...;
 while (buffer.maxWritableBytes() >= 4) {
     buffer.writeInt(random.nextInt());
 }

  • 可废弃区域

    这个区域包含的是通过读操作读完的数据区域.初始状态这个区域的大小是0, 随着读操作的调用这个区域会增长到writerIndex的大小. 读过的数据可以通过调用discardReadBytes()方法回收该区域,该方法的功能如下:

BEFORE discardReadBytes()//操作前

      +-------------------+------------------+------------------+
      | discardable bytes |  readable bytes  |  writable bytes  |
      +-------------------+------------------+------------------+
      |                   |                  |                  |
      0      <=      readerIndex   <=   writerIndex    <=    capacity


  AFTER discardReadBytes()//操作后

      +------------------+--------------------------------------+
      |  readable bytes  |    writable bytes (got more space)   |
      +------------------+--------------------------------------+
      |                  |                                      |
 readerIndex (0) <= writerIndex (decreased)        <=        capacity

    需要注意的是,不能保证可写区域的数据内容,可写区域的内容多数情况下不会跟着移动,甚至有可能被不同的数据填充,这依赖于具体的buffer实现。

  • 清空缓冲索引

    你可以通过调用clear()方法来将readerIndexwriterIndex 设置为 0. 但是不会清除内容,而只是重置了两个指针.  注意这里的clear()方法语义和java.nio.Buffer.clear()语义是不一样的。

BEFORE clear()

      +-------------------+------------------+------------------+
      | discardable bytes |  readable bytes  |  writable bytes  |
      +-------------------+------------------+------------------+
      |                   |                  |                  |
      0      <=      readerIndex   <=   writerIndex    <=    capacity


  AFTER clear()

      +---------------------------------------------------------+
      |             writable bytes (got more space)             |
      +---------------------------------------------------------+
      |                                                         |
      0 = readerIndex = writerIndex            <=            capacity

  • search相关操作

    对于简单的字节搜索,使用 indexOf(int, int, byte)bytesBefore(int, int, byte). bytesBefore(byte). 对于复杂的搜索使用 forEachByte(int, int, ByteBufProcessor)方法,该方法需要一个     ByteBufProcessor 的实现类.

  • 标记和充值 (mark reset)

    每个buffer有两个marker indexes. 一个用来存储 readerIndex 另一个用来存储 writerIndex.  可以通过调用reset方法重置,其工作方式类似于InputStream中的mark和reset方法,不同的是其没有readlimit参数.

  • 派生缓冲区(Derived buffers)

    你可以通过调用方法duplicate(), slice() or slice(int, int)来根据现有buffer创建一个试图(view) . 一个派生的buffer会有一个独立的readerIndex, writerIndex 和 marker indexes,同时会共享内部数据,这和Java NIO一样.如果要完整拷贝一个buffer,需要调用copy() 方法.

  • 转换成现有的JAVA类型

    • Byte array

      如果ByteBuf内部实现是一个byte[], 可以通过调用array() 方法来访问数组.  判断是否是byte[]可以调用 hasArray()方法.

      NIO Buffers

      通过调用nioBuffer()方法可以得到一个NIO buffer,判断能否进行转换可以调用nioBufferCount()方法.

      Strings

      可以调用提供的多个 toString(Charset) 方法将 ByteBuf 转换为 String.  需要注意的是,toString() 不是转换方法,而是继承Object的toString()方法

      I/O Streams

      参考 ByteBufInputStreamByteBufOutputStream.


io.netty.buffer.ByteBufAllocator

    该接口的实现类负责创建buffer,接口实现类必须是线程安全的。

io.netty.buffer.ByteBufHolder

    发送接收的数据包

io.netty.buffer.AbstractByteBuf

    实现bytebuf的一个骨架

io.netty.buffer.AbstractByteBufAllocator

    ByteBufAllocator的骨架

io.netty.buffer.AbstractDerivedByteBuf

    Bytebuf的一个抽象基类,其主要功能是实现了能够封装另一个Bytebuf

io.netty.buffer.AbstractReferenceCountedByteBuf

    ByteBuf的一个抽象基类,主要功能是实现了引用计数的功能,即ReferenceCounted借口的功能(retain和release、touch方法)

io.netty.buffer.ByteBufInputStream

    继承了InputStream类,该类可以从ByteBuf中读取数据,对该对象进行读操作的时候内部buffer的readerIndex也会增加,需要注意的是读取的字节数量在初始化该对象的时候已经确定了(构造函数内部,初始化的时候已经和设置了长度),后面在对该buffer写数据,对该对象来讲,不会读到。

    改流还是DataInput借口,字节的序列并不总是大端序列(big endian),这取决于内部buffer实现

io.netty.buffer.ByteBufOutputStream

     继承了OutputStream类,该类可以向ByteBuf中写数据,对该对象进行写操作的时候内部buffer的writerindex也会增加,改流还是DataOutput借口,字节的序列并不总是大端序列(big endian),这取决于内部buffer实现

io.netty.buffer.ByteBufUtil

    这是一个处理ByteBuf对象的一些方法的工具类.

io.netty.buffer.CompositeByteBuf

    这是一个虚拟bufer,实际上是一个组合buffer,其内部封装了多个buffer,其功能就是将多个buffer组合成一个buffer,推荐使用ByteBufAllocator.compositeBuffer() 或者Unpooled.wrappedBuffer(ByteBuf...)来创建CompositeByteBuf对象,不要直接调用构造函数来创建对象

io.netty.buffer.DefaultByteBufHolder

    ByteBufHolder的默认实现,期功能就是把数据存储在bytebuf中   

io.netty.buffer.DuplicatedByteBuf

    一个派生buffer,简单的把所有的数据访问请求发送给内部的buffer。简易通过ByteBuf.duplicate()方法来创建该对象。该对象与其内部bufer共享数据,只不过二者的readerindex和writerindex是独立的。

io.netty.buffer.EmptyByteBuf

    这是一个空的ByteBuf,容量是0

io.netty.buffer.PooledByteBufAllocator

    带缓冲的ByteBufAllocator

io.netty.buffer.ReadOnlyByteBuf

    这个一个派生buffer,他禁止写操作发送给内部buffer,简易通过 Unpooled.unmodifiableBuffer(ByteBuf) 方法来创建对象


io.netty.buffer.SliceByteBuf

    一个派生buffer,他的功能是仅仅暴露内部buffer的一个自区域,就是切片,推荐通过ByteBuf.slice() andByteBuf.slice(int, int)方法来创建对象

io.netty.buffer.SwappedByteBuf

    一个包装buffer,其功能是交换bytebuf的字节序列,即大端序列和小端序列的转换


io.netty.buffer. Unpooled

    

io.netty.buffer.UnpooledByteBufAllocator

带缓冲的ByteBufAllocator

io.netty.buffer.UnpooledDirectByteBuf

基于NIO ByteBuffer的ByteBuf,推荐通过调用Unpooled.directBuffer(int)或者Unpooled.wrappedBuffer(ByteBuffer)方法来创建对象

io.netty.buffer.UnpooledHeapByteBuf

大端序列的java堆buffer实现

io.netty.buffer.Unpooled

相当于一个工具类,可以创建Bytebuf




© 著作权归作者所有

andyyuan5546
粉丝 1
博文 4
码字总数 7087
作品 0
海淀
私信 提问
Netty 4.0 源码分析(四):ByteBuf

Netty是基于流的消息传递机制。Netty框架中,所有消息的传输都依赖于ByteBuf接口,ByteBuf是Netty NIO框架中的缓冲区。ByteBuf接口可以理解为一般的Byte数组,不过Netty对Byte进行了封装,增...

GreenDay
2014/09/13
1K
0
【Netty】Netty实例开源项目

版权声明:本文为谙忆原创文章,转载请附上本文链接,谢谢。 https://blog.csdn.net/qq_26525215/article/details/81989644 Netty netty-not-sticky-pack-demo 项目地址 Netty 本篇博客讲解:...

谙忆
2018/08/23
0
0
Netty in Action - Norman Maurer

出版时间:2015年12月 语言:英语 下载地址:EPUB&PDF 内容简介: About the technology Netty is a Java-based networking framework that manages complex networking, multithreading, a......

kklin
2016/02/15
3
0
Java NIO框架Netty教程(一) – Hello Netty

先啰嗦两句,如果你还不知道Netty是做什么的能做什么。那可以先简单的搜索了解一下。我只能说Netty是一个NIO的框架,可以用于开发分布式的Java程序。具体能做什么,各位可以尽量发挥想象。技...

forever_coder
2014/01/23
540
0
源码之下无秘密 ── 做最好的 Netty 源码分析教程

背景 在工作中, 虽然我经常使用到 Netty 库, 但是很多时候对 Netty 的一些概念还是处于知其然, 不知其所以然的状态, 因此就萌生了学习 Netty 源码的想法. 刚开始看源码的时候, 自然是比较痛苦...

永顺
2017/11/29
0
0

没有更多内容

加载失败,请刷新页面

加载更多

HashMap源码分析

read

V丶zxw
41分钟前
5
0
Python字符串或JSON字符串转字典dict、列表list

有3种方法 1、使用ast模块 >>> import ast>>> s = '["test",1]'>>> ast.literal_eval(s)['test',1]>>> s = '{"test":1}'>>> ast.literal_eval(s){'test': 1} 2、eval函数,这个......

编程老陆
今天
5
0
【JS复习笔记】03 继承(从ES5到ES6)

本文转载于:专业的前端网站➫【JS复习笔记】03 继承(从ES5到ES6) 前言 很久以前学习《Javascript语言精粹》时,写过一个关于js的系列学习笔记。 最近又跟别人讲什么原型和继承什么的,发现...

前端老手
今天
8
0
简单动态网站搭建

如何在windows服务器上配置wordPress和discuz 网站建设中的概念讲解 网站建设的基础操作 网站程序的基础使用 网站程序的优化 简单动态网站搭建 软件部署 域名和主机的购买 域名解析 环境部署...

达达前端小酒馆
今天
6
0
Java每日面试题_03

15、构造器是否可被override constructor(构造器)不能被继承,所以不能被override(重写),但是可以被overloading(重载)。 16、抽象类和接口的区别 抽象类是什么 含有abstract修饰符的class即...

庭前云落
今天
6
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部