java nio 系列教程 -凯发k8国际

（本部分，作者：jakob jenkov， 译者：airu，校对：丁一）
java nio 由以下几个核心部分组成：

• channels
• buffers
• selectors

虽然java nio 中除此之外还有很多类和组件，但在我看来，channel，buffer 和 selector 构成了核心的api。其它组件，如pipe和filelock，只不过是与三个核心组件共同使用的工具类。因此，在概述中我将集中在这三个组件上。其它组件会在单独的章节中讲到。

channel 和 buffer

基本上，所有的 io 在nio 中都从一个channel 开始。channel 有点象流。 数据可以从channel读到buffer中，也可以从buffer 写到channel中。这里有个图示：



channel和buffer有好几种类型。下面是java nio中的一些主要channel的实现：

• filechannel
• datagramchannel
• socketchannel
• serversocketchannel

正如你所看到的，这些通道涵盖了udp 和 tcp 网络io，以及文件io。

与这些类一起的有一些有趣的接口，但为简单起见，我尽量在概述中不提到它们。本教程其它章节与它们相关的地方我会进行解释。

以下是java nio里关键的buffer实现：

• bytebuffer
• charbuffer
• doublebuffer
• floatbuffer
• intbuffer
• longbuffer
• shortbuffer

这些buffer覆盖了你能通过io发送的基本数据类型：byte, short, int, long, float, double 和 char。

java nio 还有个 mappedyteuffer，用于表示内存映射文件， 我也不打算在概述中说明。

selector

selector允许单线程处理多个 channel。如果你的应用打开了多个连接（通道），但每个连接的流量都很低，使用selector就会很方便。例如，在一个聊天服务器中。

这是在一个单线程中使用一个selector处理3个channel的图示：



要使用selector，得向selector注册channel，然后调用它的select()方法。这个方法会一直阻塞到某个注册的通道有事件就绪。一旦这个方法返回，线程就可以处理这些事件，事件的例子有如新连接进来，数据接收等。

（本部分，作者：jakob jenkov，译者：郭蕾，校对：方腾飞）
当学习了java nio和io的api后，一个问题马上涌入脑海：



java nio和io的主要区别

下表总结了java nio和io之间的主要差别，我会更详细地描述表中每部分的差异。

io	nio
stream oriented	buffer oriented
blocking io	non blocking io
	selectors

面向流与面向缓冲

java nio和io之间第一个最大的区别是，io是面向流的，nio是面向缓冲区的。 java io面向流意味着每次从流中读一个或多个字节，直至读取所有字节，它们没有被缓存在任何地方。此外，它不能前后移动流中的数据。如果需要前后移动从流中读取的数据，需要先将它缓存到一个缓冲区。 java nio的缓冲导向方法略有不同。数据读取到一个它稍后处理的缓冲区，需要时可在缓冲区中前后移动。这就增加了处理过程中的灵活性。但是，还需要检查是否该缓冲区中包含所有您需要处理的数据。而且，需确保当更多的数据读入缓冲区时，不要覆盖缓冲区里尚未处理的数据。

阻塞与非阻塞io

java io的各种流是阻塞的。这意味着，当一个线程调用read() 或 write()时，该线程被阻塞，直到有一些数据被读取，或数据完全写入。该线程在此期间不能再干任何事情了。 java nio的非阻塞模式，使一个线程从某通道发送请求读取数据，但是它仅能得到目前可用的数据，如果目前没有数据可用时，就什么都不会获取。而不是保持线程阻塞，所以直至数据变的可以读取之前，该线程可以继续做其他的事情。 非阻塞写也是如此。一个线程请求写入一些数据到某通道，但不需要等待它完全写入，这个线程同时可以去做别的事情。 线程通常将非阻塞io的空闲时间用于在其它通道上执行io操作，所以一个单独的线程现在可以管理多个输入和输出通道（channel）。

选择器（selectors）

