From 1c136891ec2442817d77ba059918615e16ed5583 Mon Sep 17 00:00:00 2001 From: CyC2018 <1029579233@qq.com> Date: Sat, 19 May 2018 16:14:02 +0800 Subject: [PATCH] auto commit --- notes/Java IO.md | 280 +++++++++++------- pics/4d930e22-f493-49ae-8dff-ea21cd6895dc.png | Bin 0 -> 29696 bytes pics/80804f52-8815-4096-b506-48eef3eed5c6.png | Bin 0 -> 6144 bytes 3 files changed, 172 insertions(+), 108 deletions(-) create mode 100644 pics/4d930e22-f493-49ae-8dff-ea21cd6895dc.png create mode 100644 pics/80804f52-8815-4096-b506-48eef3eed5c6.png diff --git a/notes/Java IO.md b/notes/Java IO.md index b48c90c3..885ecbe1 100644 --- a/notes/Java IO.md +++ b/notes/Java IO.md @@ -14,6 +14,7 @@ * [通道与缓冲区](#通道与缓冲区) * [缓冲区状态变量](#缓冲区状态变量) * [文件 NIO 实例](#文件-nio-实例) + * [选择器](#选择器) * [套接字 NIO 实例](#套接字-nio-实例) * [内存映射文件](#内存映射文件) * [对比](#对比) @@ -74,10 +75,16 @@ byte[] bytes = str.getBytes(encoding); // 编码 String str = new String(bytes, encoding); // 解码 ``` -GBK 编码中,中文占 2 个字节,英文占 1 个字节;UTF-8 编码中,中文占 3 个字节,英文占 1 个字节;Java 使用双字节编码 UTF-16be,中文和英文都占 2 个字节。 - 如果编码和解码过程使用不同的编码方式那么就出现了乱码。 +- GBK 编码中,中文占 2 个字节,英文占 1 个字节; +- UTF-8 编码中,中文占 3 个字节,英文占 1 个字节; +- UTF-16be 编码中,中文和英文都占 2 个字节。 + +UTF-16be 中的 be 指的是 Big Endian,也就是大端。相应地也有 UTF-16le,le 指的是 Little Endian,也就是小端。 + +Java 使用双字节编码 UTF-16be,这不是指 Java 只支持这一种编码方式,而是说 char 这种类型使用 UTF-16be 进行编码。char 类型占 16 位,也就是两个字节,Java 使用这种双字节编码正是为了让一个中文或者一个英文都能使用一个 char 来存储。 + # 五、对象操作 序列化就是将一个对象转换成字节序列,方便存储和传输。 @@ -148,15 +155,19 @@ is.close(); # 七、NIO -新的输入/输出 (NIO) 库是在 JDK 1.4 中引入的。NIO 弥补了原来的 I/O 的不足,它在标准 Java 代码中提供了高速的、面向块的 I/O。 +- [Java NIO Tutorial](http://tutorials.jenkov.com/java-nio/index.html) +- [Java NIO 浅析](https://tech.meituan.com/nio.html) +- [IBM: NIO 入门](https://www.ibm.com/developerworks/cn/education/java/j-nio/j-nio.html) + +新的输入/输出 (NIO) 库是在 JDK 1.4 中引入的。NIO 弥补了原来的 I/O 的不足,提供了高速的、面向块的 I/O。 ## 流与块 I/O 与 NIO 最重要的区别是数据打包和传输的方式,I/O 以流的方式处理数据,而 NIO 以块的方式处理数据。 -面向流的 I/O 一次处理一个字节数据,一个输入流产生一个字节数据,一个输出流消费一个字节数据。为流式数据创建过滤器非常容易,链接几个过滤器,以便每个过滤器只负责单个复杂处理机制的一部分,这样也是相对简单的。不利的一面是,面向流的 I/O 通常相当慢。 +面向流的 I/O 一次处理一个字节数据,一个输入流产生一个字节数据,一个输出流消费一个字节数据。为流式数据创建过滤器非常容易,链接几个过滤器,以便每个过滤器只负责复杂处理机制的一部分。不利的一面是,面向流的 I/O 通常相当慢。 -一个面向块的 I/O 系统以块的形式处理数据,一次处理一个数据块。按块处理数据比按流处理数据要快得多。但是面向块的 I/O 缺少一些面向流的 I/O 所具有的优雅性和简单性。 +面向块的 I/O 一次处理一个数据块,按块处理数据比按流处理数据要快得多。但是面向块的 I/O 缺少一些面向流的 I/O 所具有的优雅性和简单性。 I/O 包和 NIO 已经很好地集成了,java.io.\* 已经以 NIO 为基础重新实现了,所以现在它可以利用 NIO 的一些特性。例如,java.io.\* 包中的一些类包含以块的形式读写数据的方法,这使得即使在面向流的系统中,处理速度也会更快。 @@ -177,7 +188,7 @@ I/O 包和 NIO 已经很好地集成了,java.io.\* 已经以 NIO 为基础重 ### 2. 缓冲区 -发送给一个通道的所有数据都必须首先放到缓冲区中,同样地,从通道中读取的任何数据都要读到缓冲区中。也就是说,不会直接对通道进行读写数据,而是要先经过缓冲区。 +发送给一个通道的所有数据都必须首先放到缓冲区中,同样地,从通道中读取的任何数据都要先读到缓冲区中。也就是说,不会直接对通道进行读写数据,而是要先经过缓冲区。 缓冲区实质上是一个数组,但它不仅仅是一个数组。缓冲区提供了对数据的结构化访问,而且还可以跟踪系统的读/写进程。 @@ -203,11 +214,11 @@ I/O 包和 NIO 已经很好地集成了,java.io.\* 已经以 NIO 为基础重

-② 从输入通道中读取 3 个字节数据写入缓冲区中,此时 position 移动设为 3,limit 保持不变。 +② 从输入通道中读取 5 个字节数据写入缓冲区中,此时 position 移动设置为 5,limit 保持不变。 -

+

-③ 以下图例为已经从输入通道读取了 5 个字节数据写入缓冲区中。在将缓冲区的数据写到输出通道之前,需要先调用 flip() 方法,这个方法将 limit 设置为当前 position,并将 position 设置为 0。 +③ 在将缓冲区的数据写到输出通道之前,需要先调用 flip() 方法,这个方法将 limit 设置为当前 position,并将 position 设置为 0。

@@ -221,153 +232,206 @@ I/O 包和 NIO 已经很好地集成了,java.io.\* 已经以 NIO 为基础重 ## 文件 NIO 实例 -① 为要读取的文件创建 FileInputStream,之后通过 FileInputStream 获取输入 FileChannel; +以下展示了使用 NIO 快速复制文件的实例: ```java -FileInputStream fin = new FileInputStream("readandshow.txt"); -FileChannel fic = fin.getChannel(); -``` - -② 创建一个容量为 1024 的 Buffer; - -```java -ByteBuffer buffer = ByteBuffer.allocate(1024); -``` - -③ 将数据从输入 FileChannel 写入到 Buffer 中,如果没有数据的话,read() 方法会返回 -1; - -```java -int r = fcin.read(buffer); -if (r == -1) { - break; +public class FastCopyFile { + public static void main(String args[]) throws Exception { + + String inFile = "data/abc.txt"; + String outFile = "data/abc-copy.txt"; + + // 获得源文件的输入字节流 + FileInputStream fin = new FileInputStream(inFile); + // 获取输入字节流的文件通道 + FileChannel fcin = fin.getChannel(); + + // 获取目标文件的输出字节流 + FileOutputStream fout = new FileOutputStream(outFile); + // 获取输出字节流的通道 + FileChannel fcout = fout.getChannel(); + + // 为缓冲区分配 1024 个字节 + ByteBuffer buffer = ByteBuffer.allocateDirect(1024); + + while (true) { + // 从输入通道中读取数据到缓冲区中 + int r = fcin.read(buffer); + // read() 返回 -1 表示 EOF + if (r == -1) + break; + // 切换读写 + buffer.flip(); + // 把缓冲区的内容写入输出文件中 + fcout.write(buffer); + // 清空缓冲区 + buffer.clear(); + } + } } ``` -④ 为要写入的文件创建 FileOutputStream,之后通过 FileOutputStream 获取输出 FileChannel +## 选择器 -```java -FileOutputStream fout = new FileOutputStream("writesomebytes.txt"); -FileChannel foc = fout.getChannel(); -``` +一个线程 Thread 使用一个选择器 Selector 通过轮询的方式去检查多个通道 Channel 上的事件,从而让一个线程就可以处理多个事件。 -⑤ 调用 flip() 切换读写 +因为创建和切换线程的开销很大,因此使用一个线程来处理多个事件而不是一个线程处理一个事件具有更好的性能。 -```java -buffer.flip(); -``` +

-⑥ 把 Buffer 中的数据读取到输出 FileChannel 中 +### 1. 创建选择器 ```java -foc.write(buffer); +Selector selector = Selector.open(); ``` -⑦ 最后调用 clear() 重置缓冲区 +### 2. 将通道注册到选择器上 ```java -buffer.clear(); +ServerSocketChannel ssChannel = ServerSocketChannel.open(); +ssChannel.configureBlocking(false); +ssChannel.register(selector, SelectionKey.OP_ACCEPT); ``` -## 套接字 NIO 实例 +通道必须配置为非阻塞模式,否则使用选择器就没有任何意义了,因为如果通道在某个事件上被阻塞,那么服务器就不能响应其它时间,必须等待这个事件处理完毕才能去处理其它事件,显然这和选择器的作用背道而驰。 -### 1. ServerSocketChannel +在将通道注册到选择器上时,还需要指定要注册的具体事件,主要有以下几类: -每一个监听端口都需要有一个 ServerSocketChannel 用来监听连接。 +- SelectionKey.OP_CONNECT +- SelectionKey.OP_ACCEPT +- SelectionKey.OP_READ +- SelectionKey.OP_WRITE -```java -ServerSocketChannel ssc = ServerSocketChannel.open(); -ssc.configureBlocking(false); // 设置为非阻塞 +它们在 SelectionKey 的定义如下: -ServerSocket ss = ssc.socket(); -InetSocketAddress address = new InetSocketAddress(ports[i]); -ss.bind(address); // 绑定端口号 +```java +public static final int OP_READ = 1 << 0; +public static final int OP_WRITE = 1 << 2; +public static final int OP_CONNECT = 1 << 3; +public static final int OP_ACCEPT = 1 << 4; ``` -### 2. Selectors - -异步 I/O 通过 Selector 注册对特定 I/O 事件的兴趣 ― 可读的数据的到达、新的套接字连接等等,在发生这样的事件时,系统将会发送通知。 - -创建 Selectors 之后,就可以对不同的通道对象调用 register() 方法。register() 的第一个参数总是这个 Selector。第二个参数是 OP_ACCEPT,这里它指定我们想要监听 ACCEPT 事件,也就是在新的连接建立时所发生的事件。 - -SelectionKey 代表这个通道在此 Selector 上的这个注册。当某个 Selector 通知您某个传入事件时,它是通过提供对应于该事件的 SelectionKey 来进行的。SelectionKey 还可以用于取消通道的注册。 +可以看出每个事件可以被当成一个位域,从而组成事件集整数。例如: ```java -Selector selector = Selector.open(); -SelectionKey key = ssc.register(selector, SelectionKey.OP_ACCEPT); +int interestSet = SelectionKey.OP_READ | SelectionKey.OP_WRITE; ``` -### 3. 主循环 - -首先,我们调用 Selector 的 select() 方法。这个方法会阻塞,直到至少有一个已注册的事件发生。当一个或者更多的事件发生时,select() 方法将返回所发生的事件的数量。 - -接下来,我们调用 Selector 的 selectedKeys() 方法,它返回发生了事件的 SelectionKey 对象的一个集合。 - -我们通过迭代 SelectionKeys 并依次处理每个 SelectionKey 来处理事件。对于每一个 SelectionKey,您必须确定发生的是什么 I/O 事件,以及这个事件影响哪些 I/O 对象。 +### 3. 监听事件 ```java int num = selector.select(); - -Set selectedKeys = selector.selectedKeys(); -Iterator it = selectedKeys.iterator(); - -while (it.hasNext()) { - SelectionKey key = (SelectionKey)it.next(); - // ... deal with I/O event ... -} ``` -### 4. 监听新连接 +使用 select() 来监听事件到达,它会一直阻塞直到有至少一个事件到达。 -程序执行到这里,我们仅注册了 ServerSocketChannel,并且仅注册它们“接收”事件。为确认这一点,我们对 SelectionKey 调用 readyOps() 方法,并检查发生了什么类型的事件: +### 4. 获取到达的事件 ```java -if ((key.readyOps() & SelectionKey.OP_ACCEPT) - == SelectionKey.OP_ACCEPT) { - // Accept the new connection - // ... +Set keys = selector.selectedKeys(); +Iterator keyIterator = keys.iterator(); +while (keyIterator.hasNext()) { + SelectionKey key = keyIterator.next(); + if (key.isAcceptable()) { + // ... + } else if (key.isReadable()) { + // ... + } + keyIterator.remove(); } ``` -可以肯定地说,readOps() 方法告诉我们该事件是新的连接。 - -### 5. 接受新的连接 - -因为我们知道这个服务器套接字上有一个传入连接在等待,所以可以安全地接受它;也就是说,不用担心 accept() 操作会阻塞: +### 5. 事件循环 -```java -ServerSocketChannel ssc = (ServerSocketChannel)key.channel(); -SocketChannel sc = ssc.accept(); -``` - -下一步是将新连接的 SocketChannel 配置为非阻塞的。而且由于接受这个连接的目的是为了读取来自套接字的数据,所以我们还必须将 SocketChannel 注册到 Selector 上,如下所示: +因为一次 select() 调用不能处理完所有的事件,并且服务器端有可能需要一直监听事件,因此服务器端处理事件的代码一般会放在一个死循环内。 ```java -sc.configureBlocking(false); -SelectionKey newKey = sc.register(selector, SelectionKey.OP_READ); +while (true) { + int num = selector.select(); + Set keys = selector.selectedKeys(); + Iterator keyIterator = keys.iterator(); + while (keyIterator.hasNext()) { + SelectionKey key = keyIterator.next(); + if (key.isAcceptable()) { + // ... + } else if (key.isReadable()) { + // ... + } + keyIterator.remove(); + } +} ``` -注意我们使用 register() 的 OP_READ 参数,将 SocketChannel 注册用于读取而不是接受新连接。 - -### 6. 删除处理过的 SelectionKey - -在处理 SelectionKey 之后,我们几乎可以返回主循环了。但是我们必须首先将处理过的 SelectionKey 从选定的键集合中删除。如果我们没有删除处理过的键,那么它仍然会在主集合中以一个激活的键出现,这会导致我们尝试再次处理它。我们调用迭代器的 remove() 方法来删除处理过的 SelectionKey: +## 套接字 NIO 实例 ```java -it.remove(); +public class NIOServer { + + public static void main(String[] args) throws IOException { + Selector selector = Selector.open(); + + ServerSocketChannel ssChannel = ServerSocketChannel.open(); + ssChannel.configureBlocking(false); + ssChannel.register(selector, SelectionKey.OP_ACCEPT); + + ServerSocket serverSocket = ssChannel.socket(); + InetSocketAddress address = new InetSocketAddress("127.0.0.1", 8888); + serverSocket.bind(address); + + while (true) { + selector.select(); + Set keys = selector.selectedKeys(); + Iterator keyIterator = keys.iterator(); + while (keyIterator.hasNext()) { + SelectionKey key = keyIterator.next(); + if (key.isAcceptable()) { + ServerSocketChannel ssChannel1 = (ServerSocketChannel) key.channel(); + // 服务器会为每个新连接创建一个 SocketChannel + SocketChannel sChannel = ssChannel1.accept(); + sChannel.configureBlocking(false); + // 这个新连接主要用于从客户端读取数据 + sChannel.register(selector, SelectionKey.OP_READ); + } else if (key.isReadable()) { + SocketChannel sChannel = (SocketChannel) key.channel(); + System.out.println(readDataFromSocketChannel(sChannel)); + sChannel.close(); + } + keyIterator.remove(); + } + } + } + + private static String readDataFromSocketChannel(SocketChannel sChannel) throws IOException { + ByteBuffer buffer = ByteBuffer.allocate(1024); + StringBuffer data = new StringBuffer(); + while (true) { + buffer.clear(); + int n = sChannel.read(buffer); + if (n == -1) + break; + buffer.flip(); + int limit = buffer.limit(); + char[] dst = new char[limit]; + for (int i = 0; i < limit; i++) + dst[i] = (char) buffer.get(i); + data.append(dst); + buffer.clear(); + } + return data.toString(); + } +} ``` -现在我们可以返回主循环并接受从一个套接字中传入的数据 (或者一个传入的 I/O 事件) 了。 - -### 7. 传入的 I/O - -当来自一个套接字的数据到达时,它会触发一个 I/O 事件。这会导致在主循环中调用 Selector.select(),并返回一个或者多个 I/O 事件。这一次, SelectionKey 将被标记为 OP_READ 事件,如下所示: - ```java -} else if ((key.readyOps() & SelectionKey.OP_READ) - == SelectionKey.OP_READ) { - // Read the data - SocketChannel sc = (SocketChannel)key.channel(); - // ... +public class NIOClient { + + public static void main(String[] args) throws IOException { + Socket socket = new Socket("127.0.0.1", 8888); + OutputStream out = socket.getOutputStream(); + String s = "hello world"; + out.write(s.getBytes()); + out.close(); + } } ``` diff --git a/pics/4d930e22-f493-49ae-8dff-ea21cd6895dc.png b/pics/4d930e22-f493-49ae-8dff-ea21cd6895dc.png new file mode 100644 index 0000000000000000000000000000000000000000..7ee2ffb4d2c9623943c4d9ef8811d7518cdeb0af GIT binary patch literal 29696 zcmeEubzGF+^Dl~&$^z1{bg1MC(jncTgmf+fO0FzjB3-+HiXf$=N`r(nEU+Nb-6^ni zcid zx$%w=9~g;w^mzdIb;C_ZSq`VDhXDh8xMe4+DT{+sioA1Sg$H~la#b;M!@&Weus=7@ zE?;eMa9}*D3bJ}$=9_5*h7?8(4W7p{*IP5So`cg~b{nHX%~Fd`?)LHlhI-Q>Pe!4b2gmR zS^+B&ZnvknNA7KmD4*7=m`*!Y;CWK09ELfY&VJf_-1Y7X!VGwWN>`i^@(`f+T{a$m zLamNg%*78Gkd1(Sfs^VG3*|u1!?Hwu4{qw>mWie^v2(O00cP?IzinXtel}DpCoA{A z58nqr7K{cs(@+8yGyFtX{Lv`5Et!ovi7qbG>RXZmhPl=L@5_n<^IX|%&}p(%=?gZ1 zuz({jCvheqH_uIq2ZVwA6$VQmJMn)5(*W8paq716gY6LH;N)+bXc~HoB`^inpCc(5-tLO$|j2il|nU~ zBqs|?_g~mWdjICiILIo;g5tRF*Rz@Y@iHmPyJY33btV)ucjM{1) zPu9M}d3H+CaU_#X!VBD?FKA`LNBQ3Bil`fc2wN`PEx0TD4Ho3FWV;{ zM)`}@U2>y1_Ju%2_u~=7a^h;~v#~idMJ@B%PlWx5)k� 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