java Channel

Channel
Channel与流
基本上，全部的 IO 在NIO 中都从一个Channel 开始。Channel 有点象流。数据能够从Channel读到Buffer中，也能够从Buffer 写到Channel中。

Java NIO的通道相似流，但又有些不一样：

既能够从通道中读取数据，又能够写数据到通道。但流的读写一般是单向的；
通道能够异步地读写；
通道中的数据老是要先读到一个Buffer，或者老是要从一个Buffer中写入。
正如上面所说，从通道读取数据到缓冲区，从缓冲区写入数据到通道。以下图所示：



Channel的实现
这些是Java NIO中最重要的通道的实现：

FileChannel
DatagramChannel
SocketChannel
ServerSocketChannel
FileChannel 从文件中读写数据。FileChannel没法设置为非阻塞模式，它老是运行在阻塞模式下。

DatagramChannel 能经过UDP读写网络中的数据。

SocketChannel 能经过TCP读写网络中的数据。

ServerSocketChannel能够监听新进来的TCP链接，像Web服务器那样。对每个新进来的链接都会建立一个SocketChannel。

这些通道涵盖了UDP 和 TCP 网络IO，以及文件IO。

基本的Channel示例
下面是一个使用FileChannel读取数据到Buffer中的示例：

RandomAccessFile aFile = new RandomAccessFile("data/nio-data.txt","rw");
FileChannel inChannel = aFile.getChannel();
 
ByteBuffer buf = ByteBuffer.allocate(48); 
int bytesRead = inChannel.read(buf);

while (bytesRead != -1) { 
  System.out.println("Read " + bytesRead);
  buf.flip();
 
  while(buf.hasRemaining()){
    System.out.print((char) buf.get());
  }
 
  buf.clear();
  bytesRead = inChannel.read(buf);
}
aFile.close();
 
注意 buf.flip() 的调用，首先读取数据到Buffer，而后反转Buffer,接着再从Buffer中读取数据。 
Buffer
Java NIO中的Buffer用于和NIO通道进行交互。数据是从通道读入缓冲区，从缓冲区写入到通道中的。

缓冲区本质上是一块能够写入数据，而后能够从中读取数据的内存。这块内存被包装成NIO Buffer对象，并提供了一组方法，用来方便的访问该块内存。

Buffer的基本用法
使用Buffer读写数据通常遵循如下四个步骤：

写入数据到Buffer
调用flip()方法——将Buffer从写模式切换到读模式
从Buffer中读取数据
调用clear()方法或者compact()方法——清空缓冲区
当向buffer写入数据时，buffer会记录下写了多少数据。

一旦要读取数据，须要经过flip()方法将Buffer从写模式切换到读模式。在

读模式下，能够读取以前写入到buffer的全部数据。

一旦读完了全部的数据，就须要清空缓冲区，让它能够再次被写入。有两种方式能清空缓冲区：调用clear()或compact()方法。 clear()方法会清空整个缓冲区。compact()方法只会清除已经读过的数据。任何未读的数据都被移到缓冲区的起始处，新写入的数据将放到缓冲区未读数据的后面。

capacity, position, limit
缓冲区本质上是一块能够写入数据，而后能够从中读取数据的内存。这块内存被包装成NIO Buffer对象，并提供了一组方法，用来方便的访问该块内存。

为了理解Buffer的工做原理，须要熟悉它的三个属性：capacity，position和limit。

position和limit的含义取决于Buffer处在读模式仍是写模式。无论Buffer处在什么模式，capacity的含义老是同样的。

这里有一个关于capacity，position和limit在读写模式中的说明，详细的解释在插图后面。


capacity

做为一个内存块，Buffer有一个固定的大小值，也叫“capacity”。你只能往里写capacity个byte、long，char等类型。一旦Buffer满了，须要将其清空（经过读数据或者清除数据）才能继续写数据往里写数据。

position

当你写数据到Buffer中时，position表示当前的位置。初始的position值为0。

当一个byte、long等数据写到Buffer 后， position会向前移动到下一个可插入数据的Buffer单元。position最大可为capacity – 1.

当读取数据时，也是从某个特定位置读。当将Buffer从写模式切换到读模式，position会被重置为0. 当从Buffer的position处读取数据时，position向前移动到下一个可读的位置。

limit
在写模式下，Buffer的limit表示你最多能往Buffer里写多少数据。 写模式下，limit等于Buffer的capacity。