java nio的选择器允许一个单独的线程来监视多个输入通道，你可以注册多个通道使用一个选择器，然后使用一个单独的线程来“选择”通道：这些通道里已经有可以处理的输入，或者选择已准备写入的通道。这种选择机制，使得一个单独的线程很容易来管理多个通道。

nio和io如何影响应用程序的设计

无论您选择io或nio工具箱，可能会影响您应用程序设计的以下几个方面：

• 对nio或io类的api调用。
• 数据处理。
• 用来处理数据的线程数。

api调用

当然，使用nio的api调用时看起来与使用io时有所不同，但这并不意外，因为并不是仅从一个inputstream逐字节读取，而是数据必须先读入缓冲区再处理。

数据处理

使用纯粹的nio设计相较io设计，数据处理也受到影响。

在io设计中，我们从inputstream或 reader逐字节读取数据。假设你正在处理一基于行的文本数据流，例如：

name: anna
age: 25
email: anna@mailserver.com
phone: 1234567890

该文本行的流可以这样处理：

inputstream input = … ; // get the inputstream from the client socket
bufferedreader reader = new bufferedreader(new inputstreamreader(input));
string nameline   = reader.readline();
string ageline    = reader.readline();
string emailline  = reader.readline();
string phoneline  = reader.readline();

请注意处理状态由程序执行多久决定。换句话说，一旦reader.readline()方法返回，你就知道肯定文本行就已读完， readline()阻塞直到整行读完，这就是原因。你也知道此行包含名称；同样，第二个readline()调用返回的时候，你知道这行包含年龄等。 正如你可以看到，该处理程序仅在有新数据读入时运行，并知道每步的数据是什么。一旦正在运行的线程已处理过读入的某些数据，该线程不会再回退数据（大多如此）。下图也说明了这条原则：



而一个nio的实现会有所不同，下面是一个简单的例子：

bytebuffer buffer = bytebuffer.allocate(48);
int bytesread = inchannel.read(buffer);

注意第二行，从通道读取字节到bytebuffer。当这个方法调用返回时，你不知道你所需的所有数据是否在缓冲区内。你所知道的是，该缓冲区包含一些字节，这使得处理有点困难。
假设第一次 read(buffer)调用后，读入缓冲区的数据只有半行，例如，“name:an”，你能处理数据吗？显然不能，需要等待，直到整行数据读入缓存，在此之前，对数据的任何处理毫无意义。

所以，你怎么知道是否该缓冲区包含足够的数据可以处理呢？好了，你不知道。发现的方法只能查看缓冲区中的数据。其结果是，在你知道所有数据都在缓冲区里之前，你必须检查几次缓冲区的数据。这不仅效率低下，而且可以使程序设计方案杂乱不堪。例如：

bytebuffer buffer = bytebuffer.allocate(48);
int bytesread = inchannel.read(buffer);
while(! bufferfull(bytesread) ) {
bytesread = inchannel.read(buffer);
}

bufferfull()方法必须跟踪有多少数据读入缓冲区，并返回真或假，这取决于缓冲区是否已满。换句话说，如果缓冲区准备好被处理，那么表示缓冲区满了。

bufferfull()方法扫描缓冲区，但必须保持在bufferfull（）方法被调用之前状态相同。如果没有，下一个读入缓冲区的数据可能无法读到正确的位置。这是不可能的，但却是需要注意的又一问题。

如果缓冲区已满，它可以被处理。如果它不满，并且在你的实际案例中有意义，你或许能处理其中的部分数据。但是许多情况下并非如此。下图展示了“缓冲区数据循环就绪”：



总结

nio可让您只使用一个（或几个）单线程管理多个通道（网络连接或文件），但付出的代价是解析数据可能会比从一个阻塞流中读取数据更复杂。

如果需要管理同时打开的成千上万个连接，这些连接每次只是发送少量的数据，例如聊天服务器，实现nio的服务器可能是一个优势。同样，如果你需要维持许多打开的连接到其他计算机上，如p2p网络中，使用一个单独的线程来管理你所有出站连接，可能是一个优势。一个线程多个连接的设计方案如下图所示：



