ByteBuf 的释放

文章来源Reference counted objects 和 Netty官方文档翻译

看完本篇文章在看ByteBuf 的回收 recycler，会更好理解

自从Netty 4开始，对象的生命周期由它们的引用计数（reference counts）管理，而不是由垃圾收集器（garbage collector）管理了。ByteBuf是最值得注意的，它使用了引用计数来改进分配内存和释放内存的性能。

每个对象的初始计数为1：

ByteBuf buf = ctx.alloc().directBuffer();  
assert buf.refCnt() == 1;  

当你释放（release）引用计数对象时，它的引用计数减1.如果引用计数为0，这个引用计数对象会被释放（deallocate），并返回对象池。

assert buf.refCnt() == 1;  
// release() returns true only if the reference count becomes 0.  
boolean destroyed = buf.release();  
assert destroyed;  
assert buf.refCnt() == 0;  

悬垂（dangling）引用

尝试访问引用计数为0的引用计数对象会抛出IllegalReferenceCountException异常：

assert buf.refCnt() == 0;  
try {  
  buf.writeLong(0xdeadbeef);  
  throw new Error("should not reach here");  
} catch (IllegalReferenceCountExeception e) {  
  // Expected  
}  

增加引用计数

可通过retain()操作来增加引用计数，前提是此引用计数对象未被销毁：
（译者注：跟未使用ARC的objective-c好像）

ByteBuf buf = ctx.alloc().directBuffer();  
assert buf.refCnt() == 1;  
  
buf.retain();  
assert buf.refCnt() == 2;  
  
boolean destroyed = buf.release();  
assert !destroyed;  
assert buf.refCnt() == 1;  

谁来销毁（destroy）

通常的经验法则是谁最后访问（access）了引用计数对象，谁就负责销毁（destruction）它。具体来说是以下两点：

• 如果组件（component）A把一个引用计数对象传给另一个组件B，那么组件A通常不需要销毁对象，而是把决定权交给组件B。
• 如果一个组件不再访问一个引用计数对象了，那么这个组件负责销毁它。

public ByteBuf a(ByteBuf input) {  
    input.writeByte(42);  
    return input;  
}  
  
public ByteBuf b(ByteBuf input) {  
    try {  
        output = input.alloc().directBuffer(input.readableBytes() + 1);  
        output.writeBytes(input);  
        output.writeByte(42);  
        return output;  
    } finally {  
        input.release();  
    }  
}  
  
public void c(ByteBuf input) {  
    System.out.println(input);  
    input.release();  
}  
  
public void main() {  
    ...  
    ByteBuf buf = ...;  
    // This will print buf to System.out and destroy it.  
    c(b(a(buf)));  
    assert buf.refCnt() == 0;  
}  

行为（Action） 谁来释放（Who should release）? 谁释放了（Who released）?

1. main()创建了buf buf→main()
2. buf由main()传给了a() buf→a()
3. a()仅仅返回了buf buf→main()
4. buf由main()传给了b() buf→b()
5. b()返回了buf的拷贝 buf→b(), copy→main() b()释放了buf
6. 拷贝由main()传给了c() copy→c()
7. c()消耗（swallow）了拷贝 copy→c() c()释放了拷贝