当切换Buffer到读模式时， limit表示你最多能读到多少数据。所以，当切换Buffer到读模式时，limit会被设置成写模式下的position值。换句话说，你能读到以前写入的全部数据（limit被设置成已写数据的数量，这个值在写模式下就是position）

Buffer的类型
Java NIO 有如下Buffer类型

ByteBuffer
MappedByteBuffer
CharBuffer
DoubleBuffer
FloatBuffer
IntBuffer
LongBuffer
ShortBuffer
这些Buffer类型表明了不一样的数据类型。换句话说，就是能够经过char，short，int，long，float 或 double类型来操做缓冲区中的字节。

MappedByteBuffer 有些特别，在涉及它的专门章节中再讲。

Buffer的分配
要想得到一个Buffer对象首先要进行分配。 每个Buffer类都有一个allocate方法。下面是一个分配48字节capacity的ByteBuffer的例子。
ByteBuffer buf = ByteBuffer.allocate(48);
 
这是分配一个可存储1024个字符的CharBuffer：
CharBuffer buf = CharBuffer.allocate(1024);
 
向Buffer中写数据
写数据到Buffer有两种方式：

从Channel写到Buffer。
经过Buffer的put()方法写到Buffer里。
从Channel写到Buffer的例子
int bytesRead = inChannel.read(buf); //read into buffer.
 
经过put方法写Buffer的例子：
buf.put(127);
 
put方法有不少版本，容许你以不一样的方式把数据写入到Buffer中。例如， 写到一个指定的位置，或者把一个字节数组写入到Buffer。 更多Buffer实现的细节参考JavaDoc。
flip()方法
flip方法将Buffer从写模式切换到读模式。调用flip()方法会将position设回0，并将limit设置成以前position的值。

换句话说，position如今用于标记读的位置，limit表示以前写进了多少个byte、char等 ——如今能读取多少个byte、char等。

从Buffer中读取数据
从Buffer中读取数据有两种方式：

从Buffer读取数据到Channel。
使用get()方法从Buffer中读取数据。
从Buffer读取数据到Channel的例子：
//read from buffer into channel.
int bytesWritten = inChannel.write(buf);
 
使用get()方法从Buffer中读取数据的例子
byte aByte = buf.get();
get方法有不少版本，容许你以不一样的方式从Buffer中读取数据。例如，从指定position读取，或者从Buffer中读取数据到字节数组。更多Buffer实现的细节参考JavaDoc。

rewind()方法
Buffer.rewind()将position设回0，因此你能够重读Buffer中的全部数据。limit保持不变，仍然表示能从Buffer中读取多少个元素（byte、char等）。

clear()与compact()方法
一旦读完Buffer中的数据，须要让Buffer准备好再次被写入。能够经过clear()或compact()方法来完成。

若是调用的是clear()方法，position将被设回0，limit被设置成capacity的值。换句话说，Buffer 被清空了。Buffer中的数据并未清除，只是这些标记告诉咱们能够从哪里开始往Buffer里写数据。

若是Buffer中有一些未读的数据，调用clear()方法，数据将“被遗忘”，意味着再也不有任何标记会告诉你哪些数据被读过，哪些尚未。

 

若是Buffer中仍有未读的数据，且后续还须要这些数据，可是此时想要先先写些数据，那么使用compact()方法。

compact()方法将全部未读的数据拷贝到Buffer起始处。而后将position设到最后一个未读元素正后面。limit属性依然像clear()方法同样，设置成capacity。如今Buffer准备好写数据了，可是不会覆盖未读的数据。

mark()与reset()方法
经过调用Buffer.mark()方法，能够标记Buffer中的一个特定position。以后能够经过调用Buffer.reset()方法恢复到这个position。例如：

buffer.mark();
 
//call buffer.get() a couple of times, e.g. during parsing.
 
buffer.reset();  //set position back to mark.
 
equals()与compareTo()方法
可使用equals()和compareTo()方法比较两个Buffer。

equals()

当知足下列条件时，表示两个Buffer相等：

有相同的类型（byte、char、int等）。
Buffer中剩余的byte、char等的个数相等。
Buffer中全部剩余的byte、char等都相同。
如你所见，equals只是比较Buffer的一部分，不是每个在它里面的元素都比较。实际上，它只比较Buffer中的position到limit之间的剩余元素。

compareTo()

compareTo()方法比较两个Buffer的剩余元素(byte、char等)， 若是知足下列条件，则认为一个Buffer“小于”另外一个Buffer：