如果你有少量的连接使用非常高的带宽，一次发送大量的数据，也许典型的io服务器实现可能非常契合。下图说明了一个典型的io服务器设计：

（本部分，作者：jakob jenkov，译者：airu，校对：丁一）
java nio的通道类似流，但又有些不同：

• 既可以从通道中读取数据，又可以写数据到通道。但流的读写通常是单向的。
• 通道可以异步地读写。
• 通道中的数据总是要先读到一个buffer，或者总是要从一个buffer中写入。

正如上面所说，从通道读取数据到缓冲区，从缓冲区写入数据到通道。如下图所示：



channel的实现

这些是java nio中最重要的通道的实现：

• filechannel：从文件中读写数据。
• datagramchannel：能通过udp读写网络中的数据。
• socketchannel：能通过tcp读写网络中的数据。
• serversocketchannel：可以监听新进来的tcp连接，像web服务器那样。对每一个新进来的连接都会创建一个socketchannel。

基本的 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的更多细节。

（本部分，作者：jakob jenkov，译者：airu，校对：丁一）
java nio中的buffer用于和nio通道进行交互。如你所知，数据是从通道读入缓冲区，从缓冲区写入到通道中的。

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

buffer的基本用法

使用buffer读写数据一般遵循以下四个步骤：

• 写入数据到buffer
• 调用flip()方法
• 从buffer中读取数据
• 调用clear()方法或者compact()方法

当向buffer写入数据时，buffer会记录下写了多少数据。一旦要读取数据，需要通过flip()方法将buffer从写模式切换到读模式。在读模式下，可以读取之前写入到buffer的所有数据。

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

下面是一个使用buffer的例子：

randomaccessfile afile = new randomaccessfile("data/nio-data.txt", "rw");
filechannel inchannel = afile.getchannel();
//create buffer with capacity of 48 bytes
bytebuffer buf = bytebuffer.allocate(48);
int bytesread = inchannel.read(buf); //read into buffer.
while (bytesread != -1) {
  buf.flip();  //make buffer ready for read
  while(buf.hasremaining()){
      system.out.print((char) buf.get()); // read 1 byte at a time
  }
  buf.clear(); //make buffer ready for writing
  bytesread = inchannel.read(buf);
}
afile.close();

buffer的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中的剩余元素。

compareto()方法

compareto()方法比较两个buffer的剩余元素(byte、char等)， 如果满足下列条件，则认为一个buffer“小于”另一个buffer：

• 第一个不相等的元素小于另一个buffer中对应的元素。
• 所有元素都相等，但第一个buffer比另一个先耗尽(第一个buffer的元素个数比另一个少)。

（译注：剩余元素是从 position到limit之间的元素）

（本部分，作者：jakob jenkov   译者：郭蕾）

java nio开始支持scatter/gather，scatter/gather用于描述从channel（译者注：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中。如下图描述：



代码示例如下：

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。如下图描述：



代码示例如下：

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能较好的处理动态消息。

（本部分，作者：jakob jenkov，译者：郭蕾，校对：周泰）
在java nio中，如果两个通道中有一个是filechannel，那你可以直接将数据从一个channel（译者注：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被填满。

（本部分，作者：jakob jenkov，译者：浪迹v，校对：丁一）
selector（选择器）是java nio中能够检测一到多个nio通道，并能够知晓通道是否为诸如读写事件做好准备的组件。这样，一个单独的线程可以管理多个channel，从而管理多个网络连接。

(1)  为什么使用selector?

仅用单个线程来处理多个channels的好处是，只需要更少的线程来处理通道。事实上，可以只用一个线程处理所有的通道。对于操作系统来说，线程之间上下文切换的开销很大，而且每个线程都要占用系统的一些资源（如内存）。因此，使用的线程越少越好。

