Mina之IoBuffer

原文：http://mina.apache.org/iobuffer.html

 

IoBuffer用于Mina应用程序。

 

这是一个JDK IoBuffer的替代品，Mina有两个原因没有直接使用：

• 在填充数据的时候没有提供令人满意的getters 和putters 方法，即get/putString, 和get/putAsciiInt()
• 很难写入一个可变长的数据到固定大小的Buffer中。

这些将在Mina3中得到改进。Mina从nio ByteBuffer继承实现的自己的IoBuffer包的的主要原因是让buffers能够可扩展。这是一个很坏的决定。Buffers仅仅只是一个buffers：一个在数据使用前存放零时数据的地方。有很多其他的解决方案存在，例如定义一个继承于NIO ByteBuffers列表的类(like defining a wrapper which relies on a list of NIO ByteBuffers)来代替拷贝一个buffer到一个更大容量的对象，仅仅因为我们想扩张buffer的容量。

 

IoBuffer的操作

分配一个新的Buffer

IoBuffer是一个抽象类，因此不能直接实例化。要使用IoBuffer我们需要两个allocate() 方法。

 

// 使用指定大小实例化一个新的Buffer, 并且可以定义他的类型 (direct 或 heap) 
public static IoBuffer allocate(int capacity, boolean direct) 
// 使用指定大小实例化一个新的Buffer 
public static IoBuffer allocate(int capacity)

 

 allocate()方法拥有1个或2个参数，示例第一个拥有两个参数：

• capacity - Buffer的容量
• direct - Buffer的类型，ture获得一个单一的Buffer，false获得多个Buffer

默认的Buffer是由SimpleBufferAllocator创建。

另外一下代码也可以达到同样的效果

 

 

// 设置创建默认Buffer的类型，这里是heap.
 IoBuffer.setUseDirectBuffer(false); 
// 新建一个Buffer 
IoBuffer buf = IoBuffer.allocate(1024);

 

使用第二种方法之前你必须先指定Buffer类型，否则默认将是Heap。

 

创建自动扩展的Buffer

使用Java NIO的API创建一个可扩展的buffer并不容易，因为要为网络程序填充超过固定大小数据。因此IoBuffer引入autoExpand 属性，他能自动扩展Buffer限制了的容量大小。

IoBuffer buffer = IoBuffer.allocate(8);
buffer.setAutoExpand(true);

buffer.putString("12345678", encoder);
       
// 往Buffer里加入更多内容
buffer.put((byte)10);

 在上例中如果encoder的数据比8字节大buffer的大小将重新设置。Buffer大小将会成倍增长，容量会在字符串最后的位置开始增加。其表现和StringBuffer非常相像。

 

创建自动缩减的Buffer

 

有一种情况就是为了节省内存而从Buffer中释放掉不使用的资源。IoBuffer提供了autoShrink 属性来达到这目的。如果autoShrink 设置启用，当调用compact() 方法后IoBuffer的容量将会减少一半，只有四分之一或者更少的容量会被用到。手动减少容量使用shrink() 方法。

 

IoBuffer buffer = IoBuffer.allocate(16);
buffer.setAutoShrink(true);
buffer.put((byte)1);
System.out.println("Initial Buffer capacity = "+buffer.capacity());
buffer.shrink();
System.out.println("Initial Buffer capacity after shrink = "+buffer.capacity());

buffer.capacity(32);
System.out.println("Buffer capacity after incrementing capacity to 32 = "+buffer.capacity());
buffer.shrink();
System.out.println("Buffer capacity after shrink= "+buffer.capacity());

 初始化容量是16字节，设置autoShrink属性为true

看看输出如下：

 

Initial Buffer capacity = 16
Initial Buffer capacity after shrink = 16
Buffer capacity after incrementing capacity to 32 = 32
Buffer capacity after shrink= 16

从输出结果我们可知：

• 初始化Buffer的容量是16字节，也是Buffer的最小容量。
• 调用shrink()方法后，容量依然是16字节，容量永远不会小于最小容量。
• 当增加体积到32字节，体积变为32.
• 调用shrink()方法后，容量减少到16字节，删去了多余的存储空间。

 Buffer的分配

IoBufferAllocater专门Buffer的分配和管理。实现IoBufferAllocater接口后可控制Buffer的分配管理。Mina的以下类实现了IoBufferAllocater接口：

• SimpleBufferAllocator（默认）- 任何时间创建一个新的Buffer
• CachedBufferAllocator - 当buffer需要复用时缓存buffer

 

评论

2 楼 yakczh 2014-02-16  

http://mina.apache.org/mina-project/userguide/ch8-iobuffer/ch8-iobuffer.html

1 楼 Cn_kavin 2010-07-12  

直接翻译啊，我还以为有什么进展呢