第一个不相等的元素小于另外一个Buffer中对应的元素 。
全部元素都相等，但第一个Buffer比另外一个先耗尽(第一个Buffer的元素个数比另外一个少)。
 

scatter/gather
scatter/gather用于描述从Channel中读取或者写入到Channel的操做。

分散（scatter）读取Channel，是指在读操做时将读取的数据写入多个buffer中。所以，Channel将从Channel中读取的数据“分散（scatter）”到多个Buffer中。
汇集（gather）写入Channel，是指在写操做时将多个buffer的数据写入同一个Channel，所以，Channel 将多个Buffer中的数据“汇集（gather）”后发送到Channel。
适用场景：

scatter / gather常常用于须要将传输的数据分开处理的场合，例如传输一个由消息头和消息体组成的消息，你可能会将消息体和消息头分散到不一样的buffer中，这样你能够方便的处理消息头和消息体。
Scattering Reads
Scattering Reads是指数据从一个channel读取到多个buffer中。

Java NIO: Scattering Read

代码示例以下：

ByteBuffer header = ByteBuffer.allocate(128);
ByteBuffer body   = ByteBuffer.allocate(1024);
 
ByteBuffer[] bufferArray = { header, body };
 
channel.read(bufferArray);
 
注意buffer首先被插入到数组，而后再将数组做为channel.read() 的输入参数。read()方法按照buffer在数组中的顺序将从channel中读取的数据写入到buffer，当一个buffer被写满后，channel紧接着向另外一个buffer中写。
Scattering Reads在移动下一个buffer前，必须填满当前的buffer，这也意味着它不适用于动态消息(译者注：消息大小不固定)。换句话说，若是存在消息头和消息体，消息头必须完成填充（例如 128byte），Scattering Reads才能正常工做。

Gathering Writes
Gathering Writes是指数据从多个buffer写入到同一个channel。

Java NIO: Gathering Write

代码示例以下：

ByteBuffer header = ByteBuffer.allocate(128);
ByteBuffer body   = ByteBuffer.allocate(1024);
 
//write data into buffers
 
ByteBuffer[] bufferArray = { header, body };
 
channel.write(bufferArray);
 
buffers数组是write()方法的入参，write()方法会按照buffer在数组中的顺序，将数据写入到channel，注意只有 position和limit之间的数据才会被写入。所以，若是一个buffer的容量为128byte，可是仅仅包含58byte的数据，那么这 58byte的数据将被写入到channel中。所以与Scattering Reads相反，Gathering Writes能较好的处理动态消息。
 
Channel间的数据传输
在Java NIO中，若是两个通道中有一个是FileChannel，那你能够直接将数据从一个channel传输到另一个channel。

transferFrom()
FileChannel的transferFrom()方法能够将数据从源通道传输到FileChannel中（译者注：这个方法在JDK文档中的解释为将字节从给定的可读取字节通道传输到此通道的文件中）。下面是一个简单的例子：

RandomAccessFile fromFile = new RandomAccessFile("fromFile.txt","rw");
FileChannel      fromChannel = fromFile.getChannel();
 
RandomAccessFile toFile = new RandomAccessFile("toFile.txt","rw");
FileChannel      toChannel = toFile.getChannel();
 
long position = 0;
long count = fromChannel.size();
 
toChannel.transferFrom(position, count, fromChannel);
 
方法的输入参数position表示从position处开始向目标文件写入数据，count表示最多传输的字节数。若是源通道的剩余空间小于 count 个字节，则所传输的字节数要小于请求的字节数。

此外要注意，在SoketChannel的实现中，SocketChannel只会传输此刻准备好的数据（可能不足count字节）。所以，SocketChannel可能不会将请求的全部数据(count个字节)所有传输到FileChannel中。

transferTo()
transferTo()方法将数据从FileChannel传输到其余的channel中。下面是一个简单的例子：

RandomAccessFile fromFile = new RandomAccessFile("fromFile.txt","rw");
FileChannel      fromChannel = fromFile.getChannel();
 
RandomAccessFile toFile = new RandomAccessFile("toFile.txt","rw");
FileChannel      toChannel = toFile.getChannel();
 
long position = 0;
long count = fromChannel.size();
 
fromChannel.transferTo(position, count, toChannel);
 
是否是发现这个例子和前面那个例子特别类似？除了调用方法的FileChannel对象不同外，其余的都同样。
上面所说的关于SocketChannel的问题在transferTo()方法中一样存在。SocketChannel会一直传输数据直到目标buffer被填满。