但是，需要记住，现代的操作系统和cpu在多任务方面表现的越来越好，所以多线程的开销随着时间的推移，变得越来越小了。实际上，如果一个cpu有多个内核，不使用多任务可能是在浪费cpu能力。不管怎么说，关于那种设计的讨论应该放在另一篇不同的文章中。在这里，只要知道使用selector能够处理多个通道就足够了。

下面是单线程使用一个selector处理3个channel的示例图：

(2)  selector的创建

通过调用selector.open()方法创建一个selector，如下：

selector selector = selector.open();

(3) 向selector注册通道

为了将channel和selector配合使用，必须将channel注册到selector上。通过selectablechannel.register()方法来实现，如下：

channel.configureblocking(false);
selectionkey key = channel.register(selector,
	selectionkey.op_read);

与selector一起使用时，channel必须处于非阻塞模式下。这意味着不能将filechannel与selector一起使用，因为filechannel不能切换到非阻塞模式。而套接字通道都可以。

注意register()方法的第二个参数。这是一个“interest集合”，意思是在通过selector监听channel时对什么事件感兴趣。可以监听四种不同类型的事件：

• connect
• accept
• read
• write

通道触发了一个事件意思是该事件已经就绪。所以，某个channel成功连接到另一个服务器称为“连接就绪”。一个server socket channel准备好接收新进入的连接称为“接收就绪”。一个有数据可读的通道可以说是“读就绪”。等待写数据的通道可以说是“写就绪”。

这四种事件用selectionkey的四个常量来表示：

• selectionkey.op_connect
• selectionkey.op_accept
• selectionkey.op_read
• selectionkey.op_write

如果你对不止一种事件感兴趣，那么可以用“位或”操作符将常量连接起来，如下：

int interestset = selectionkey.op_read | selectionkey.op_write;

在下面还会继续提到interest集合。

(4)  selectionkey

在上一小节中，当向selector注册channel时，register()方法会返回一个selectionkey对象。这个对象包含了一些你感兴趣的属性：

• interest集合
• ready集合
• channel
• selector
• 附加的对象（可选）

下面我会描述这些属性。

interest集合

就像向selector注册通道一节中所描述的，interest集合是你所选择的感兴趣的事件集合。可以通过selectionkey读写interest集合，像这样：

int interestset = selectionkey.interestops();
boolean isinterestedinaccept  = (interestset & selectionkey.op_accept) == selectionkey.op_accept；
boolean isinterestedinconnect = interestset & selectionkey.op_connect;
boolean isinterestedinread    = interestset & selectionkey.op_read;
boolean isinterestedinwrite   = interestset & selectionkey.op_write;

可以看到，用“位与”操作interest 集合和给定的selectionkey常量，可以确定某个确定的事件是否在interest 集合中。

ready集合

ready 集合是通道已经准备就绪的操作的集合。在一次选择(selection)之后，你会首先访问这个ready set。selection将在下一小节进行解释。可以这样访问ready集合：

int readyset = selectionkey.readyops();

可以用像检测interest集合那样的方法，来检测channel中什么事件或操作已经就绪。但是，也可以使用以下四个方法，它们都会返回一个布尔类型：

selectionkey.isacceptable();
selectionkey.isconnectable();
selectionkey.isreadable();
selectionkey.iswritable();

channel selector

从selectionkey访问channel和selector很简单。如下：

channel  channel  = selectionkey.channel();
selector selector = selectionkey.selector();

附加的对象

可以将一个对象或者更多信息附着到selectionkey上，这样就能方便的识别某个给定的通道。例如，可以附加 与通道一起使用的buffer，或是包含聚集数据的某个对象。使用方法如下：

selectionkey.attach(theobject);
object attachedobj = selectionkey.attachment();

还可以在用register()方法向selector注册channel的时候附加对象。如：

selectionkey key = channel.register(selector, selectionkey.op_read, theobject);

(5)  通过selector选择通道

一旦向selector注册了一或多个通道，就可以调用几个重载的select()方法。这些方法返回你所感兴趣的事件（如连接、接受、读或写）已经准备就绪的那些通道。换句话说，如果你对“读就绪”的通道感兴趣，select()方法会返回读事件已经就绪的那些通道。

下面是select()方法：

• int select()
• int select(long timeout)
• int selectnow()

select()阻塞到至少有一个通道在你注册的事件上就绪了。

select(long timeout)和select()一样，除了最长会阻塞timeout毫秒(参数)。

selectnow()不会阻塞，不管什么通道就绪都立刻返回（译者注：此方法执行非阻塞的选择操作。如果自从前一次选择操作后，没有通道变成可选择的，则此方法直接返回零。）。

select()方法返回的int值表示有多少通道已经就绪。亦即，自上次调用select()方法后有多少通道变成就绪状态。如果调用select()方法，因为有一个通道变成就绪状态，返回了1，若再次调用select()方法，如果另一个通道就绪了，它会再次返回1。如果对第一个就绪的channel没有做任何操作，现在就有两个就绪的通道，但在每次select()方法调用之间，只有一个通道就绪了。

selectedkeys()

一旦调用了select()方法，并且返回值表明有一个或更多个通道就绪了，然后可以通过调用selector的selectedkeys()方法，访问“已选择键集（selected key set）”中的就绪通道。如下所示：

set selectedkeys = selector.selectedkeys();

当像selector注册channel时，channel.register()方法会返回一个selectionkey 对象。这个对象代表了注册到该selector的通道。可以通过selectionkey的selectedkeyset()方法访问这些对象。

可以遍历这个已选择的键集合来访问就绪的通道。如下：

set selectedkeys = selector.selectedkeys();
iterator keyiterator = selectedkeys.iterator();
while(keyiterator.hasnext()) {
    selectionkey key = keyiterator.next();
    if(key.isacceptable()) {
        // a connection was accepted by a serversocketchannel.
    } else if (key.isconnectable()) {
        // a connection was established with a remote server.
    } else if (key.isreadable()) {
        // a channel is ready for reading
    } else if (key.iswritable()) {
        // a channel is ready for writing
    }
    keyiterator.();
}

这个循环遍历已选择键集中的每个键，并检测各个键所对应的通道的就绪事件。

注意每次迭代末尾的keyiterator.remove()调用。selector不会自己从已选择键集中移除selectionkey实例。必须在处理完通道时自己移除。下次该通道变成就绪时，selector会再次将其放入已选择键集中。

selectionkey.channel()方法返回的通道需要转型成你要处理的类型，如serversocketchannel或socketchannel等。

(6)  wakeup()

某个线程调用select()方法后阻塞了，即使没有通道已经就绪，也有办法让其从select()方法返回。只要让其它线程在第一个线程调用select()方法的那个对象上调用selector.wakeup()方法即可。阻塞在select()方法上的线程会立马返回。

如果有其它线程调用了wakeup()方法，但当前没有线程阻塞在select()方法上，下个调用select()方法的线程会立即“醒来（wake up）”。

(7)  close()

用完selector后调用其close()方法会关闭该selector，且使注册到该selector上的所有selectionkey实例无效。通道本身并不会关闭。

(8)  完整的示例

这里有一个完整的示例，打开一个selector，注册一个通道注册到这个selector上(通道的初始化过程略去),然后持续监控这个selector的四种事件（接受，连接，读，写）是否就绪。

selector selector = selector.open();
channel.configureblocking(false);
selectionkey key = channel.register(selector, selectionkey.op_read);
while(true) {
  int readychannels = selector.select();
  if(readychannels == 0) continue;
  set selectedkeys = selector.selectedkeys();
  iterator keyiterator = selectedkeys.iterator();
  while(keyiterator.hasnext()) {
    selectionkey key = keyiterator.next();
    if(key.isacceptable()) {
        // a connection was accepted by a serversocketchannel.
    } else if (key.isconnectable()) {
        // a connection was established with a remote server.
    } else if (key.isreadable()) {
        // a channel is ready for reading
    } else if (key.iswritable()) {
        // a channel is ready for writing
    }
    keyiterator.();
  }
}

（本部分，作者：jakob jenkov，译者：周泰，校对：丁一）
java nio中的filechannel是一个连接到文件的通道。可以通过文件通道读写文件。

filechannel无法设置为非阻塞模式，它总是运行在阻塞模式下。

打开filechannel

在使用filechannel之前，必须先打开它。但是，我们无法直接打开一个filechannel，需要通过使用一个inputstream、outputstream或randomaccessfile来获取一个filechannel实例。下面是通过randomaccessfile打开filechannel的示例：

randomaccessfile afile = new randomaccessfile("data/nio-data.txt", "rw");
filechannel inchannel = afile.getchannel();

从filechannel读取数据

调用多个read()方法之一从filechannel中读取数据。如：

bytebuffer buf = bytebuffer.allocate(48);
int bytesread = inchannel.read(buf);

首先，分配一个buffer。从filechannel中读取的数据将被读到buffer中。

然后，调用filechannel.read()方法。该方法将数据从filechannel读取到buffer中。read()方法返回的int值表示了有多少字节被读到了buffer中。如果返回-1，表示到了文件末尾。

向filechannel写数据

使用filechannel.write()方法向filechannel写数据，该方法的参数是一个buffer。如：

string newdata = "new string to write to file..."   system.currenttimemillis();
bytebuffer buf = bytebuffer.allocate(48);
buf.clear();
buf.put(newdata.getbytes());
buf.flip();
while(buf.hasremaining()) {
	channel.write(buf);
}

注意filechannel.write()是在while循环中调用的。因为无法保证write()方法一次能向filechannel写入多少字节，因此需要重复调用write()方法，直到buffer中已经没有尚未写入通道的字节。

关闭filechannel

用完filechannel后必须将其关闭。如：

channel.close();

filechannel的position方法

有时可能需要在filechannel的某个特定位置进行数据的读/写操作。可以通过调用position()方法获取filechannel的当前位置。

也可以通过调用position(long pos)方法设置filechannel的当前位置。

这里有两个例子：

long pos = channel.position();
channel.position(pos  123);

如果将位置设置在文件结束符之后，然后试图从文件通道中读取数据，读方法将返回-1 —— 文件结束标志。

如果将位置设置在文件结束符之后，然后向通道中写数据，文件将撑大到当前位置并写入数据。这可能导致“文件空洞”，磁盘上物理文件中写入的数据间有空隙。

filechannel的size方法

filechannel实例的size()方法将返回该实例所关联文件的大小。如：

long filesize = channel.size();

filechannel的truncate方法

可以使用filechannel.truncate()方法截取一个文件。截取文件时，文件将中指定长度后面的部分将被删除。如：

channel.truncate(1024);

这个例子截取文件的前1024个字节。

filechannel的force方法

filechannel.force()方法将通道里尚未写入磁盘的数据强制写到磁盘上。出于性能方面的考虑，操作系统会将数据缓存在内存中，所以无法保证写入到filechannel里的数据一定会即时写到磁盘上。要保证这一点，需要调用force()方法。

force()方法有一个boolean类型的参数，指明是否同时将文件元数据（权限信息等）写到磁盘上。

下面的例子同时将文件数据和元数据强制写到磁盘上：

channel.force(true);

（本部分，作者：jakob jenkov，译者：郑玉婷，校对：丁一）
java nio中的socketchannel是一个连接到tcp网络套接字的通道。可以通过以下2种方式创建socketchannel：

• 打开一个socketchannel并连接到互联网上的某台服务器。
• 一个新连接到达serversocketchannel时，会创建一个socketchannel。

打开 socketchannel

下面是socketchannel的打开方式：

socketchannel socketchannel = socketchannel.open();
socketchannel.connect(new inetsocketaddress("http://jenkov.com", 80));

关闭 socketchannel

当用完socketchannel之后调用socketchannel.close()关闭socketchannel：

socketchannel.close();

从 socketchannel 读取数据

要从socketchannel中读取数据，调用一个read()的方法之一。以下是例子：

bytebuffer buf = bytebuffer.allocate(48);
int bytesread = socketchannel.read(buf);

首先，分配一个buffer。从socketchannel读取到的数据将会放到这个buffer中。

然后，调用socketchannel.read()。该方法将数据从socketchannel 读到buffer中。read()方法返回的int值表示读了多少字节进buffer里。如果返回的是-1，表示已经读到了流的末尾（连接关闭了）。

写入 socketchannel

写数据到socketchannel用的是socketchannel.write()方法，该方法以一个buffer作为参数。示例如下：

string newdata = "new string to write to file..."   system.currenttimemillis();
bytebuffer buf = bytebuffer.allocate(48);
buf.clear();
buf.put(newdata.getbytes());
buf.flip();
while(buf.hasremaining()) {
    channel.write(buf);
}

注意socketchannel.write()方法的调用是在一个while循环中的。write()方法无法保证能写多少字节到socketchannel。所以，我们重复调用write()直到buffer没有要写的字节为止。

非阻塞模式

可以设置 socketchannel 为非阻塞模式（non-blocking mode）.设置之后，就可以在异步模式下调用connect(), read() 和write()了。

connect()

如果socketchannel在非阻塞模式下，此时调用connect()，该方法可能在连接建立之前就返回了。为了确定连接是否建立，可以调用finishconnect()的方法。像这样：

socketchannel.configureblocking(false);
socketchannel.connect(new inetsocketaddress("http://jenkov.com", 80));
while(! socketchannel.finishconnect() ){
    //wait, or do something else...
}

write()

非阻塞模式下，write()方法在尚未写出任何内容时可能就返回了。所以需要在循环中调用write()。前面已经有例子了，这里就不赘述了。

read()

非阻塞模式下,read()方法在尚未读取到任何数据时可能就返回了。所以需要关注它的int返回值，它会告诉你读取了多少字节。

非阻塞模式与选择器

非阻塞模式与选择器搭配会工作的更好，通过将一或多个socketchannel注册到selector，可以询问选择器哪个通道已经准备好了读取，写入等。selector与socketchannel的搭配使用会在后面详讲。

（本部分，作者：jakob jenkov，译者：郑玉婷，校对：丁一）
java nio中的 serversocketchannel 是一个可以监听新进来的tcp连接的通道，就像标准io中的serversocket一样。serversocketchannel类在 java.nio.channels包中。

这里有个例子：

serversocketchannel serversocketchannel = serversocketchannel.open();
serversocketchannel.socket().bind(new inetsocketaddress(9999));
while(true){
    socketchannel socketchannel =
            serversocketchannel.accept();
    //do something with socketchannel...
}

打开 serversocketchannel

通过调用 serversocketchannel.open() 方法来打开serversocketchannel.如：

serversocketchannel serversocketchannel = serversocketchannel.open();

关闭 serversocketchannel

通过调用serversocketchannel.close() 方法来关闭serversocketchannel. 如：

serversocketchannel.close();

监听新进来的连接

通过 serversocketchannel.accept() 方法监听新进来的连接。当 accept()方法返回的时候，它返回一个包含新进来的连接的 socketchannel。因此，accept()方法会一直阻塞到有新连接到达。

通常不会仅仅只监听一个连接，在while循环中调用 accept()方法. 如下面的例子：

while(true){
    socketchannel socketchannel =
            serversocketchannel.accept();
    //do something with socketchannel...
}

当然，也可以在while循环中使用除了true以外的其它退出准则。

非阻塞模式

serversocketchannel可以设置成非阻塞模式。在非阻塞模式下，accept() 方法会立刻返回，如果还没有新进来的连接，返回的将是null。 因此，需要检查返回的socketchannel是否是null。如：

serversocketchannel serversocketchannel = serversocketchannel.open();
serversocketchannel.socket().bind(new inetsocketaddress(9999));
serversocketchannel.configureblocking(false);
while(true){
    socketchannel socketchannel =
            serversocketchannel.accept();
    if(socketchannel != null){
        //do something with socketchannel...
    }
}

（本部分，作者：jakob jenkov，译者：郑玉婷，校对：丁一）
java nio中的datagramchannel是一个能收发udp包的通道。因为udp是无连接的网络协议，所以不能像其它通道那样读取和写入。它发送和接收的是数据包。

打开 datagramchannel

下面是 datagramchannel 的打开方式：

datagramchannel channel = datagramchannel.open();
channel.socket().bind(new inetsocketaddress(9999));

这个例子打开的 datagramchannel可以在udp端口9999上接收数据包。

接收数据

通过receive()方法从datagramchannel接收数据，如：

bytebuffer buf = bytebuffer.allocate(48);
buf.clear();
channel.receive(buf);

receive()方法会将接收到的数据包内容复制到指定的buffer. 如果buffer容不下收到的数据，多出的数据将被丢弃。

发送数据

通过send()方法从datagramchannel发送数据，如:

string newdata = "new string to write to file..."   system.currenttimemillis();
bytebuffer buf = bytebuffer.allocate(48);
buf.clear();
buf.put(newdata.getbytes());
buf.flip();
int bytessent = channel.send(buf, new inetsocketaddress("jenkov.com", 80));

这个例子发送一串字符到”jenkov.com”服务器的udp端口80。 因为服务端并没有监控这个端口，所以什么也不会发生。也不会通知你发出的数据包是否已收到，因为udp在数据传送方面没有任何保证。

连接到特定的地址

可以将datagramchannel“连接”到网络中的特定地址的。由于udp是无连接的，连接到特定地址并不会像tcp通道那样创建一个真正的连接。而是锁住datagramchannel ，让其只能从特定地址收发数据。

这里有个例子:

channel.connect(new inetsocketaddress("jenkov.com", 80));

当连接后，也可以使用read()和write()方法，就像在用传统的通道一样。只是在数据传送方面没有任何保证。这里有几个例子：

int bytesread = channel.read(buf);
int byteswritten = channel.write(but);

（本部分，作者：jakob jenkov，译者：黄忠，校对：丁一）
java nio 管道是2个线程之间的单向数据连接。pipe有一个source通道和一个sink通道。数据会被写到sink通道，从source通道读取。

这里是pipe原理的图示：



创建管道

通过pipe.open()方法打开管道。例如：

pipe pipe = pipe.open();

向管道写数据

要向管道写数据，需要访问sink通道。像这样：

pipe.sinkchannel sinkchannel = pipe.sink();

通过调用sinkchannel的write()方法，将数据写入sinkchannel,像这样：

string newdata = "new string to write to file..."   system.currenttimemillis();
bytebuffer buf = bytebuffer.allocate(48);
buf.clear();
buf.put(newdata.getbytes());
buf.flip();
while(buf.hasremaining()) {
    sinkchannel.write(buf);
}

从管道读取数据

从读取管道的数据，需要访问source通道，像这样：

pipe.sourcechannel sourcechannel = pipe.source();

调用source通道的read()方法来读取数据，像这样：

bytebuffer buf = bytebuffer.allocate(48);
int bytesread = inchannel.read(buf);

read()方法返回的int值会告诉我们多少字节被读进了缓冲区。

 channel.configureblocking(false);
 set selectedkeys = selector.selectedkeys();
 iterator keyiterator = selectedkeys.iterator();
 selectionkey key = keyiterator.next();