Showing preview only (549K chars total). Download the full file or copy to clipboard to get everything.
Repository: dongzl/netty-handbook
Branch: master
Commit: 7acc5537816f
Files: 154
Total size: 431.1 KB
Directory structure:
gitextract_i3jsrwsv/
├── .gitignore
├── .travis.yml
├── LICENSE
├── README.md
├── docs/
│ ├── .nojekyll
│ ├── README.md
│ ├── _content/
│ │ ├── chapter01.md
│ │ ├── chapter02.md
│ │ ├── chapter03.md
│ │ ├── chapter04.md
│ │ ├── chapter05.md
│ │ ├── chapter06.md
│ │ ├── chapter07.md
│ │ ├── chapter08.md
│ │ ├── chapter09.md
│ │ ├── chapter10.md
│ │ ├── chapter11.md
│ │ └── chapter_blank.md
│ ├── _coverpage.md
│ ├── _navbar.md
│ ├── _sidebar.md
│ ├── guide.md
│ └── index.html
├── netty-code-atguigu/
│ ├── pom.xml
│ └── src/
│ └── main/
│ └── java/
│ ├── atguigu/
│ │ └── netty/
│ │ └── example/
│ │ └── echo2/
│ │ ├── EchoServer.java
│ │ └── EchoServerHandler.java
│ └── com/
│ └── atguigu/
│ ├── bio/
│ │ └── BIOServer.java
│ ├── netty/
│ │ ├── buf/
│ │ │ ├── NettyByteBuf01.java
│ │ │ └── NettyByteBuf02.java
│ │ ├── dubborpc/
│ │ │ ├── customer/
│ │ │ │ └── ClientBootstrap.java
│ │ │ ├── netty/
│ │ │ │ ├── NettyClient.java
│ │ │ │ ├── NettyClientHandler.java
│ │ │ │ ├── NettyServer.java
│ │ │ │ └── NettyServerHandler.java
│ │ │ ├── provider/
│ │ │ │ ├── HelloServiceImpl.java
│ │ │ │ └── ServerBootstrap.java
│ │ │ └── publicinterface/
│ │ │ └── HelloService.java
│ │ ├── groupchat/
│ │ │ ├── GroupChatClient.java
│ │ │ ├── GroupChatClientHandler.java
│ │ │ ├── GroupChatServer.java
│ │ │ ├── GroupChatServerHandler.java
│ │ │ └── User.java
│ │ ├── heartbeat/
│ │ │ ├── MyServer.java
│ │ │ ├── MyServerHandler.java
│ │ │ └── Test.java
│ │ ├── http/
│ │ │ ├── TestHttpServerHandler.java
│ │ │ ├── TestServer.java
│ │ │ └── TestServerInitializer.java
│ │ ├── inboundhandlerandoutboundhandler/
│ │ │ └── MyByteToLongDecoder2.java
│ │ ├── protocoltcp/
│ │ │ ├── MessageProtocol.java
│ │ │ ├── MyClient.java
│ │ │ ├── MyClientHandler.java
│ │ │ ├── MyClientInitializer.java
│ │ │ ├── MyMessageDecoder.java
│ │ │ ├── MyMessageEncoder.java
│ │ │ ├── MyServer.java
│ │ │ ├── MyServerHandler.java
│ │ │ └── MyServerInitializer.java
│ │ ├── simple/
│ │ │ ├── NettyClient.java
│ │ │ ├── NettyClientHandler.java
│ │ │ ├── NettyServer.java
│ │ │ ├── NettyServerHandler.java
│ │ │ └── Test.java
│ │ ├── tcp/
│ │ │ ├── MyClient.java
│ │ │ ├── MyClientHandler.java
│ │ │ ├── MyClientInitializer.java
│ │ │ ├── MyServer.java
│ │ │ ├── MyServerHandler.java
│ │ │ └── MyServerInitializer.java
│ │ └── websocket/
│ │ ├── MyServer.java
│ │ ├── MyTextWebSocketFrameHandler.java
│ │ └── hello.html
│ └── nio/
│ ├── BasicBuffer.java
│ ├── MappedByteBufferTest.java
│ ├── NIOByteBufferPutGet.java
│ ├── NIOFileChannel01.java
│ ├── NIOFileChannel02.java
│ ├── NIOFileChannel03.java
│ ├── NIOFileChannel04.java
│ ├── ReadOnlyBuffer.java
│ ├── ScatteringAndGatheringTest.java
│ ├── groupchat/
│ │ ├── GroupChatClient.java
│ │ └── GroupChatServer.java
│ └── zerocopy/
│ ├── NewIOClient.java
│ └── NewIOServer.java
├── netty-code-self/
│ ├── pom.xml
│ └── src/
│ └── main/
│ └── java/
│ └── com/
│ └── netty/
│ └── code/
│ └── self/
│ └── resp/
│ ├── EchoCommand.java
│ ├── PingCommand.java
│ ├── RespClientTest.java
│ └── RespServerTest.java
├── netty-definitive-guide/
│ ├── pom.xml
│ └── src/
│ └── main/
│ └── java/
│ └── com/
│ └── netty/
│ └── definitive/
│ └── guide/
│ ├── chapter2/
│ │ ├── section1/
│ │ │ ├── TimeClient.java
│ │ │ ├── TimeServer.java
│ │ │ └── TimeServerHandler.java
│ │ ├── section2/
│ │ │ ├── TimeClient.java
│ │ │ ├── TimeServer.java
│ │ │ ├── TimeServerHandler.java
│ │ │ └── TimeServerHandlerExecutePool.java
│ │ ├── section3/
│ │ │ ├── MultiplexerTimeServer.java
│ │ │ ├── TimeClient.java
│ │ │ ├── TimeClientHandle.java
│ │ │ └── TimeServer.java
│ │ └── section4/
│ │ ├── AcceptCompletionHandler.java
│ │ ├── AsyncTimeClientHandler.java
│ │ ├── AsyncTimeServerHandler.java
│ │ ├── ReadCompletionHandler.java
│ │ ├── TimeClient.java
│ │ └── TimeServer.java
│ ├── chapter3/
│ │ ├── TimeClient.java
│ │ ├── TimeClientHandler.java
│ │ ├── TimeServer.java
│ │ ├── TimeServerHandler.java
│ │ └── timer/
│ │ ├── TimeServerHandler.java
│ │ ├── TimerClient.java
│ │ ├── TimerClientHandler.java
│ │ └── TimerServer.java
│ ├── chapter4/
│ │ ├── section2/
│ │ │ ├── TimeClient.java
│ │ │ ├── TimeClientHandler.java
│ │ │ ├── TimeServer.java
│ │ │ └── TimeServerHandler.java
│ │ └── section3/
│ │ ├── TimeClient.java
│ │ ├── TimeClientHandler.java
│ │ ├── TimeServer.java
│ │ └── TimeServerHandler.java
│ ├── chapter5/
│ │ ├── section1/
│ │ │ ├── EchoClient.java
│ │ │ ├── EchoClientHandler.java
│ │ │ ├── EchoServer.java
│ │ │ └── EchoServerHandler.java
│ │ └── section2/
│ │ ├── EchoClient.java
│ │ ├── EchoClientHandler.java
│ │ ├── EchoServer.java
│ │ └── EchoServerHandler.java
│ ├── chapter6/
│ │ ├── PerformTestUserInfo.java
│ │ ├── TestUserInfo.java
│ │ └── UserInfo.java
│ ├── chapter7/
│ │ ├── EchoClient.java
│ │ ├── EchoClientHandler.java
│ │ ├── EchoServer.java
│ │ ├── EchoServerHandler.java
│ │ ├── MsgpackDecoder.java
│ │ └── MsgpackEncoder.java
│ ├── chapter8/
│ │ ├── SubReqClient.java
│ │ ├── SubReqClientHandler.java
│ │ ├── SubReqServer.java
│ │ ├── SubReqServerHandler.java
│ │ ├── SubscribeReqProto.java
│ │ ├── SubscribeRespProto.java
│ │ └── TestSubscribeReqProto.java
│ └── chapter9/
│ ├── MarshallingCodeCFactory.java
│ ├── SubReqClient.java
│ ├── SubReqClientHandler.java
│ ├── SubReqServer.java
│ └── SubReqServerHandler.java
└── pom.xml
================================================
FILE CONTENTS
================================================
================================================
FILE: .gitignore
================================================
# Compiled class file
*.class
# Log file
*.log
# BlueJ files
*.ctxt
# Mobile Tools for Java (J2ME)
.mtj.tmp/
# Package Files #
*.jar
*.war
*.nar
*.ear
*.zip
*.tar.gz
*.rar
# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
hs_err_pid*
*.iml
.idea
target/
================================================
FILE: .travis.yml
================================================
language: java
jdk:
- oraclejdk8
================================================
FILE: LICENSE
================================================
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
================================================
FILE: README.md
================================================
[](https://github.com/dongzl/netty-handbook)
[](https://github.com/dongzl/netty-handbook)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
# 《尚硅谷 Netty 核心技术及源码剖析》课程学习手册
- 本课程不适合零基础的学员，需要掌握常用的设计模式和数据结构
- 掌握 Java 的面向对象编程、多线程编程、IO 编程、网络编程等知识
- 《Netty 核心源码剖析章节》内容学习最好有项目开发和阅读源码的经历
# 内容介绍
本网站内容是根据韩顺平老师在尚硅谷开设的 Netty 学习课程《尚硅谷 Netty 视频教程》整理而来，所有内容、图片版权归尚硅谷和韩顺平老师所有，本人只是对其中部分文本、代码进行格式美化工作，对于其中部分图片内容，依照原始图片使用 processon 工具进行重新制作，版权所有，请勿用于商业目的。
文档地址：https://github.com/dongzl/netty-handbook/tree/master/docs
由于个人时间有限，整理比较仓促，难免有遗漏和错误内容，欢迎大家留言提出问题，也欢迎大家在 Github 上直接修改文档，并 PR 到项目，我们一同维护文档内容，向韩顺平老师致敬。
# 课程地址
bilibili：[尚硅谷Netty视频教程（2019发布）](https://www.bilibili.com/video/av76227904/)
YouTube：[【韩顺平】尚硅谷Netty视频教程](https://www.youtube.com/playlist?list=PLmOn9nNkQxJH02M10mFnBW0yPRnLmRSMo)
================================================
FILE: docs/.nojekyll
================================================
================================================
FILE: docs/README.md
================================================
# 内容介绍
本网站内容是根据**韩顺平**老师在尚硅谷开设的 `Netty` 学习课程《尚硅谷 Netty 视频教程》整理而来，所有内容、图片版权归尚硅谷和韩顺平老师所有，本人只是对其中部分文本、代码进行格式美化工作，对于其中部分图片内容，依照原始图片使用 [processon](https://www.processon.com/) 工具进行重新制作，版权所有，请勿用于商业目的。
文档地址：https://github.com/dongzl/netty-handbook/tree/master/docs
由于个人时间有限，整理比较仓促，难免有遗漏和错误内容，欢迎大家留言提出问题，也欢迎大家在 `Github` 上直接修改文档，并 `PR` 到项目，我们一同维护文档内容，向韩顺平老师致敬。
# 课程地址
- 腾讯课堂：[尚硅谷Netty视频教程](https://ke.qq.com/course/463900)
- bilibili：[尚硅谷Netty视频教程（2019发布）](https://www.bilibili.com/video/av76227904/)
- YouTube：[【韩顺平】尚硅谷Netty视频教程](https://www.youtube.com/playlist?list=PLmOn9nNkQxJH02M10mFnBW0yPRnLmRSMo)
================================================
FILE: docs/_content/chapter01.md
================================================
## 1.1 本课程学习要求
1. 本课程不适用于 `0` 基础的学员。
2. 要求已经掌握了 `Java` 编程，主要技术构成：`Java OOP` 编程、`Java` 多线程编程、`Java IO` 编程、`Java` 网络编程、常用的 `Java` 设计模式（比如观察者模式，命令模式，职责链模式）、常用的数据结构（比如链表）。
3. 本课程的《`Netty` 核心源码剖析章节》要求学员最好有项目开发和阅读源码的经历。
## 1.2 Netty 的介绍
1. `Netty` 是由 `JBOSS` 提供的一个 `Java` 开源框架，现为 `Github` 上的独立项目。
2. `Netty` 是一个异步的、基于事件驱动的网络应用框架，用以快速开发高性能、高可靠性的网络 `IO` 程序。
3. `Netty` 主要针对在 `TCP` 协议下，面向 `Client` 端的高并发应用，或者 `Peer-to-Peer` 场景下的大量数据持续传输的应用。
4. `Netty` 本质是一个 `NIO` 框架，适用于服务器通讯相关的多种应用场景。
5. 要透彻理解 `Netty`，需要先学习 `NIO`，这样我们才能阅读 `Netty` 的源码。
## 1.3 Netty 的应用场景
### 1.3.1 互联网行业
1. 互联网行业：在分布式系统中，各个节点之间需要远程服务调用，高性能的 `RPC` 框架必不可少，`Netty` 作为异步高性能的通信框架，往往作为基础通信组件被这些 `RPC` 框架使用。
2. 典型的应用有：阿里分布式服务框架 `Dubbo` 的 `RPC` 框 架使用 `Dubbo` 协议进行节点间通信，`Dubbo` 协议默认使用 `Netty` 作为基础通信组件，用于实现各进程节点之间的内部通信。
### 1.3.2 游戏行业
1. 无论是手游服务端还是大型的网络游戏，`Java` 语言得到了越来越广泛的应用。
2. `Netty` 作为高性能的基础通信组件，提供了 `TCP/UDP` 和 `HTTP` 协议栈，方便定制和开发私有协议栈，账号登录服务器。
3. 地图服务器之间可以方便的通过 `Netty` 进行高性能的通信。
 
### 1.3.3 大数据领域
1. 经典的 `Hadoop` 的高性能通信和序列化组件 `Avro` 的 `RPC` 框架，默认采用 `Netty` 进行跨界点通信。
2. 它的 `NettyService` 基于 `Netty` 框架二次封装实现。
### 1.3.4 其它开源项目使用到 Netty
网址：https://netty.io/wiki/related-projects.html
## 1.4 Netty 的学习资料参考
[](https://item.jd.com/12070975.html) [](https://item.jd.com/11681556.html)
================================================
FILE: docs/_content/chapter02.md
================================================
## 2.1 I/O 模型
### 2.1.1 模型基本说明
1. `I/O` 模型简单的理解：就是用什么样的通道进行数据的发送和接收，很大程度上决定了程序通信的性能。
2. `Java` 共支持 `3` 种网络编程模型 `I/O` 模式：`BIO`、`NIO`、`AIO`。
3. `Java BIO`：同步并阻塞（传统阻塞型），服务器实现模式为一个连接一个线程，即客户端有连接请求时服务器端就需要启动一个线程进行处理，如果这个连接不做任何事情会造成不必要的线程开销。【简单示意图】
4. `Java NIO`：同步非阻塞，服务器实现模式为一个线程处理多个请求（连接），即客户端发送的连接请求都会注册到多路复用器上，多路复用器轮询到连接有 `I/O` 请求就进行处理。【简单示意图】
5. `Java AIO(NIO.2)`：异步非阻塞，`AIO` 引入异步通道的概念，采用了 `Proactor` 模式，简化了程序编写，有效的请求才启动线程，它的特点是先由操作系统完成后才通知服务端程序启动线程去处理，一般适用于连接数较多且连接时间较长的应用。
6. 我们依次展开讲解。
## 2.2 BIO、NIO、AIO 使用场景分析
1. `BIO` 方式适用于连接数目比较小且固定的架构，这种方式对服务器资源要求比较高，并发局限于应用中，`JDK1.4` 以前的唯一选择，但程序简单易理解。
2. `NIO` 方式适用于连接数目多且连接比较短（轻操作）的架构，比如聊天服务器，弹幕系统，服务器间通讯等。编程比较复杂，`JDK1.4` 开始支持。
3. `AIO` 方式使用于连接数目多且连接比较长（重操作）的架构，比如相册服务器，充分调用 `OS` 参与并发操作，编程比较复杂，`JDK7` 开始支持。
## 2.3 Java BIO 基本介绍
1. `Java BIO` 就是传统的 `Java I/O` 编程，其相关的类和接口在 `java.io`。
2. `BIO(BlockingI/O)`：同步阻塞，服务器实现模式为一个连接一个线程，即客户端有连接请求时服务器端就需要启动一个线程进行处理，如果这个连接不做任何事情会造成不必要的线程开销，可以通过线程池机制改善（实现多个客户连接服务器）。【后有应用实例】
3. `BIO` 方式适用于连接数目比较小且固定的架构，这种方式对服务器资源要求比较高，并发局限于应用中，`JDK1.4` 以前的唯一选择，程序简单易理解。
## 2.4 Java BIO 工作机制
对 `BIO` 编程流程的梳理
1. 服务器端启动一个 `ServerSocket`。
2. 客户端启动 `Socket` 对服务器进行通信，默认情况下服务器端需要对每个客户建立一个线程与之通讯。
3. 客户端发出请求后，先咨询服务器是否有线程响应，如果没有则会等待，或者被拒绝。
4. 如果有响应，客户端线程会等待请求结束后，在继续执行。
## 2.5 Java BIO 应用实例
实例说明：
1. 使用 `BIO` 模型编写一个服务器端，监听 `6666` 端口，当有客户端连接时，就启动一个线程与之通讯。
2. 要求使用线程池机制改善，可以连接多个客户端。
3. 服务器端可以接收客户端发送的数据（`telnet` 方式即可）。
4. 代码演示：
```java
package com.atguigu.bio;
import java.io.InputStream;
import java.net.ServerSocket;
import java.net.Socket;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
public class BIOServer {
public static void main(String[] args) throws Exception {
//线程池机制
//思路
//1. 创建一个线程池
//2. 如果有客户端连接，就创建一个线程，与之通讯(单独写一个方法)
ExecutorService newCachedThreadPool = Executors.newCachedThreadPool();
//创建ServerSocket
ServerSocket serverSocket = new ServerSocket(6666);
System.out.println("服务器启动了");
while (true) {
System.out.println("线程信息id = " + Thread.currentThread().getId() + "名字 = " + Thread.currentThread().getName());
//监听，等待客户端连接
System.out.println("等待连接....");
final Socket socket = serverSocket.accept();
System.out.println("连接到一个客户端");
//就创建一个线程，与之通讯(单独写一个方法)
newCachedThreadPool.execute(new Runnable() {
public void run() {//我们重写
//可以和客户端通讯
handler(socket);
}
});
}
}
//编写一个handler方法，和客户端通讯
public static void handler(Socket socket) {
try {
System.out.println("线程信息id = " + Thread.currentThread().getId() + "名字 = " + Thread.currentThread().getName());
byte[] bytes = new byte[1024];
//通过socket获取输入流
InputStream inputStream = socket.getInputStream();
//循环的读取客户端发送的数据
while (true) {
System.out.println("线程信息id = " + Thread.currentThread().getId() + "名字 = " + Thread.currentThread().getName());
System.out.println("read....");
int read = inputStream.read(bytes);
if (read != -1) {
System.out.println(new String(bytes, 0, read));//输出客户端发送的数据
} else {
break;
}
}
} catch (Exception e) {
e.printStackTrace();
} finally {
System.out.println("关闭和client的连接");
try {
socket.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
}
```
## 2.6 Java BIO 问题分析
1. 每个请求都需要创建独立的线程，与对应的客户端进行数据 `Read`，业务处理，数据 `Write`。
2. 当并发数较大时，需要创建大量线程来处理连接，系统资源占用较大。
3. 连接建立后，如果当前线程暂时没有数据可读，则线程就阻塞在 `Read` 操作上，造成线程资源浪费。
================================================
FILE: docs/_content/chapter03.md
================================================
## 3.1 Java NIO 基本介绍
1. `Java NIO` 全称 **`Java non-blocking IO`** ，是指 `JDK` 提供的新 `API`。从 `JDK1.4` 开始，`Java` 提供了一系列改进的输入/输出的新特性，被统称为 `NIO`（即 `NewIO`），是同步非阻塞的。
2. `NIO` 相关类都被放在 **`java.nio`** 包及子包下，并且对原 `java.io` 包中的很多类进行改写。【基本案例】
3. `NIO` 有三大核心部分: **`Channel`（通道）、`Buffer`（缓冲区）、`Selector`（选择器）** 。
4. `NIO` 是**面向缓冲区，或者面向块编程**的。数据读取到一个它稍后处理的缓冲区，需要时可在缓冲区中前后移动，这就增加了处理过程中的灵活性，使用它可以提供非阻塞式的高伸缩性网络。
5. `Java NIO` 的非阻塞模式，使一个线程从某通道发送请求或者读取数据，但是它仅能得到目前可用的数据，如果目前没有数据可用时，就什么都不会获取，而不是保持线程阻塞，所以直至数据变的可以读取之前，该线程可以继续做其他的事情。非阻塞写也是如此，一个线程请求写入一些数据到某通道，但不需要等待它完全写入，这个线程同时可以去做别的事情。【后面有案例说明】
6. 通俗理解：`NIO` 是可以做到用一个线程来处理多个操作的。假设有 `10000` 个请求过来,根据实际情况，可以分配 `50` 或者 `100` 个线程来处理。不像之前的阻塞 `IO` 那样，非得分配 `10000` 个。
7. `HTTP 2.0` 使用了多路复用的技术，做到同一个连接并发处理多个请求，而且并发请求的数量比 `HTTP 1.1` 大了好几个数量级。
8. 案例说明 `NIO` 的 `Buffer`
```java
package com.atguigu.nio;
import java.nio.IntBuffer;
public class BasicBuffer {
public static void main(String[] args) {
//举例说明 Buffer 的使用(简单说明)
//创建一个 Buffer，大小为 5，即可以存放 5 个 int
IntBuffer intBuffer = IntBuffer.allocate(5);
//向buffer存放数据
//intBuffer.put(10);
//intBuffer.put(11);
//intBuffer.put(12);
//intBuffer.put(13);
//intBuffer.put(14);
for (int i = 0; i < intBuffer.capacity(); i++) {
intBuffer.put(i * 2);
}
//如何从 buffer 读取数据
//将 buffer 转换，读写切换(!!!)
intBuffer.flip();
while (intBuffer.hasRemaining()) {
System.out.println(intBuffer.get());
}
}
}
```
## 3.2 NIO 和 BIO 的比较
1. `BIO` 以流的方式处理数据，而 `NIO` 以块的方式处理数据，块 `I/O` 的效率比流 `I/O` 高很多。
2. `BIO` 是阻塞的，`NIO` 则是非阻塞的。
3. `BIO` 基于字节流和字符流进行操作，而 `NIO` 基于 `Channel`（通道）和 `Buffer`（缓冲区）进行操作，数据总是从通道读取到缓冲区中，或者从缓冲区写入到通道中。`Selector`（选择器）用于监听多个通道的事件（比如：连接请求，数据到达等），因此使用单个线程就可以监听多个客户端通道。
## 3.3 NIO 三大核心原理示意图
一张图描述 `NIO` 的 `Selector`、`Channel` 和 `Buffer` 的关系。
### 3.3.1 Selector、Channel 和 Buffer 关系图（简单版）
关系图的说明:
<!-- ) -->
<img style="height:600px" src="_media/chapter03/chapter03_01.png" />
1. 每个 `Channel` 都会对应一个 `Buffer`。
2. `Selector` 对应一个线程，一个线程对应多个 `Channel`（连接）。
3. 该图反应了有三个 `Channel` 注册到该 `Selector` //程序
4. 程序切换到哪个 `Channel` 是由事件决定的，`Event` 就是一个重要的概念。
5. `Selector` 会根据不同的事件，在各个通道上切换。
6. `Buffer` 就是一个内存块，底层是有一个数组。
7. 数据的读取写入是通过 `Buffer`，这个和 `BIO`，`BIO` 中要么是输入流，或者是输出流，不能双向，但是 `NIO` 的 `Buffer` 是可以读也可以写，需要 `flip` 方法切换 `Channel` 是双向的，可以返回底层操作系统的情况，比如 `Linux`，底层的操作系统通道就是双向的。
## 3.4 缓冲区（Buffer）
### 3.4.1 基本介绍
缓冲区（`Buffer`）：缓冲区本质上是一个**可以读写数据的内存块**，可以理解成是一个**容器对象（含数组）**，该对象提供了一组方法，可以更轻松地使用内存块，，缓冲区对象内置了一些机制，能够跟踪和记录缓冲区的状态变化情况。`Channel` 提供从文件、网络读取数据的渠道，但是读取或写入的数据都必须经由 `Buffer`，如图:【后面举例说明】
### 3.4.2 Buffer 类及其子类
1. 在 `NIO` 中，`Buffer` 是一个顶层父类，它是一个抽象类，类的层级关系图：
2. `Buffer` 类定义了所有的缓冲区都具有的四个属性来提供关于其所包含的数据元素的信息：
3. `Buffer` 类相关方法一览
### 3.4.3 ByteBuffer
从前面可以看出对于 `Java` 中的基本数据类型（`boolean` 除外），都有一个 `Buffer` 类型与之相对应，最常用的自然是 `ByteBuffer` 类（二进制数据），该类的主要方法如下：
## 3.5 通道（Channel）
## 3.6 基本介绍
1. `NIO` 的通道类似于流，但有些区别如下：
- 通道可以同时进行读写，而流只能读或者只能写
- 通道可以实现异步读写数据
- 通道可以从缓冲读数据，也可以写数据到缓冲:
2. `BIO` 中的 `Stream` 是单向的，例如 `FileInputStream` 对象只能进行读取数据的操作，而 `NIO` 中的通道（`Channel`）是双向的，可以读操作，也可以写操作。
3. `Channel` 在 `NIO` 中是一个接口 `public interface Channel extends Closeable{}`
4. 常用的 `Channel` 类有: **`FileChannel`、`DatagramChannel`、`ServerSocketChannel` 和 `SocketChannel`** 。【`ServerSocketChanne` 类似 `ServerSocket`、`SocketChannel` 类似 `Socket`】
5. `FileChannel` 用于文件的数据读写，`DatagramChannel` 用于 `UDP` 的数据读写，`ServerSocketChannel` 和 `SocketChannel` 用于 `TCP` 的数据读写。
6. 图示
### 3.6.1 FileChannel 类
`FileChannel` 主要用来对本地文件进行 `IO` 操作，常见的方法有
- `public int read(ByteBuffer dst)`，从通道读取数据并放到缓冲区中
- `public int write(ByteBuffer src)`，把缓冲区的数据写到通道中
- `public long transferFrom(ReadableByteChannel src, long position, long count)`，从目标通道中复制数据到当前通道
- `public long transferTo(long position, long count, WritableByteChannel target)`，把数据从当前通道复制给目标通道
### 3.6.2 应用实例1 - 本地文件写数据
实例要求：
1. 使用前面学习后的 `ByteBuffer`（缓冲）和 `FileChannel`（通道），将 "hello,尚硅谷" 写入到 `file01.txt` 中
2. 文件不存在就创建
3. 代码演示
```java
package com.atguigu.nio;
import java.io.FileOutputStream;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
public class NIOFileChannel01 {
public static void main(String[] args) throws Exception {
String str = "hello,尚硅谷";
//创建一个输出流 -> channel
FileOutputStream fileOutputStream = new FileOutputStream("d:\\file01.txt");
//通过 fileOutputStream 获取对应的 FileChannel
//这个 fileChannel 真实类型是 FileChannelImpl
FileChannel fileChannel = fileOutputStream.getChannel();
//创建一个缓冲区 ByteBuffer
ByteBuffer byteBuffer = ByteBuffer.allocate(1024);
//将 str 放入 byteBuffer
byteBuffer.put(str.getBytes());
//对 byteBuffer 进行 flip
byteBuffer.flip();
//将 byteBuffer 数据写入到 fileChannel
fileChannel.write(byteBuffer);
fileOutputStream.close();
}
}
```
### 3.6.3 应用实例2 - 本地文件读数据
实例要求：
1. 使用前面学习后的 `ByteBuffer`（缓冲）和 `FileChannel`（通道），将 `file01.txt` 中的数据读入到程序，并显示在控制台屏幕
2. 假定文件已经存在
3. 代码演示
```java
package com.atguigu.nio;
import java.io.File;
import java.io.FileInputStream;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
public class NIOFileChannel02 {
public static void main(String[] args) throws Exception {
//创建文件的输入流
File file = new File("d:\\file01.txt");
FileInputStream fileInputStream = new FileInputStream(file);
//通过 fileInputStream 获取对应的 FileChannel -> 实际类型 FileChannelImpl
FileChannel fileChannel = fileInputStream.getChannel();
//创建缓冲区
ByteBuffer byteBuffer = ByteBuffer.allocate((int)file.length());
//将通道的数据读入到 Buffer
fileChannel.read(byteBuffer);
//将 byteBuffer 的字节数据转成 String
System.out.println(new String(byteBuffer.array()));
fileInputStream.close();
}
}
```
### 3.6.4 应用实例3 - 使用一个 Buffer 完成文件读取、写入
实例要求：
1. 使用 `FileChannel`（通道）和方法 `read、write`，完成文件的拷贝
2. 拷贝一个文本文件 `1.txt`，放在项目下即可
3. 代码演示
```java
package com.atguigu.nio;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.nio.ByteBuffer;
import java.nio.channels.FileChannel;
public class NIOFileChannel03 {
public static void main(String[] args) throws Exception {
FileInputStream fileInputStream = new FileInputStream("1.txt");
FileChannel fileChannel01 = fileInputStream.getChannel();
FileOutputStream fileOutputStream = new FileOutputStream("2.txt");
FileChannel fileChannel02 = fileOutputStream.getChannel();
ByteBuffer byteBuffer = ByteBuffer.allocate(512);
while (true) { //循环读取
//这里有一个重要的操作，一定不要忘了
/*
public final Buffer clear() {
position = 0;
limit = capacity;
mark = -1;
return this;
}
*/
byteBuffer.clear(); //清空 buffer
int read = fileChannel01.read(byteBuffer);
System.out.println("read = " + read);
if (read == -1) { //表示读完
break;
}
//将 buffer 中的数据写入到 fileChannel02--2.txt
byteBuffer.flip();
fileChannel02.write(byteBuffer);
}
//关闭相关的流
fileInputStream.close();
fileOutputStream.close();
}
}
```
### 3.6.5 应用实例4 - 拷贝文件 transferFrom 方法
1. 实例要求：
2. 使用 `FileChannel`（通道）和方法 `transferFrom`，完成文件的拷贝
3. 拷贝一张图片
4. 代码演示
```java
package com.atguigu.nio;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.nio.channels.FileChannel;
public class NIOFileChannel04 {
public static void main(String[] args) throws Exception {
//创建相关流
FileInputStream fileInputStream = new FileInputStream("d:\\a.jpg");
FileOutputStream fileOutputStream = new FileOutputStream("d:\\a2.jpg");
//获取各个流对应的 FileChannel
FileChannel sourceCh = fileInputStream.getChannel();
FileChannel destCh = fileOutputStream.getChannel();
//使用 transferForm 完成拷贝
destCh.transferFrom(sourceCh, 0, sourceCh.size());
//关闭相关通道和流
sourceCh.close();
destCh.close();
fileInputStream.close();
fileOutputStream.close();
}
}
```
### 3.6.6 关于 Buffer 和 Channel 的注意事项和细节
1. `ByteBuffer` 支持类型化的 `put` 和 `get`，`put` 放入的是什么数据类型，`get` 就应该使用相应的数据类型来取出，否则可能有 `BufferUnderflowException` 异常。【举例说明】
```java
package com.atguigu.nio;
import java.nio.ByteBuffer;
public class NIOByteBufferPutGet {
public static void main(String[] args) {
//创建一个 Buffer
ByteBuffer buffer = ByteBuffer.allocate(64);
//类型化方式放入数据
buffer.putInt(100);
buffer.putLong(9);
buffer.putChar('尚');
buffer.putShort((short) 4);
//取出
buffer.flip();
System.out.println();
System.out.println(buffer.getInt());
System.out.println(buffer.getLong());
System.out.println(buffer.getChar());
System.out.println(buffer.getShort());
}
}
```
2. 可以将一个普通 `Buffer` 转成只读 `Buffer`【举例说明】
```java
package com.atguigu.nio;
import java.nio.ByteBuffer;
public class ReadOnlyBuffer {
public static void main(String[] args) {
//创建一个 buffer
ByteBuffer buffer = ByteBuffer.allocate(64);
for (int i = 0; i < 64; i++) {
buffer.put((byte) i);
}
//读取
buffer.flip();
//得到一个只读的 Buffer
ByteBuffer readOnlyBuffer = buffer.asReadOnlyBuffer();
System.out.println(readOnlyBuffer.getClass());
//读取
while (readOnlyBuffer.hasRemaining()) {
System.out.println(readOnlyBuffer.get());
}
readOnlyBuffer.put((byte) 100); //ReadOnlyBufferException
}
}
```
3. `NIO` 还提供了 `MappedByteBuffer`，可以让文件直接在内存（堆外的内存）中进行修改，而如何同步到文件由 `NIO` 来完成。【举例说明】
```java
package com.atguigu.nio;
import java.io.RandomAccessFile;
import java.nio.MappedByteBuffer;
import java.nio.channels.FileChannel;
/**
* 说明 1.MappedByteBuffer 可让文件直接在内存（堆外内存）修改,操作系统不需要拷贝一次
*/
public class MappedByteBufferTest {
public static void main(String[] args) throws Exception {
RandomAccessFile randomAccessFile = new RandomAccessFile("1.txt", "rw");
//获取对应的通道
FileChannel channel = randomAccessFile.getChannel();
/**
* 参数 1:FileChannel.MapMode.READ_WRITE 使用的读写模式
* 参数 2：0：可以直接修改的起始位置
* 参数 3:5: 是映射到内存的大小（不是索引位置），即将 1.txt 的多少个字节映射到内存
* 可以直接修改的范围就是 0-5
* 实际类型 DirectByteBuffer
*/
MappedByteBuffer mappedByteBuffer = channel.map(FileChannel.MapMode.READ_WRITE, 0, 5);
mappedByteBuffer.put(0, (byte) 'H');
mappedByteBuffer.put(3, (byte) '9');
mappedByteBuffer.put(5, (byte) 'Y');//IndexOutOfBoundsException
randomAccessFile.close();
System.out.println("修改成功~~");
}
}
```
4. 前面我们讲的读写操作，都是通过一个 `Buffer` 完成的，`NIO` 还支持通过多个 `Buffer`（即 `Buffer`数组）完成读写操作，即 `Scattering` 和 `Gathering`【举例说明】
```java
package com.atguigu.nio;
import java.net.InetSocketAddress;
import java.nio.ByteBuffer;
import java.nio.channels.ServerSocketChannel;
import java.nio.channels.SocketChannel;
import java.util.Arrays;
/**
* Scattering：将数据写入到 buffer 时，可以采用 buffer 数组，依次写入 [分散]
* Gathering：从 buffer 读取数据时，可以采用 buffer 数组，依次读
*/
public class ScatteringAndGatheringTest {
public static void main(String[] args) throws Exception {
//使用 ServerSocketChannel 和 SocketChannel 网络
ServerSocketChannel serverSocketChannel = ServerSocketChannel.open();
InetSocketAddress inetSocketAddress = new InetSocketAddress(7000);
//绑定端口到 socket，并启动
serverSocketChannel.socket().bind(inetSocketAddress);
//创建 buffer 数组
ByteBuffer[] byteBuffers = new ByteBuffer[2];
byteBuffers[0] = ByteBuffer.allocate(5);
byteBuffers[1] = ByteBuffer.allocate(3);
//等客户端连接 (telnet)
SocketChannel socketChannel = serverSocketChannel.accept();
int messageLength = 8; //假定从客户端接收 8 个字节
//循环的读取
while (true) {
int byteRead = 0;
while (byteRead < messageLength) {
long l = socketChannel.read(byteBuffers);
byteRead += l; //累计读取的字节数
System.out.println("byteRead = " + byteRead);
//使用流打印,看看当前的这个 buffer 的 position 和 limit
Arrays.asList(byteBuffers).stream().map(buffer -> "position = " + buffer.position() + ", limit = " + buffer.limit()).forEach(System.out::println);
}
//将所有的 buffer 进行 flip
Arrays.asList(byteBuffers).forEach(buffer -> buffer.flip());
//将数据读出显示到客户端
long byteWirte = 0;
while (byteWirte < messageLength) {
long l = socketChannel.write(byteBuffers);//
byteWirte += l;
}
//将所有的buffer进行clear
Arrays.asList(byteBuffers).forEach(buffer -> {
buffer.clear();
});
System.out.println("byteRead = " + byteRead + ", byteWrite = " + byteWirte + ", messagelength = " + messageLength);
}
}
}
```
## 3.7 Selector（选择器）
### 3.7.1 基本介绍
1. `Java` 的 `NIO`，用非阻塞的 `IO` 方式。可以用一个线程，处理多个的客户端连接，就会使用到 `Selector`（选择器）。
2. `Selector` 能够检测多个注册的通道上是否有事件发生（注意：多个 `Channel` 以事件的方式可以注册到同一个 `Selector`），如果有事件发生，便获取事件然后针对每个事件进行相应的处理。这样就可以只用一个单线程去管理多个通道，也就是管理多个连接和请求。【示意图】
3. 只有在连接/通道真正有读写事件发生时，才会进行读写，就大大地减少了系统开销，并且不必为每个连接都创建一个线程，不用去维护多个线程。
4. 避免了多线程之间的上下文切换导致的开销。
### 3.7.2 Selector 示意图和特点说明
说明如下：
1. `Netty` 的 `IO` 线程 `NioEventLoop` 聚合了 `Selector`（选择器，也叫多路复用器），可以同时并发处理成百上千个客户端连接。
2. 当线程从某客户端 `Socket` 通道进行读写数据时，若没有数据可用时，该线程可以进行其他任务。
3. 线程通常将非阻塞 `IO` 的空闲时间用于在其他通道上执行 `IO` 操作，所以单独的线程可以管理多个输入和输出通道。
4. 由于读写操作都是非阻塞的，这就可以充分提升 `IO` 线程的运行效率，避免由于频繁 `I/O` 阻塞导致的线程挂起。
5. 一个 `I/O` 线程可以并发处理 `N` 个客户端连接和读写操作，这从根本上解决了传统同步阻塞 `I/O` 一连接一线程模型，架构的性能、弹性伸缩能力和可靠性都得到了极大的提升。
### 3.7.3 Selector 类相关方法
### 3.7.4 注意事项
1. `NIO` 中的 `ServerSocketChannel` 功能类似 `ServerSocket`、`SocketChannel` 功能类似 `Socket`。
2. `Selector` 相关方法说明
- `selector.select();` //阻塞
- `selector.select(1000);` //阻塞 1000 毫秒，在 1000 毫秒后返回
- `selector.wakeup();` //唤醒 selector
- `selector.selectNow();` //不阻塞，立马返还
## 3.8 NIO 非阻塞网络编程原理分析图
`NIO` 非阻塞网络编程相关的（`Selector`、`SelectionKey`、`ServerScoketChannel` 和 `SocketChannel`）关系梳理图
对上图的说明：
1. 当客户端连接时，会通过 `ServerSocketChannel` 得到 `SocketChannel`。
2. `Selector` 进行监听 `select` 方法，返回有事件发生的通道的个数。
3. 将 `socketChannel` 注册到 `Selector` 上，`register(Selector sel, int ops)`，一个 `Selector` 上可以注册多个 `SocketChannel`。
4. 注册后返回一个 `SelectionKey`，会和该 `Selector` 关联（集合）。
5. 进一步得到各个 `SelectionKey`（有事件发生）。
6. 在通过 `SelectionKey` 反向获取 `SocketChannel`，方法 `channel()`。
7. 可以通过得到的 `channel`，完成业务处理。
8. 代码撑腰。。。
## 3.9 NIO 非阻塞网络编程快速入门
案例要求：
1. 编写一个 `NIO` 入门案例，实现服务器端和客户端之间的数据简单通讯（非阻塞）
2. 目的：理解 `NIO` 非阻塞网络编程机制
3. 看老师代码演示
## 3.10 SelectionKey
1. `SelectionKey`，表示 `Selector` 和网络通道的注册关系，共四种：
- `int OP_ACCEPT`：有新的网络连接可以 `accept`，值为 `16`
- `int OP_CONNECT`：代表连接已经建立，值为 `8`
- `int OP_READ`：代表读操作，值为 `1`
- `int OP_WRITE`：代表写操作，值为 `4`
源码中：
```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. `SelectionKey` 相关方法
## 3.11 ServerSocketChannel
1. `ServerSocketChannel` 在服务器端监听新的客户端 `Socket` 连接
2. 相关方法如下
## 3.12 SocketChannel
1. `SocketChannel`，网络 `IO` 通道，具体负责进行读写操作。`NIO` 把缓冲区的数据写入通道，或者把通道里的数据读到缓冲区。
2. 相关方法如下
## 3.13 NIO 网络编程应用实例 - 群聊系统
实例要求：
1. 编写一个 `NIO` 群聊系统，实现服务器端和客户端之间的数据简单通讯（非阻塞）
2. 实现多人群聊
3. 服务器端：可以监测用户上线，离线，并实现消息转发功能
4. 客户端：通过 `Channel` 可以无阻塞发送消息给其它所有用户，同时可以接受其它用户发送的消息（有服务器转发得到）
5. 目的：进一步理解 `NIO` 非阻塞网络编程机制
6. 示意图分析和代码
代码：
```java
// 服务端：
package com.atguigu.nio.groupchat;
import java.io.IOException;
import java.net.InetSocketAddress;
import java.nio.ByteBuffer;
import java.nio.channels.Channel;
import java.nio.channels.SelectionKey;
import java.nio.channels.Selector;
import java.nio.channels.ServerSocketChannel;
import java.nio.channels.SocketChannel;
import java.util.Iterator;
public class GroupChatServer {
//定义属性
private Selector selector;
private ServerSocketChannel listenChannel;
private static final int PORT = 6667;
//构造器
//初始化工作
public GroupChatServer() {
try {
//得到选择器
selector = Selector.open();
//ServerSocketChannel
listenChannel = ServerSocketChannel.open();
//绑定端口
listenChannel.socket().bind(new InetSocketAddress(PORT));
//设置非阻塞模式
listenChannel.configureBlocking(false);
//将该 listenChannel 注册到 selector
listenChannel.register(selector, SelectionKey.OP_ACCEPT);
} catch (IOException e) {
e.printStackTrace();
}
}
public void listen() {
try {
//循环处理
while (true) {
int count = selector.select();
if (count > 0) { //有事件处理
// 遍历得到 selectionKey 集合
Iterator<SelectionKey> iterator = selector.selectedKeys().iterator();
while (iterator.hasNext()) {
//取出 selectionkey
SelectionKey key = iterator.next();
//监听到 accept
if (key.isAcceptable()) {
SocketChannel sc = listenChannel.accept();
sc.configureBlocking(false);
//将该 sc 注册到 seletor
sc.register(selector, SelectionKey.OP_READ);
//提示
System.out.println(sc.getRemoteAddress() + " 上线 ");
}
if (key.isReadable()) {//通道发送read事件，即通道是可读的状态
// 处理读(专门写方法..)
readData(key);
}
//当前的 key 删除，防止重复处理
iterator.remove();
}
} else {
System.out.println("等待....");
}
}
} catch (Exception e) {
e.printStackTrace();
} finally {
//发生异常处理....
}
}
//读取客户端消息
public void readData(SelectionKey key) {
SocketChannel channel = null;
try {
//得到 channel
channel = (SocketChannel) key.channel();
//创建 buffer
ByteBuffer buffer = ByteBuffer.allocate(1024);
int count = channel.read(buffer);
//根据 count 的值做处理
if (count > 0) {
//把缓存区的数据转成字符串
String msg = new String(buffer.array());
//输出该消息
System.out.println("form客户端:" + msg);
//向其它的客户端转发消息(去掉自己),专门写一个方法来处理
sendInfoToOtherClients(msg, channel);
}
} catch (IOException e) {
try {
System.out.println(channel.getRemoteAddress() + "离线了..");
//取消注册
key.cancel();
//关闭通道
channel.close();
} catch (IOException e2) {
e2.printStackTrace();
}
}
}
//转发消息给其它客户(通道)
private void sendInfoToOtherClients(String msg, SocketChannel self) throws IOException {
System.out.println("服务器转发消息中...");
//遍历所有注册到 selector 上的 SocketChannel,并排除 self
for (SelectionKey key : selector.keys()) {
//通过 key 取出对应的 SocketChannel
Channel targetChannel = key.channel();
//排除自己
if (targetChannel instanceof SocketChannel && targetChannel != self) {
//转型
SocketChannel dest = (SocketChannel) targetChannel;
//将 msg 存储到 buffer
ByteBuffer buffer = ByteBuffer.wrap(msg.getBytes());
//将 buffer 的数据写入通道
dest.write(buffer);
}
}
}
public static void main(String[] args) {
//创建服务器对象
GroupChatServer groupChatServer = new GroupChatServer();
groupChatServer.listen();
}
}
// 客户端：
package com.atguigu.nio.groupchat;
import java.io.IOException;
import java.net.InetSocketAddress;
import java.nio.ByteBuffer;
import java.nio.channels.SelectionKey;
import java.nio.channels.Selector;
import java.nio.channels.SocketChannel;
import java.util.Iterator;
import java.util.Scanner;
public class GroupChatClient {
//定义相关的属性
private final String HOST = "127.0.0.1";//服务器的ip
private final int PORT = 6667;//服务器端口
private Selector selector;
private SocketChannel socketChannel;
private String username;
//构造器,完成初始化工作
public GroupChatClient() throws IOException {
selector = Selector.open();
//连接服务器
socketChannel = SocketChannel.open(new InetSocketAddress(HOST, PORT));
//设置非阻塞
socketChannel.configureBlocking(false);
//将 channel 注册到selector
socketChannel.register(selector, SelectionKey.OP_READ);
//得到 username
username = socketChannel.getLocalAddress().toString().substring(1);
System.out.println(username + " is ok...");
}
//向服务器发送消息
public void sendInfo(String info) {
info = username + " 说：" + info;
try {
socketChannel.write(ByteBuffer.wrap(info.getBytes()));
} catch (IOException e) {
e.printStackTrace();
}
}
//读取从服务器端回复的消息
public void readInfo() {
try {
int readChannels = selector.select();
if (readChannels > 0) {//有可以用的通道
Iterator<SelectionKey> iterator = selector.selectedKeys().iterator();
while (iterator.hasNext()) {
SelectionKey key = iterator.next();
if (key.isReadable()) {
//得到相关的通道
SocketChannel sc = (SocketChannel) key.channel();
//得到一个 Buffer
ByteBuffer buffer = ByteBuffer.allocate(1024);
//读取
sc.read(buffer);
//把读到的缓冲区的数据转成字符串
String msg = new String(buffer.array());
System.out.println(msg.trim());
}
}
iterator.remove(); //删除当前的 selectionKey,防止重复操作
} else {
//System.out.println("没有可以用的通道...");
}
} catch (Exception e) {
e.printStackTrace();
}
}
public static void main(String[] args) throws Exception {
//启动我们客户端
GroupChatClient chatClient = new GroupChatClient();
//启动一个线程,每个 3 秒，读取从服务器发送数据
new Thread() {
public void run() {
while (true) {
chatClient.readInfo();
try {
Thread.currentThread().sleep(3000);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}
}.start();
//发送数据给服务器端
Scanner scanner = new Scanner(System.in);
while (scanner.hasNextLine()) {
String s = scanner.nextLine();
chatClient.sendInfo(s);
}
}
}
```
## 3.14 NIO 与零拷贝
### 3.14.1 零拷贝基本介绍
1. 零拷贝是网络编程的关键，很多性能优化都离不开。
2. 在 `Java` 程序中，常用的零拷贝有 `mmap`（内存映射）和 `sendFile`。那么，他们在 `OS` 里，到底是怎么样的一个的设计？我们分析 `mmap` 和 `sendFile` 这两个零拷贝
3. 另外我们看下 `NIO` 中如何使用零拷贝
### 3.14.2 传统 IO 数据读写
`Java` 传统 `IO` 和网络编程的一段代码
```java
File file = new File("test.txt");
RandomAccessFile raf = new RandomAccessFile(file, "rw");
byte[] arr = new byte[(int) file.length()];
raf.read(arr);
Socket socket = new ServerSocket(8080).accept();
socket.getOutputStream().write(arr);
```
### 3.14.3 传统 IO 模型
**DMA**：`direct memory access` 直接内存拷贝（不使用 `CPU`）
### 3.14.4 mmap 优化
1. `mmap` 通过内存映射，将文件映射到内核缓冲区，同时，用户空间可以共享内核空间的数据。这样，在进行网络传输时，就可以减少内核空间到用户空间的拷贝次数。如下图
2. `mmap` 示意图
### 3.14.5 sendFile 优化
1. `Linux2.1` 版本提供了 `sendFile` 函数，其基本原理如下：数据根本不经过用户态，直接从内核缓冲区进入到 `SocketBuffer`，同时，由于和用户态完全无关，就减少了一次上下文切换
2. 示意图和小结
3. 提示：零拷贝从操作系统角度，是没有 `cpu` 拷贝
4. `Linux在2.4` 版本中，做了一些修改，避免了从内核缓冲区拷贝到 `Socketbuffer` 的操作，直接拷贝到协议栈，从而再一次减少了数据拷贝。具体如下图和小结：
5. 这里其实有一次 `cpu` 拷贝 `kernel buffer` -> `socket buffer` 但是，拷贝的信息很少，比如 `lenght`、`offset` 消耗低，可以忽略
### 3.14.6 零拷贝的再次理解
1. 我们说零拷贝，是从操作系统的角度来说的。因为内核缓冲区之间，没有数据是重复的（只有 `kernel buffer` 有一份数据）。
2. 零拷贝不仅仅带来更少的数据复制，还能带来其他的性能优势，例如更少的上下文切换，更少的 `CPU` 缓存伪共享以及无 `CPU` 校验和计算。
### 3.14.7 mmap 和 sendFile 的区别
1. `mmap` 适合小数据量读写，`sendFile` 适合大文件传输。
2. `mmap` 需要 `4` 次上下文切换，`3` 次数据拷贝；`sendFile` 需要 `3` 次上下文切换，最少 `2` 次数据拷贝。
3. `sendFile` 可以利用 `DMA` 方式，减少 `CPU` 拷贝，`mmap` 则不能（必须从内核拷贝到 `Socket`缓冲区）。
### 3.14.8 NIO 零拷贝案例
案例要求：
1. 使用传统的 `IO` 方法传递一个大文件
2. 使用 `NIO` 零拷贝方式传递（`transferTo`）一个大文件
3. 看看两种传递方式耗时时间分别是多少
```java
NewIOServer.java
package com.atguigu.nio.zerocopy;
import java.net.InetSocketAddress;
import java.net.ServerSocket;
import java.nio.ByteBuffer;
import java.nio.channels.ServerSocketChannel;
import java.nio.channels.SocketChannel;
//服务器
public class NewIOServer {
public static void main(String[] args) throws Exception {
InetSocketAddress address = new InetSocketAddress(7001);
ServerSocketChannel serverSocketChannel = ServerSocketChannel.open();
ServerSocket serverSocket = serverSocketChannel.socket();
serverSocket.bind(address);
//创建buffer
ByteBuffer byteBuffer = ByteBuffer.allocate(4096);
while (true) {
SocketChannel socketChannel = serverSocketChannel.accept();
int readcount = 0;
while (-1 != readcount) {
try {
readcount = socketChannel.read(byteBuffer);
} catch (Exception ex) {
// ex.printStackTrace();
break;
}
//
byteBuffer.rewind(); //倒带 position = 0 mark 作废
}
}
}
}
NewIOClient.java
package com.atguigu.nio.zerocopy;
import java.io.FileInputStream;
import java.net.InetSocketAddress;
import java.nio.channels.FileChannel;
import java.nio.channels.SocketChannel;
public class NewIOClient {
public static void main(String[] args) throws Exception {
SocketChannel socketChannel = SocketChannel.open();
socketChannel.connect(new InetSocketAddress("localhost", 7001));
String filename = "protoc-3.6.1-win32.zip";
//得到一个文件channel
FileChannel fileChannel = new FileInputStream(filename).getChannel();
//准备发送
long startTime = System.currentTimeMillis();
//在 linux 下一个 transferTo 方法就可以完成传输
//在 windows 下一次调用 transferTo 只能发送 8m, 就需要分段传输文件,而且要主要
//传输时的位置=》课后思考...
//transferTo 底层使用到零拷贝
long transferCount = fileChannel.transferTo(0, fileChannel.size(), socketChannel);
System.out.println("发送的总的字节数 = " + transferCount + " 耗时: " + (System.currentTimeMillis() - startTime));
//关闭
fileChannel.close();
}
}
```
## 3.15 Java AIO 基本介绍
1. `JDK7` 引入了 `AsynchronousI/O`，即 `AIO`。在进行 `I/O` 编程中，常用到两种模式：`Reactor` 和 `Proactor`。`Java` 的 `NIO` 就是 `Reactor`，当有事件触发时，服务器端得到通知，进行相应的处理
2. `AIO` 即 `NIO2.0`，叫做异步不阻塞的 `IO`。`AIO` 引入异步通道的概念，采用了 `Proactor` 模式，简化了程序编写，有效的请求才启动线程，它的特点是先由操作系统完成后才通知服务端程序启动线程去处理，一般适用于连接数较多且连接时间较长的应用
3. 目前 `AIO` 还没有广泛应用，`Netty` 也是基于 `NIO`，而不是 `AIO`，因此我们就不详解 `AIO` 了，有兴趣的同学可以参考[《Java新一代网络编程模型AIO原理及Linux系统AIO介绍》](http://www.52im.net/thread-306-1-1.html)
## 3.16 BIO、NIO、AIO 对比表
| | BIO | NIO | AIO |
|:-----:| :-----: | :---------------: | :------: |
|IO模型 | 同步阻塞 | 同步非阻塞（多路复用）| 异步非阻塞 |
|编程难度| 简单 | 复杂 | 复杂 |
|可靠性 | 差 | 好 | 好 |
|吞吐量 | 低 | 高 | 高 |
**举例说明**
1. 同步阻塞：到理发店理发，就一直等理发师，直到轮到自己理发。
2. 同步非阻塞：到理发店理发，发现前面有其它人理发，给理发师说下，先干其他事情，一会过来看是否轮到自己.
3. 异步非阻塞：给理发师打电话，让理发师上门服务，自己干其它事情，理发师自己来家给你理发
================================================
FILE: docs/_content/chapter04.md
================================================
## 4.1 原生 NIO 存在的问题
1. `NIO` 的类库和 `API` 繁杂，使用麻烦：需要熟练掌握 `Selector`、`ServerSocketChannel`、`SocketChannel`、`ByteBuffer`等。
2. 需要具备其他的额外技能：要熟悉 `Java` 多线程编程，因为 `NIO` 编程涉及到 `Reactor` 模式，你必须对多线程和网络编程非常熟悉，才能编写出高质量的 `NIO` 程序。
3. 开发工作量和难度都非常大：例如客户端面临断连重连、网络闪断、半包读写、失败缓存、网络拥塞和异常流的处理等等。4. `JDK NIO` 的 `Bug`：例如臭名昭著的 `Epoll Bug`，它会导致 `Selector` 空轮询，最终导致 `CPU100%`。直到 `JDK1.7` 版本该问题仍旧存在，没有被根本解决。
## 4.2 Netty 官网说明
官网：https://netty.io/
Netty is an asynchronous event-driven network application framework for rapid development of maintainable high performance protocol servers & clients.
## 4.3 Netty 的优点
`Netty` 对 `JDK` 自带的 `NIO` 的 `API` 进行了封装，解决了上述问题。
1. 设计优雅：适用于各种传输类型的统一 `API` 阻塞和非阻塞 `Socket`；基于灵活且可扩展的事件模型，可以清晰地分离关注点；高度可定制的线程模型-单线程，一个或多个线程池。
2. 使用方便：详细记录的 `Javadoc`，用户指南和示例；没有其他依赖项，`JDK5（Netty3.x）`或 `6（Netty4.x）`就足够了。
3. 高性能、吞吐量更高：延迟更低；减少资源消耗；最小化不必要的内存复制。
4. 安全：完整的 `SSL/TLS` 和 `StartTLS` 支持。
5. 社区活跃、不断更新：社区活跃，版本迭代周期短，发现的 `Bug` 可以被及时修复，同时，更多的新功能会被加入。
## 4.4 Netty 版本说明
1. `Netty` 版本分为 `Netty 3.x` 和 `Netty 4.x`、`Netty 5.x`
2. 因为 `Netty 5` 出现重大 `bug`，已经被官网废弃了，目前推荐使用的是 `Netty 4.x`的稳定版本
3. 目前在官网可下载的版本 `Netty 3.x`、`Netty 4.0.x` 和 `Netty 4.1.x`
4. 在本套课程中，我们讲解 `Netty4.1.x` 版本
5. `Netty` 下载地址：https://bintray.com/netty/downloads/netty/
================================================
FILE: docs/_content/chapter05.md
================================================
## 5.1 线程模型基本介绍
1. 不同的线程模式，对程序的性能有很大影响，为了搞清 `Netty` 线程模式，我们来系统的讲解下各个线程模式，最后看看 `Netty` 线程模型有什么优越性。
2. 目前存在的线程模型有：传统阻塞 `I/O` 服务模型 `Reactor` 模式
3. 根据 `Reactor` 的数量和处理资源池线程的数量不同，有 `3` 种典型的实现单 `Reactor` 单线程；单 `Reactor`多线程；主从 `Reactor`多线程
4. `Netty` 线程模式（`Netty` 主要基于主从 `Reactor` 多线程模型做了一定的改进，其中主从 `Reactor` 多线程模型有多个 `Reactor`）
## 5.2 传统阻塞 I/O 服务模型
### 5.2.1 工作原理图
1. 黄色的框表示对象，蓝色的框表示线程
2. 白色的框表示方法（`API`）
### 5.2.2 模型特点
1. 采用阻塞 `IO` 模式获取输入的数据
2. 每个连接都需要独立的线程完成数据的输入，业务处理，数据返回
### 5.2.3 问题分析
1. 当并发数很大，就会创建大量的线程，占用很大系统资源
2. 连接创建后，如果当前线程暂时没有数据可读，该线程会阻塞在 `read` 操作，造成线程资源浪费
## 5.3 Reactor 模式
### 5.3.1 针对传统阻塞 I/O 服务模型的 2 个缺点，解决方案：
1. 基于 `I/O` 复用模型：多个连接共用一个阻塞对象，应用程序只需要在一个阻塞对象等待，无需阻塞等待所有连接。当某个连接有新的数据可以处理时，操作系统通知应用程序，线程从阻塞状态返回，开始进行业务处理 `Reactor` 对应的叫法：
1. 反应器模式
2. 分发者模式（Dispatcher）
3. 通知者模式（notifier）
2. 基于线程池复用线程资源：不必再为每个连接创建线程，将连接完成后的业务处理任务分配给线程进行处理，一个线程可以处理多个连接的业务。
### 5.3.2 I/O 复用结合线程池，就是 Reactor 模式基本设计思想，如图
对上图说明：
1. `Reactor` 模式，通过一个或多个输入同时传递给服务处理器的模式（基于事件驱动）
2. 服务器端程序处理传入的多个请求,并将它们同步分派到相应的处理线程，因此 `Reactor` 模式也叫 `Dispatcher` 模式
3. `Reactor` 模式使用 `IO` 复用监听事件，收到事件后，分发给某个线程（进程），这点就是网络服务器高并发处理关键
### 5.3.3 Reactor 模式中核心组成
1. `Reactor`：`Reactor` 在一个单独的线程中运行，负责监听和分发事件，分发给适当的处理程序来对 `IO` 事件做出反应。它就像公司的电话接线员，它接听来自客户的电话并将线路转移到适当的联系人；
2. `Handlers`：处理程序执行 `I/O` 事件要完成的实际事件，类似于客户想要与之交谈的公司中的实际官员。`Reactor` 通过调度适当的处理程序来响应 `I/O` 事件，处理程序执行非阻塞操作。
### 5.3.4 Reactor 模式分类
根据 `Reactor` 的数量和处理资源池线程的数量不同，有 `3` 种典型的实现
1. 单 `Reactor` 单线程
2. 单 `Reactor` 多线程
3. 主从 `Reactor` 多线程
## 5.4 单 Reactor 单线程
原理图，并使用 `NIO` 群聊系统验证
### 5.4.1 方案说明
1. `Select` 是前面 `I/O` 复用模型介绍的标准网络编程 `API`，可以实现应用程序通过一个阻塞对象监听多路连接请求
2. `Reactor` 对象通过 `Select` 监控客户端请求事件，收到事件后通过 `Dispatch` 进行分发
3. 如果是建立连接请求事件，则由 `Acceptor` 通过 `Accept` 处理连接请求，然后创建一个 `Handler` 对象处理连接完成后的后续业务处理
4. 如果不是建立连接事件，则 `Reactor` 会分发调用连接对应的 `Handler` 来响应
5. `Handler` 会完成 `Read` → 业务处理 → `Send` 的完整业务流程
结合实例：服务器端用一个线程通过多路复用搞定所有的 `IO` 操作（包括连接，读、写等），编码简单，清晰明了，但是如果客户端连接数量较多，将无法支撑，前面的 `NIO` 案例就属于这种模型。
### 5.4.2 方案优缺点分析
1. 优点：模型简单，没有多线程、进程通信、竞争的问题，全部都在一个线程中完成
2. 缺点：性能问题，只有一个线程，无法完全发挥多核 `CPU` 的性能。`Handler`在处理某个连接上的业务时，整个进程无法处理其他连接事件，很容易导致性能瓶颈
3. 缺点：可靠性问题，线程意外终止，或者进入死循环，会导致整个系统通信模块不可用，不能接收和处理外部消息，造成节点故障
4. 使用场景：客户端的数量有限，业务处理非常快速，比如 `Redis` 在业务处理的时间复杂度 `O(1)` 的情况
## 5.5 单 Reactor 多线程
### 5.5.1 原理图
### 5.5.2 对上图的小结
1. `Reactor` 对象通过 `Select` 监控客户端请求事件，收到事件后，通过 `Dispatch` 进行分发
2. 如果建立连接请求，则右 `Acceptor` 通过 `accept` 处理连接请求，然后创建一个 `Handler` 对象处理完成连接后的各种事件
3. 如果不是连接请求，则由 `Reactor` 分发调用连接对应的 `handler` 来处理
4. `handler` 只负责响应事件，不做具体的业务处理，通过 `read` 读取数据后，会分发给后面的 `worker` 线程池的某个线程处理业务
5. `worker` 线程池会分配独立线程完成真正的业务，并将结果返回给 `handler`
6. `handler` 收到响应后，通过 `send` 将结果返回给 `client`
### 5.5.3 方案优缺点分析
1. 优点：可以充分的利用多核 `cpu` 的处理能力
2. 缺点：多线程数据共享和访问比较复杂，`Reactor` 处理所有的事件的监听和响应，在单线程运行，在高并发场景容易出现性能瓶颈。
## 5.6 主从 Reactor 多线程
### 5.6.1 工作原理图
针对单 `Reactor` 多线程模型中，`Reactor` 在单线程中运行，高并发场景下容易成为性能瓶颈，可以让 `Reactor` 在多线程中运行
### 5.6.2 上图的方案说明
1. `Reactor` 主线程 `MainReactor` 对象通过 `select` 监听连接事件，收到事件后，通过 `Acceptor` 处理连接事件
2. 当 `Acceptor` 处理连接事件后，`MainReactor` 将连接分配给 `SubReactor`
3. `subreactor` 将连接加入到连接队列进行监听，并创建 `handler` 进行各种事件处理
4. 当有新事件发生时，`subreactor` 就会调用对应的 `handler` 处理
5. `handler` 通过 `read` 读取数据，分发给后面的 `worker` 线程处理
6. `worker` 线程池分配独立的 `worker` 线程进行业务处理，并返回结果
7. `handler` 收到响应的结果后，再通过 `send` 将结果返回给 `client`
8. `Reactor` 主线程可以对应多个 `Reactor` 子线程，即 `MainRecator` 可以关联多个 `SubReactor`
### 5.6.3 Scalable IO in Java 对 Multiple Reactors 的原理图解：
### 5.6.4 方案优缺点说明
1. 优点：父线程与子线程的数据交互简单职责明确，父线程只需要接收新连接，子线程完成后续的业务处理。
2. 优点：父线程与子线程的数据交互简单，`Reactor` 主线程只需要把新连接传给子线程，子线程无需返回数据。
3. 缺点：编程复杂度较高
4. 结合实例：这种模型在许多项目中广泛使用，包括 `Nginx` 主从 `Reactor` 多进程模型，`Memcached` 主从多线程，`Netty` 主从多线程模型的支持
## 5.7 Reactor 模式小结
### 5.7.1 3 种模式用生活案例来理解
1. 单 `Reactor` 单线程，前台接待员和服务员是同一个人，全程为顾客服务
2. 单 `Reactor` 多线程，`1` 个前台接待员，多个服务员，接待员只负责接待
3. 主从 `Reactor` 多线程，多个前台接待员，多个服务生
### 5.7.2 Reactor 模式具有如下的优点
1. 响应快，不必为单个同步时间所阻塞，虽然 `Reactor` 本身依然是同步的
2. 可以最大程度的避免复杂的多线程及同步问题，并且避免了多线程/进程的切换开销
3. 扩展性好，可以方便的通过增加 `Reactor` 实例个数来充分利用 `CPU` 资源
4. 复用性好，`Reactor` 模型本身与具体事件处理逻辑无关，具有很高的复用性
## 5.8 Netty 模型
### 5.8.1 工作原理示意图1 - 简单版
`Netty` 主要基于主从 `Reactors` 多线程模型（如图）做了一定的改进，其中主从 `Reactor` 多线程模型有多个 `Reactor`
### 5.8.2 对上图说明
1. `BossGroup` 线程维护 `Selector`，只关注 `Accecpt`
2. 当接收到 `Accept` 事件，获取到对应的 `SocketChannel`，封装成 `NIOScoketChannel` 并注册到 `Worker` 线程（事件循环），并进行维护
3. 当 `Worker` 线程监听到 `Selector` 中通道发生自己感兴趣的事件后，就进行处理（就由 `handler`），注意 `handler` 已经加入到通道
### 5.8.3 工作原理示意图2 - 进阶版
### 5.8.4 工作原理示意图 - 详细版
### 5.8.5 对上图的说明小结
1. `Netty` 抽象出两组线程池 `BossGroup` 专门负责接收客户端的连接，`WorkerGroup` 专门负责网络的读写
2. `BossGroup` 和 `WorkerGroup` 类型都是 `NioEventLoopGroup`
3. `NioEventLoopGroup` 相当于一个事件循环组，这个组中含有多个事件循环，每一个事件循环是 `NioEventLoop`
4. `NioEventLoop` 表示一个不断循环的执行处理任务的线程，每个 `NioEventLoop` 都有一个 `Selector`，用于监听绑定在其上的 `socket` 的网络通讯
5. `NioEventLoopGroup` 可以有多个线程，即可以含有多个 `NioEventLoop`
6. 每个 `BossNioEventLoop` 循环执行的步骤有 `3` 步
- 轮询 `accept` 事件
- 处理 `accept` 事件，与 `client` 建立连接，生成 `NioScocketChannel`，并将其注册到某个 `worker` `NIOEventLoop` 上的 `Selector`
- 处理任务队列的任务，即 `runAllTasks`
7. 每个 `Worker` `NIOEventLoop` 循环执行的步骤
- 轮询 `read`，`write` 事件
- 处理 `I/O` 事件，即 `read`，`write` 事件，在对应 `NioScocketChannel` 处理
- 处理任务队列的任务，即 `runAllTasks`
8. 每个 `Worker` `NIOEventLoop` 处理业务时，会使用 `pipeline`（管道），`pipeline` 中包含了 `channel`，即通过 `pipeline` 可以获取到对应通道，管道中维护了很多的处理器
### 5.8.6 Netty 快速入门实例 - TCP 服务
实例要求：使用 `IDEA` 创建 `Netty` 项目
1. `Netty` 服务器在 `6668` 端口监听，客户端能发送消息给服务器"hello,服务器~"
2. 服务器可以回复消息给客户端"hello,客户端~"
3. 目的：对 `Netty` 线程模型有一个初步认识，便于理解 `Netty` 模型理论
4. 看老师代码演示
5.1 编写服务端 5.2 编写客户端 5.3 对 `netty` 程序进行分析，看看 `netty` 模型特点
说明：创建 `Maven` 项目，并引入 `Netty` 包
5. 代码如下
```java
NettyServer.java
package com.atguigu.netty.simple;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelFutureListener;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
public class NettyServer {
public static void main(String[] args) throws Exception {
//创建BossGroup 和 WorkerGroup
//说明
//1. 创建两个线程组 bossGroup 和 workerGroup
//2. bossGroup 只是处理连接请求 , 真正的和客户端业务处理，会交给 workerGroup完成
//3. 两个都是无限循环
//4. bossGroup 和 workerGroup 含有的子线程(NioEventLoop)的个数
// 默认实际 cpu核数 * 2
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup(); //8
try {
//创建服务器端的启动对象，配置参数
ServerBootstrap bootstrap = new ServerBootstrap();
//使用链式编程来进行设置
bootstrap.group(bossGroup, workerGroup) //设置两个线程组
.channel(NioServerSocketChannel.class) //使用NioSocketChannel 作为服务器的通道实现
.option(ChannelOption.SO_BACKLOG, 128) // 设置线程队列得到连接个数
.childOption(ChannelOption.SO_KEEPALIVE, true) //设置保持活动连接状态
// .handler(null) // 该 handler对应 bossGroup , childHandler 对应 workerGroup
.childHandler(new ChannelInitializer<SocketChannel>() {//创建一个通道初始化对象(匿名对象)
//给pipeline 设置处理器
@Override
protected void initChannel(SocketChannel ch) throws Exception {
System.out.println("客户socketchannel hashcode=" + ch.hashCode()); //可以使用一个集合管理 SocketChannel， 再推送消息时，可以将业务加入到各个channel 对应的 NIOEventLoop 的 taskQueue 或者 scheduleTaskQueue
ch.pipeline().addLast(new NettyServerHandler());
}
}); // 给我们的workerGroup 的 EventLoop 对应的管道设置处理器
System.out.println(".....服务器 is ready...");
//绑定一个端口并且同步, 生成了一个 ChannelFuture 对象
//启动服务器(并绑定端口)
ChannelFuture cf = bootstrap.bind(6668).sync();
//给cf 注册监听器，监控我们关心的事件
cf.addListener(new ChannelFutureListener() {
@Override
public void operationComplete(ChannelFuture future) throws Exception {
if (cf.isSuccess()) {
System.out.println("监听端口 6668 成功");
} else {
System.out.println("监听端口 6668 失败");
}
}
});
//对关闭通道进行监听
cf.channel().closeFuture().sync();
}finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
NettyServerHandler.java
package com.atguigu.netty.simple;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import io.netty.channel.Channel;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
import io.netty.channel.ChannelPipeline;
import io.netty.util.CharsetUtil;
/**
* 说明
* 1. 我们自定义一个Handler 需要继续netty 规定好的某个HandlerAdapter(规范)
* 2. 这时我们自定义一个Handler , 才能称为一个handler
*/
public class NettyServerHandler extends ChannelInboundHandlerAdapter {
//读取数据实际(这里我们可以读取客户端发送的消息)
/**
* 1. ChannelHandlerContext ctx:上下文对象, 含有 管道pipeline , 通道channel, 地址
* 2. Object msg: 就是客户端发送的数据 默认Object
*/
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
System.out.println("服务器读取线程 " + Thread.currentThread().getName() + " channle =" + ctx.channel());
System.out.println("server ctx =" + ctx);
System.out.println("看看channel 和 pipeline的关系");
Channel channel = ctx.channel();
ChannelPipeline pipeline = ctx.pipeline(); //本质是一个双向链接, 出站入站
//将 msg 转成一个 ByteBuf
//ByteBuf 是 Netty 提供的，不是 NIO 的 ByteBuffer.
ByteBuf buf = (ByteBuf) msg;
System.out.println("客户端发送消息是:" + buf.toString(CharsetUtil.UTF_8));
System.out.println("客户端地址:" + channel.remoteAddress());
}
//数据读取完毕
@Override
public void channelReadComplete(ChannelHandlerContext ctx) throws Exception {
//writeAndFlush 是 write + flush
//将数据写入到缓存，并刷新
//一般讲，我们对这个发送的数据进行编码
ctx.writeAndFlush(Unpooled.copiedBuffer("hello, 客户端~(>^ω^<)喵1", CharsetUtil.UTF_8));
}
//处理异常, 一般是需要关闭通道
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
ctx.close();
}
}
NettyClient.java
package com.atguigu.netty.simple;
import io.netty.bootstrap.Bootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioSocketChannel;
public class NettyClient {
public static void main(String[] args) throws Exception {
//客户端需要一个事件循环组
EventLoopGroup group = new NioEventLoopGroup();
try {
//创建客户端启动对象
//注意客户端使用的不是 ServerBootstrap 而是 Bootstrap
Bootstrap bootstrap = new Bootstrap();
//设置相关参数
bootstrap.group(group) //设置线程组
.channel(NioSocketChannel.class) // 设置客户端通道的实现类(反射)
.handler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ch.pipeline().addLast(new NettyClientHandler()); //加入自己的处理器
}
});
System.out.println("客户端 ok..");
//启动客户端去连接服务器端
//关于 ChannelFuture 要分析，涉及到netty的异步模型
ChannelFuture channelFuture = bootstrap.connect("127.0.0.1", 6668).sync();
//给关闭通道进行监听
channelFuture.channel().closeFuture().sync();
} finally {
group.shutdownGracefully();
}
}
}
NettyClientHandler.java
package com.atguigu.netty.simple;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
import io.netty.util.CharsetUtil;
public class NettyClientHandler extends ChannelInboundHandlerAdapter {
//当通道就绪就会触发该方法
@Override
public void channelActive(ChannelHandlerContext ctx) throws Exception {
System.out.println("client " + ctx);
ctx.writeAndFlush(Unpooled.copiedBuffer("hello, server: (>^ω^<)喵", CharsetUtil.UTF_8));
}
//当通道有读取事件时，会触发
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
ByteBuf buf = (ByteBuf) msg;
System.out.println("服务器回复的消息:" + buf.toString(CharsetUtil.UTF_8));
System.out.println("服务器的地址： " + ctx.channel().remoteAddress());
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
cause.printStackTrace();
ctx.close();
}
}
```
### 5.8.7 任务队列中的 Task 有 3 种典型使用场景
1. 用户程序自定义的普通任务【举例说明】
2. 用户自定义定时任务
3. 非当前 `Reactor` 线程调用 `Channel` 的各种方法
例如在推送系统的业务线程里面，根据用户的标识，找到对应的 `Channel` 引用，然后调用 `Write` 类方法向该用户推送消息，就会进入到这种场景。最终的 `Write` 会提交到任务队列中后被异步消费
4. 代码演示
```java
package com.atguigu.netty.simple;
import io.netty.buffer.Unpooled;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
import io.netty.util.CharsetUtil;
import java.util.concurrent.TimeUnit;
/**
* 说明
* 1. 我们自定义一个Handler 需要继续netty 规定好的某个HandlerAdapter(规范)
* 2. 这时我们自定义一个Handler , 才能称为一个handler
*/
public class NettyServerHandler extends ChannelInboundHandlerAdapter {
//读取数据实际(这里我们可以读取客户端发送的消息)
/**
* 1. ChannelHandlerContext ctx:上下文对象, 含有 管道pipeline , 通道channel, 地址
* 2. Object msg: 就是客户端发送的数据 默认Object
*/
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
// 比如这里我们有一个非常耗时长的业务-> 异步执行 -> 提交该channel 对应的
// NIOEventLoop 的 taskQueue中,
// 解决方案1 用户程序自定义的普通任务
ctx.channel().eventLoop().execute(new Runnable() {
@Override
public void run() {
try {
Thread.sleep(5 * 1000);
ctx.writeAndFlush(Unpooled.copiedBuffer("hello, 客户端~(>^ω^<)喵2", CharsetUtil.UTF_8));
System.out.println("channel code=" + ctx.channel().hashCode());
} catch (Exception ex) {
System.out.println("发生异常" + ex.getMessage());
}
}
});
ctx.channel().eventLoop().execute(new Runnable() {
@Override
public void run() {
try {
Thread.sleep(5 * 1000);
ctx.writeAndFlush(Unpooled.copiedBuffer("hello, 客户端~(>^ω^<)喵3", CharsetUtil.UTF_8));
System.out.println("channel code=" + ctx.channel().hashCode());
} catch (Exception ex) {
System.out.println("发生异常" + ex.getMessage());
}
}
});
//解决方案2 : 用户自定义定时任务 -》 该任务是提交到 scheduleTaskQueue中
ctx.channel().eventLoop().schedule(new Runnable() {
@Override
public void run() {
try {
Thread.sleep(5 * 1000);
ctx.writeAndFlush(Unpooled.copiedBuffer("hello, 客户端~(>^ω^<)喵4", CharsetUtil.UTF_8));
System.out.println("channel code=" + ctx.channel().hashCode());
} catch (Exception ex) {
System.out.println("发生异常" + ex.getMessage());
}
}
}, 5, TimeUnit.SECONDS);
System.out.println("go on ...");
// System.out.println("服务器读取线程 " + Thread.currentThread().getName() + " channle =" + ctx.channel());
// System.out.println("server ctx =" + ctx);
// System.out.println("看看channel 和 pipeline的关系");
// Channel channel = ctx.channel();
// ChannelPipeline pipeline = ctx.pipeline(); //本质是一个双向链接, 出站入站
//
// //将 msg 转成一个 ByteBuf
// //ByteBuf 是 Netty 提供的，不是 NIO 的 ByteBuffer.
// ByteBuf buf = (ByteBuf) msg;
// System.out.println("客户端发送消息是:" + buf.toString(CharsetUtil.UTF_8));
// System.out.println("客户端地址:" + channel.remoteAddress());
}
//数据读取完毕
@Override
public void channelReadComplete(ChannelHandlerContext ctx) throws Exception {
//writeAndFlush 是 write + flush
//将数据写入到缓存，并刷新
//一般讲，我们对这个发送的数据进行编码
ctx.writeAndFlush(Unpooled.copiedBuffer("hello, 客户端~(>^ω^<)喵1", CharsetUtil.UTF_8));
}
//处理异常, 一般是需要关闭通道
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
ctx.close();
}
}
```
### 5.8.8 方案再说明
1. `Netty` 抽象出两组线程池，`BossGroup` 专门负责接收客户端连接，`WorkerGroup` 专门负责网络读写操作。
2. `NioEventLoop` 表示一个不断循环执行处理任务的线程，每个 `NioEventLoop` 都有一个 `Selector`，用于监听绑定在其上的 `socket`网络通道。
3. `NioEventLoop` 内部采用串行化设计，从消息的 **读取->解码->处理->编码->发送**，始终由 `IO` 线程 `NioEventLoop` 负责
`NioEventLoopGroup` 下包含多个 `NioEventLoop`
- 每个 `NioEventLoop` 中包含有一个 `Selector`，一个 `taskQueue`
- 每个 `NioEventLoop` 的 `Selector` 上可以注册监听多个 `NioChannel`
- 每个 `NioChannel` 只会绑定在唯一的 `NioEventLoop` 上
- 每个 `NioChannel` 都绑定有一个自己的 `ChannelPipeline`
## 5.9 异步模型
### 5.9.1 基本介绍
1. 异步的概念和同步相对。当一个异步过程调用发出后，调用者不能立刻得到结果。实际处理这个调用的组件在完成后，通过状态、通知和回调来通知调用者。
2. `Netty` 中的 `I/O` 操作是异步的，包括 `Bind、Write、Connect` 等操作会简单的返回一个 `ChannelFuture`。
3. 调用者并不能立刻获得结果，而是通过 `Future-Listener` 机制，用户可以方便的主动获取或者通过通知机制获得 `IO` 操作结果。
4. `Netty` 的异步模型是建立在 `future` 和 `callback` 的之上的。`callback` 就是回调。重点说 `Future`，它的核心思想是：假设一个方法 `fun`，计算过程可能非常耗时，等待 `fun` 返回显然不合适。那么可以在调用 `fun` 的时候，立马返回一个 `Future`，后续可以通过 `Future` 去监控方法 `fun` 的处理过程（即：`Future-Listener` 机制）
### 5.9.2 Future 说明
1. 表示异步的执行结果,可以通过它提供的方法来检测执行是否完成，比如检索计算等等。
2. `ChannelFuture` 是一个接口：`public interface ChannelFuture extends Future<Void>` 我们可以添加监听器，当监听的事件发生时，就会通知到监听器。案例说明
### 5.9.3 工作原理示意图
说明：
1. 在使用 `Netty` 进行编程时，拦截操作和转换出入站数据只需要您提供 `callback` 或利用 `future` 即可。这使得链式操作简单、高效，并有利于编写可重用的、通用的代码。
2. `Netty` 框架的目标就是让你的业务逻辑从网络基础应用编码中分离出来、解脱出来。
### 5.9.4 Future-Listener 机制
1. 当 `Future` 对象刚刚创建时，处于非完成状态，调用者可以通过返回的 `ChannelFuture` 来获取操作执行的状态，注册监听函数来执行完成后的操作。
2. 常见有如下操作
- 通过 `isDone` 方法来判断当前操作是否完成；
- 通过 `isSuccess` 方法来判断已完成的当前操作是否成功；
- 通过 `getCause` 方法来获取已完成的当前操作失败的原因；
- 通过 `isCancelled` 方法来判断已完成的当前操作是否被取消；
- 通过 `addListener` 方法来注册监听器，当操作已完成（`isDone`方法返回完成），将会通知指定的监听器；如果 `Future` 对象已完成，则通知指定的监听器
举例说明
演示：绑定端口是异步操作，当绑定操作处理完，将会调用相应的监听器处理逻辑
```java
//绑定一个端口并且同步,生成了一个ChannelFuture对象
//启动服务器(并绑定端口)
ChannelFuture cf = bootstrap.bind(6668).sync();
//给cf注册监听器，监控我们关心的事件
cf.addListener(new ChannelFutureListener() {
@Override
public void operationComplete (ChannelFuture future) throws Exception {
if (cf.isSuccess()) {
System.out.println("监听端口6668成功");
} else {
System.out.println("监听端口6668失败");
}
}
});
```
## 5.10 快速入门实例 - HTTP服务
1. 实例要求：使用 `IDEA` 创建 `Netty` 项目
2. `Netty` 服务器在 `6668` 端口监听，浏览器发出请求 `http://localhost:6668/`
3. 服务器可以回复消息给客户端"Hello!我是服务器5",并对特定请求资源进行过滤。
4. 目的：`Netty` 可以做 `Http` 服务开发，并且理解 `Handler` 实例和客户端及其请求的关系。
5. 看老师代码演示
```java
TestServer.java
package com.atguigu.netty.http;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.nio.NioServerSocketChannel;
public class TestServer {
public static void main(String[] args) throws Exception {
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup();
try {
ServerBootstrap serverBootstrap = new ServerBootstrap();
serverBootstrap.group(bossGroup, workerGroup).channel(NioServerSocketChannel.class).childHandler(new TestServerInitializer());
ChannelFuture channelFuture = serverBootstrap.bind(6668).sync();
channelFuture.channel().closeFuture().sync();
} finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
TestServerInitializer.java
package com.atguigu.netty.http;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.socket.SocketChannel;
import io.netty.handler.codec.http.HttpServerCodec;
public class TestServerInitializer extends ChannelInitializer<SocketChannel> {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
//向管道加入处理器
//得到管道
ChannelPipeline pipeline = ch.pipeline();
//加入一个netty 提供的httpServerCodec codec =>[coder - decoder]
//HttpServerCodec 说明
//1. HttpServerCodec 是netty 提供的处理http的 编-解码器
pipeline.addLast("MyHttpServerCodec", new HttpServerCodec());
//2. 增加一个自定义的handler
pipeline.addLast("MyTestHttpServerHandler", new TestHttpServerHandler());
System.out.println("ok~~~~");
}
}
TestHttpServerHandler.java
package com.atguigu.netty.http;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import io.netty.handler.codec.http.*;
import io.netty.util.CharsetUtil;
import java.net.URI;
/**
* 说明
* 1. SimpleChannelInboundHandler 是 ChannelInboundHandlerAdapter
* 2. HttpObject 客户端和服务器端相互通讯的数据被封装成 HttpObject
*/
public class TestHttpServerHandler extends SimpleChannelInboundHandler<HttpObject> {
//channelRead0 读取客户端数据
@Override
protected void channelRead0(ChannelHandlerContext ctx, HttpObject msg) throws Exception {
System.out.println("对应的channel=" + ctx.channel() + " pipeline=" + ctx
.pipeline() + " 通过pipeline获取channel" + ctx.pipeline().channel());
System.out.println("当前ctx的handler=" + ctx.handler());
//判断 msg 是不是 httprequest请求
if (msg instanceof HttpRequest) {
System.out.println("ctx 类型=" + ctx.getClass());
System.out.println("pipeline hashcode" + ctx.pipeline().hashCode() + " TestHttpServerHandler hash=" + this.hashCode());
System.out.println("msg 类型=" + msg.getClass());
System.out.println("客户端地址" + ctx.channel().remoteAddress());
//获取到
HttpRequest httpRequest = (HttpRequest) msg;
//获取uri, 过滤指定的资源
URI uri = new URI(httpRequest.uri());
if ("/favicon.ico".equals(uri.getPath())) {
System.out.println("请求了 favicon.ico, 不做响应");
return;
}
//回复信息给浏览器 [http协议]
ByteBuf content = Unpooled.copiedBuffer("hello, 我是服务器", CharsetUtil.UTF_8);
//构造一个http的相应，即 httpresponse
FullHttpResponse response = new DefaultFullHttpResponse(HttpVersion.HTTP_1_1, HttpResponseStatus.OK, content);
response.headers().set(HttpHeaderNames.CONTENT_TYPE, "text/plain");
response.headers().set(HttpHeaderNames.CONTENT_LENGTH, content.readableBytes());
//将构建好 response返回
ctx.writeAndFlush(response);
}
}
}
```
================================================
FILE: docs/_content/chapter06.md
================================================
## 6.1 Bootstrap、ServerBootstrap
1. `Bootstrap` 意思是引导，一个 `Netty` 应用通常由一个 `Bootstrap` 开始，主要作用是配置整个 `Netty` 程序，串联各个组件，`Netty` 中 `Bootstrap` 类是客户端程序的启动引导类，`ServerBootstrap` 是服务端启动引导类。
2. 常见的方法有
- `public ServerBootstrap group(EventLoopGroup parentGroup, EventLoopGroup childGroup)`，该方法用于服务器端，用来设置两个 `EventLoop`
- `public B group(EventLoopGroup group)`，该方法用于客户端，用来设置一个 `EventLoop`
- `public B channel(Class<? extends C> channelClass)`，该方法用来设置一个服务器端的通道实现
- `public <T> B option(ChannelOption<T> option, T value)`，用来给 `ServerChannel` 添加配置
- `public <T> ServerBootstrap childOption(ChannelOption<T> childOption, T value)`，用来给接收到的通道添加配置
- `public ServerBootstrap childHandler(ChannelHandler childHandler)`，该方法用来设置业务处理类（自定义的`handler`）
- `public ChannelFuture bind(int inetPort)`，该方法用于服务器端，用来设置占用的端口号
- `public ChannelFuture connect(String inetHost, int inetPort)`，该方法用于客户端，用来连接服务器端
## 6.2 Future、ChannelFuture
`Netty` 中所有的 `IO` 操作都是异步的，不能立刻得知消息是否被正确处理。但是可以过一会等它执行完成或者直接注册一个监听，具体的实现就是通过 `Future` 和 `ChannelFutures`，他们可以注册一个监听，当操作执行成功或失败时监听会自动触发注册的监听事件
常见的方法有
- `Channel channel()`，返回当前正在进行 `IO` 操作的通道
- `ChannelFuture sync()`，等待异步操作执行完毕
## 6.3 Channel
1. `Netty` 网络通信的组件，能够用于执行网络 `I/O` 操作。
2. 通过 `Channel` 可获得当前网络连接的通道的状态
3. 通过 `Channel` 可获得网络连接的配置参数（例如接收缓冲区大小）
4. `Channel` 提供异步的网络 `I/O` 操作(如建立连接，读写，绑定端口)，异步调用意味着任何 `I/O` 调用都将立即返回，并且不保证在调用结束时所请求的 `I/O` 操作已完成
5. 调用立即返回一个 `ChannelFuture` 实例，通过注册监听器到 `ChannelFuture` 上，可以 `I/O` 操作成功、失败或取消时回调通知调用方
6. 支持关联 `I/O` 操作与对应的处理程序
7. 不同协议、不同的阻塞类型的连接都有不同的 `Channel` 类型与之对应，常用的 `Channel` 类型：
- `NioSocketChannel`，异步的客户端 `TCP` `Socket` 连接。
- `NioServerSocketChannel`，异步的服务器端 `TCP` `Socket` 连接。
- `NioDatagramChannel`，异步的 `UDP` 连接。
- `NioSctpChannel`，异步的客户端 `Sctp` 连接。
- `NioSctpServerChannel`，异步的 `Sctp` 服务器端连接，这些通道涵盖了 `UDP` 和 `TCP` 网络 `IO` 以及文件 `IO`。
## 6.4 Selector
1. `Netty` 基于 `Selector` 对象实现 `I/O` 多路复用，通过 `Selector` 一个线程可以监听多个连接的 `Channel` 事件。
2. 当向一个 `Selector` 中注册 `Channel` 后，`Selector` 内部的机制就可以自动不断地查询（`Select`）这些注册的 `Channel` 是否有已就绪的 `I/O` 事件（例如可读，可写，网络连接完成等），这样程序就可以很简单地使用一个线程高效地管理多个 `Channel`
## 6.5 ChannelHandler 及其实现类
1. `ChannelHandler` 是一个接口，处理 `I/O` 事件或拦截 `I/O` 操作，并将其转发到其 `ChannelPipeline`（业务处理链）中的下一个处理程序。
2. `ChannelHandler` 本身并没有提供很多方法，因为这个接口有许多的方法需要实现，方便使用期间，可以继承它的子类
3. `ChannelHandler` 及其实现类一览图（后）
4. 我们经常需要自定义一个 `Handler` 类去继承 `ChannelInboundHandlerAdapter`，然后通过重写相应方法实现业务逻辑，我们接下来看看一般都需要重写哪些方法
## 6.6 Pipeline 和 ChannelPipeline
`ChannelPipeline` 是一个重点：
1. `ChannelPipeline` 是一个 `Handler` 的集合，它负责处理和拦截 `inbound` 或者 `outbound` 的事件和操作，相当于一个贯穿 `Netty` 的链。（也可以这样理解：`ChannelPipeline` 是保存 `ChannelHandler` 的 `List`，用于处理或拦截 `Channel` 的入站事件和出站操作）
2. `ChannelPipeline` 实现了一种高级形式的拦截过滤器模式，使用户可以完全控制事件的处理方式，以及 `Channel` 中各个的 `ChannelHandler` 如何相互交互
3. 在 `Netty` 中每个 `Channel` 都有且仅有一个 `ChannelPipeline` 与之对应，它们的组成关系如下
4. 常用方法
`ChannelPipeline addFirst(ChannelHandler... handlers)`，把一个业务处理类（`handler`）添加到链中的第一个位置`ChannelPipeline addLast(ChannelHandler... handlers)`，把一个业务处理类（`handler`）添加到链中的最后一个位置
## 6.7 ChannelHandlerContext
1. 保存 `Channel` 相关的所有上下文信息，同时关联一个 `ChannelHandler` 对象
2. 即 `ChannelHandlerContext` 中包含一个具体的事件处理器 `ChannelHandler`，同时 `ChannelHandlerContext` 中也绑定了对应的 `pipeline` 和 `Channel` 的信息，方便对 `ChannelHandler` 进行调用。
3. 常用方法
- `ChannelFuture close()`，关闭通道
- `ChannelOutboundInvoker flush()`，刷新
- `ChannelFuture writeAndFlush(Object msg)`，将数据写到
- `ChannelPipeline` 中当前 `ChannelHandler` 的下一个 `ChannelHandler` 开始处理（出站）
## 6.8 ChannelOption
1. `Netty` 在创建 `Channel` 实例后，一般都需要设置 `ChannelOption` 参数。
2. `ChannelOption` 参数如下：
## 6.9 EventLoopGroup 和其实现类 NioEventLoopGroup
1. `EventLoopGroup` 是一组 `EventLoop` 的抽象，`Netty` 为了更好的利用多核 `CPU` 资源，一般会有多个 `EventLoop` 同时工作，每个 `EventLoop` 维护着一个 `Selector` 实例。
2. `EventLoopGroup` 提供 `next` 接口，可以从组里面按照一定规则获取其中一个 `EventLoop` 来处理任务。在 `Netty` 服务器端编程中，我们一般都需要提供两个 `EventLoopGroup`，例如：`BossEventLoopGroup` 和 `WorkerEventLoopGroup`。
3. 通常一个服务端口即一个 `ServerSocketChannel` 对应一个 `Selector` 和一个 `EventLoop` 线程。`BossEventLoop` 负责接收客户端的连接并将 `SocketChannel` 交给 `WorkerEventLoopGroup` 来进行 `IO` 处理，如下图所示
4. 常用方法
`public NioEventLoopGroup()`，构造方法
`public Future<?> shutdownGracefully()`，断开连接，关闭线程
## 6.10 Unpooled 类
1. `Netty` 提供一个专门用来操作缓冲区（即 `Netty` 的数据容器）的工具类
2. 常用方法如下所示
3. 举例说明 `Unpooled` 获取 `Netty` 的数据容器 `ByteBuf` 的基本使用【案例演示】
案例 1
```java
package com.atguigu.netty.buf;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
public class NettyByteBuf01 {
public static void main(String[] args) {
//创建一个ByteBuf
//说明
//1. 创建 对象，该对象包含一个数组arr , 是一个byte[10]
//2. 在netty 的buffer中，不需要使用flip 进行反转
// 底层维护了 readerindex 和 writerIndex
//3. 通过 readerindex 和 writerIndex 和 capacity， 将buffer分成三个区域
// 0---readerindex 已经读取的区域
// readerindex---writerIndex ， 可读的区域
// writerIndex -- capacity, 可写的区域
ByteBuf buffer = Unpooled.buffer(10);
for (int i = 0; i < 10; i++) {
buffer.writeByte(i);
}
System.out.println("capacity=" + buffer.capacity());//10
//输出
// for(int i = 0; i<buffer.capacity(); i++) {
// System.out.println(buffer.getByte(i));
// }
for (int i = 0; i < buffer.capacity(); i++) {
System.out.println(buffer.readByte());
}
System.out.println("执行完毕");
}
}
```
案例 2
```java
package com.atguigu.netty.buf;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import java.nio.charset.Charset;
public class NettyByteBuf02 {
public static void main(String[] args) {
//创建ByteBuf
ByteBuf byteBuf = Unpooled.copiedBuffer("hello,world!", Charset.forName("utf-8"));
//使用相关的方法
if (byteBuf.hasArray()) { // true
byte[] content = byteBuf.array();
//将 content 转成字符串
System.out.println(new String(content, Charset.forName("utf-8")));
System.out.println("byteBuf=" + byteBuf);
System.out.println(byteBuf.arrayOffset()); // 0
System.out.println(byteBuf.readerIndex()); // 0
System.out.println(byteBuf.writerIndex()); // 12
System.out.println(byteBuf.capacity()); // 36
//System.out.println(byteBuf.readByte()); //
System.out.println(byteBuf.getByte(0)); // 104
int len = byteBuf.readableBytes(); //可读的字节数 12
System.out.println("len=" + len);
//使用for取出各个字节
for (int i = 0; i < len; i++) {
System.out.println((char) byteBuf.getByte(i));
}
//按照某个范围读取
System.out.println(byteBuf.getCharSequence(0, 4, Charset.forName("utf-8")));
System.out.println(byteBuf.getCharSequence(4, 6, Charset.forName("utf-8")));
}
}
}
```
## 6.11 Netty 应用实例-群聊系统
实例要求：
1. 编写一个 `Netty` 群聊系统，实现服务器端和客户端之间的数据简单通讯（非阻塞）
2. 实现多人群聊
3. 服务器端：可以监测用户上线，离线，并实现消息转发功能
4. 客户端：通过 `channel` 可以无阻塞发送消息给其它所有用户，同时可以接受其它用户发送的消息（有服务器转发得到）
5. 目的：进一步理解 `Netty` 非阻塞网络编程机制
6. 看老师代码演示
代码如下：
```java
package com.atguigu.netty.groupchat;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.*;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.codec.string.StringDecoder;
import io.netty.handler.codec.string.StringEncoder;
public class GroupChatServer {
private int port; //监听端口
public GroupChatServer(int port) {
this.port = port;
}
//编写run方法，处理客户端的请求
public void run() throws Exception {
//创建两个线程组
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup(); //8个NioEventLoop
try {
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.option(ChannelOption.SO_BACKLOG, 128)
.childOption(ChannelOption.SO_KEEPALIVE, true)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
//获取到pipeline
ChannelPipeline pipeline = ch.pipeline();
//向pipeline加入解码器
pipeline.addLast("decoder", new StringDecoder());
//向pipeline加入编码器
pipeline.addLast("encoder", new StringEncoder());
//加入自己的业务处理handler
pipeline.addLast(new GroupChatServerHandler());
}
});
System.out.println("netty 服务器启动");
ChannelFuture channelFuture = b.bind(port).sync();
//监听关闭
channelFuture.channel().closeFuture().sync();
} finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
public static void main(String[] args) throws Exception {
new GroupChatServer(7000).run();
}
}
package com.atguigu.netty.groupchat;
import io.netty.channel.Channel;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import io.netty.channel.group.ChannelGroup;
import io.netty.channel.group.DefaultChannelGroup;
import io.netty.util.concurrent.GlobalEventExecutor;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class GroupChatServerHandler extends SimpleChannelInboundHandler<String> {
//public static List<Channel> channels = new ArrayList<Channel>();
//使用一个hashmap 管理
//public static Map<String, Channel> channels = new HashMap<String,Channel>();
//定义一个channle 组，管理所有的channel
//GlobalEventExecutor.INSTANCE) 是全局的事件执行器，是一个单例
private static ChannelGroup channelGroup = new DefaultChannelGroup(GlobalEventExecutor.INSTANCE);
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
//handlerAdded 表示连接建立，一旦连接，第一个被执行
//将当前channel 加入到 channelGroup
@Override
public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
Channel channel = ctx.channel();
//将该客户加入聊天的信息推送给其它在线的客户端
/*
该方法会将 channelGroup 中所有的channel 遍历，并发送 消息，
我们不需要自己遍历
*/
channelGroup.writeAndFlush("[客户端]" + channel.remoteAddress() + " 加入聊天" + sdf.format(new java.util.Date()) + " \n");
channelGroup.add(channel);
}
//断开连接, 将xx客户离开信息推送给当前在线的客户
@Override
public void handlerRemoved(ChannelHandlerContext ctx) throws Exception {
Channel channel = ctx.channel();
channelGroup.writeAndFlush("[客户端]" + channel.remoteAddress() + " 离开了\n");
System.out.println("channelGroup size" + channelGroup.size());
}
//表示channel 处于活动状态, 提示 xx上线
@Override
public void channelActive(ChannelHandlerContext ctx) throws Exception {
System.out.println(ctx.channel().remoteAddress() + " 上线了~");
}
//表示channel 处于不活动状态, 提示 xx离线了
@Override
public void channelInactive(ChannelHandlerContext ctx) throws Exception {
System.out.println(ctx.channel().remoteAddress() + " 离线了~");
}
//读取数据
@Override
protected void channelRead0(ChannelHandlerContext ctx, String msg) throws Exception {
//获取到当前channel
Channel channel = ctx.channel();
//这时我们遍历channelGroup, 根据不同的情况，回送不同的消息
channelGroup.forEach(ch -> {
if (channel != ch) { //不是当前的channel,转发消息
ch.writeAndFlush("[客户]" + channel.remoteAddress() + " 发送了消息" + msg + "\n");
} else {//回显自己发送的消息给自己
ch.writeAndFlush("[自己]发送了消息" + msg + "\n");
}
});
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
//关闭通道
ctx.close();
}
}
package com.atguigu.netty.groupchat;
import io.netty.bootstrap.Bootstrap;
import io.netty.channel.*;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioSocketChannel;
import io.netty.handler.codec.string.StringDecoder;
import io.netty.handler.codec.string.StringEncoder;
import java.util.Scanner;
public class GroupChatClient {
//属性
private final String host;
private final int port;
public GroupChatClient(String host, int port) {
this.host = host;
this.port = port;
}
public void run() throws Exception {
EventLoopGroup group = new NioEventLoopGroup();
try {
Bootstrap bootstrap = new Bootstrap()
.group(group)
.channel(NioSocketChannel.class)
.handler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
//得到pipeline
ChannelPipeline pipeline = ch.pipeline();
//加入相关handler
pipeline.addLast("decoder", new StringDecoder());
pipeline.addLast("encoder", new StringEncoder());
//加入自定义的handler
pipeline.addLast(new GroupChatClientHandler());
}
});
ChannelFuture channelFuture = bootstrap.connect(host, port).sync();
//得到channel
Channel channel = channelFuture.channel();
System.out.println("-------" + channel.localAddress() + "--------");
//客户端需要输入信息，创建一个扫描器
Scanner scanner = new Scanner(System.in);
while (scanner.hasNextLine()) {
String msg = scanner.nextLine();
//通过channel 发送到服务器端
channel.writeAndFlush(msg + "\r\n");
}
} finally {
group.shutdownGracefully();
}
}
public static void main(String[] args) throws Exception {
new GroupChatClient("127.0.0.1", 7000).run();
}
}
package com.atguigu.netty.groupchat;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
public class GroupChatClientHandler extends SimpleChannelInboundHandler<String> {
@Override
protected void channelRead0(ChannelHandlerContext ctx, String msg) throws Exception {
System.out.println(msg.trim());
}
}
```
## 6.12 Netty 心跳检测机制案例
实例要求：
1. 编写一个 `Netty` 心跳检测机制案例,当服务器超过 `3` 秒没有读时，就提示读空闲
2. 当服务器超过 `5` 秒没有写操作时，就提示写空闲
3. 实现当服务器超过 `7` 秒没有读或者写操作时，就提示读写空闲
4. 代码如下：
```java
package com.atguigu.netty.heartbeat;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.logging.LogLevel;
import io.netty.handler.logging.LoggingHandler;
import io.netty.handler.timeout.IdleStateHandler;
import java.util.concurrent.TimeUnit;
public class MyServer {
public static void main(String[] args) throws Exception {
//创建两个线程组
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup(); //8个NioEventLoop
try {
ServerBootstrap serverBootstrap = new ServerBootstrap();
serverBootstrap.group(bossGroup, workerGroup);
serverBootstrap.channel(NioServerSocketChannel.class);
serverBootstrap.handler(new LoggingHandler(LogLevel.INFO));
serverBootstrap.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline pipeline = ch.pipeline();
//加入一个netty 提供 IdleStateHandler
/*
说明
1. IdleStateHandler 是netty 提供的处理空闲状态的处理器
2. long readerIdleTime : 表示多长时间没有读, 就会发送一个心跳检测包检测是否连接
3. long writerIdleTime : 表示多长时间没有写, 就会发送一个心跳检测包检测是否连接
4. long allIdleTime : 表示多长时间没有读写, 就会发送一个心跳检测包检测是否连接
5. 文档说明
triggers an {@link IdleStateEvent} when a {@link Channel} has not performed
* read, write, or both operation for a while.
* 6. 当 IdleStateEvent 触发后 , 就会传递给管道 的下一个handler去处理
* 通过调用(触发)下一个handler 的 userEventTiggered , 在该方法中去处理 IdleStateEvent(读空闲，写空闲，读写空闲)
*/
pipeline.addLast(new IdleStateHandler(7000, 7000, 10, TimeUnit.SECONDS));
//加入一个对空闲检测进一步处理的handler(自定义)
pipeline.addLast(new MyServerHandler());
}
});
//启动服务器
ChannelFuture channelFuture = serverBootstrap.bind(7000).sync();
channelFuture.channel().closeFuture().sync();
} finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
package com.atguigu.netty.heartbeat;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
import io.netty.handler.timeout.IdleStateEvent;
public class MyServerHandler extends ChannelInboundHandlerAdapter {
/**
* @param ctx 上下文
* @param evt 事件
* @throws Exception
*/
@Override
public void userEventTriggered(ChannelHandlerContext ctx, Object evt) throws Exception {
if (evt instanceof IdleStateEvent) {
//将 evt 向下转型 IdleStateEvent
IdleStateEvent event = (IdleStateEvent) evt;
String eventType = null;
switch (event.state()) {
case READER_IDLE:
eventType = "读空闲";
break;
case WRITER_IDLE:
eventType = "写空闲";
break;
case ALL_IDLE:
eventType = "读写空闲";
break;
}
System.out.println(ctx.channel().remoteAddress() + "--超时时间--" + eventType);
System.out.println("服务器做相应处理..");
//如果发生空闲，我们关闭通道
// ctx.channel().close();
}
}
}
```
## 6.13 Netty 通过 WebSocket 编程实现服务器和客户端长连接
实例要求：
1. `Http` 协议是无状态的，浏览器和服务器间的请求响应一次，下一次会重新创建连接。
2. 要求：实现基于 `WebSocket` 的长连接的全双工的交互
3. 改变 `Http` 协议多次请求的约束，实现长连接了，服务器可以发送消息给浏览器
4. 客户端浏览器和服务器端会相互感知，比如服务器关闭了，浏览器会感知，同样浏览器关闭了，服务器会感知
5. 运行界面
```java
package com.atguigu.netty.websocket;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.codec.http.HttpObjectAggregator;
import io.netty.handler.codec.http.HttpServerCodec;
import io.netty.handler.codec.http.websocketx.WebSocketServerProtocolHandler;
import io.netty.handler.logging.LogLevel;
import io.netty.handler.logging.LoggingHandler;
import io.netty.handler.stream.ChunkedWriteHandler;
public class MyServer {
public static void main(String[] args) throws Exception {
//创建两个线程组
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup(); //8个NioEventLoop
try {
ServerBootstrap serverBootstrap = new ServerBootstrap();
serverBootstrap.group(bossGroup, workerGroup);
serverBootstrap.channel(NioServerSocketChannel.class);
serverBootstrap.handler(new LoggingHandler(LogLevel.INFO));
serverBootstrap.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline pipeline = ch.pipeline();
//因为基于http协议，使用http的编码和解码器
pipeline.addLast(new HttpServerCodec());
//是以块方式写，添加ChunkedWriteHandler处理器
pipeline.addLast(new ChunkedWriteHandler());
/*
说明
1. http数据在传输过程中是分段, HttpObjectAggregator ，就是可以将多个段聚合
2. 这就就是为什么，当浏览器发送大量数据时，就会发出多次http请求
*/
pipeline.addLast(new HttpObjectAggregator(8192));
/*
说明
1. 对应websocket ，它的数据是以 帧(frame) 形式传递
2. 可以看到WebSocketFrame 下面有六个子类
3. 浏览器请求时 ws://localhost:7000/hello 表示请求的uri
4. WebSocketServerProtocolHandler 核心功能是将 http协议升级为 ws协议 , 保持长连接
5. 是通过一个 状态码 101
*/
pipeline.addLast(new WebSocketServerProtocolHandler("/hello2"));
//自定义的handler ，处理业务逻辑
pipeline.addLast(new MyTextWebSocketFrameHandler());
}
});
//启动服务器
ChannelFuture channelFuture = serverBootstrap.bind(7000).sync();
channelFuture.channel().closeFuture().sync();
} finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
package com.atguigu.netty.websocket;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import io.netty.handler.codec.http.websocketx.TextWebSocketFrame;
import java.time.LocalDateTime;
//这里 TextWebSocketFrame 类型，表示一个文本帧(frame)
public class MyTextWebSocketFrameHandler extends SimpleChannelInboundHandler<TextWebSocketFrame> {
@Override
protected void channelRead0(ChannelHandlerContext ctx, TextWebSocketFrame msg) throws Exception {
System.out.println("服务器收到消息 " + msg.text());
//回复消息
ctx.channel().writeAndFlush(new TextWebSocketFrame("服务器时间" + LocalDateTime.now() + " " + msg.text()));
}
//当web客户端连接后， 触发方法
@Override
public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
//id 表示唯一的值，LongText 是唯一的 ShortText 不是唯一
System.out.println("handlerAdded 被调用" + ctx.channel().id().asLongText());
System.out.println("handlerAdded 被调用" + ctx.channel().id().asShortText());
}
@Override
public void handlerRemoved(ChannelHandlerContext ctx) throws Exception {
System.out.println("handlerRemoved 被调用" + ctx.channel().id().asLongText());
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
System.out.println("异常发生 " + cause.getMessage());
ctx.close(); //关闭连接
}
}
hello.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<script>
var socket;
//判断当前浏览器是否支持websocket
if(window.WebSocket) {
//go on
socket = new WebSocket("ws://localhost:7000/hello2");
//相当于channelReado, ev 收到服务器端回送的消息
socket.onmessage = function (ev) {
var rt = document.getElementById("responseText");
rt.value = rt.value + "\n" + ev.data;
}
//相当于连接开启(感知到连接开启)
socket.onopen = function (ev) {
var rt = document.getElementById("responseText");
rt.value = "连接开启了.."
}
//相当于连接关闭(感知到连接关闭)
socket.onclose = function (ev) {
var rt = document.getElementById("responseText");
rt.value = rt.value + "\n" + "连接关闭了.."
}
} else {
alert("当前浏览器不支持websocket")
}
//发送消息到服务器
function send(message) {
if(!window.socket) { //先判断socket是否创建好
return;
}
if(socket.readyState == WebSocket.OPEN) {
//通过socket 发送消息
socket.send(message)
} else {
alert("连接没有开启");
}
}
</script>
<form onsubmit="return false">
<textarea name="message" style="height: 300px; width: 300px"></textarea>
<input type="button" value="发生消息" onclick="send(this.form.message.value)">
<textarea id="responseText" style="height: 300px; width: 300px"></textarea>
<input type="button" value="清空内容" onclick="document.getElementById('responseText').value=''">
</form>
</body>
</html>
```
================================================
FILE: docs/_content/chapter07.md
================================================
## 7.1 编码和解码的基本介绍
1. 编写网络应用程序时，因为数据在网络中传输的都是二进制字节码数据，在发送数据时就需要编码，接收数据时就需要解码[示意图]
2. `codec`（编解码器）的组成部分有两个：`decoder`（解码器）和 `encoder`（编码器）。`encoder` 负责把业务数据转换成字节码数据，`decoder` 负责把字节码数据转换成业务数据
## 7.2 Netty 本身的编码解码的机制和问题分析
1. `Netty` 自身提供了一些 `codec`(编解码器)
2. `Netty` 提供的编码器 `StringEncoder`，对字符串数据进行编码 `ObjectEncoder`，对Java对象进行编码...
3. `Netty` 提供的解码器 `StringDecoder`,对字符串数据进行解码 `ObjectDecoder`，对 `Java` 对象进行解码...
4. `Netty` 本身自带的 `ObjectDecoder` 和 `ObjectEncoder` 可以用来实现 `POJO` 对象或各种业务对象的编码和解码，底层使用的仍是Java序列化技术,而Java序列化技术本身效率就不高，存在如下问题
- 无法跨语言
- 序列化后的体积太大，是二进制编码的5倍多。
- 序列化性能太低
5. =>引出新的解决方案[`Google` 的 `Protobuf`]
## 7.3 Protobuf
1. `Protobuf` 基本介绍和使用示意图
2. `Protobuf` 是 `Google` 发布的开源项目，全称 `Google Protocol Buffers`，是一种轻便高效的结构化数据存储格式，可以用于结构化数据串行化，或者说序列化。它很适合做数据存储或 `RPC` [远程过程调用 `remote procedure call` ]数据交换格式。目前很多公司 `http + json tcp + protobuf`
3. 参考文档：https://developers.google.com/protocol-buffers/docs/proto 语言指南
4. `Protobuf` 是以 `message` 的方式来管理数据的.
5. 支持跨平台、跨语言，即[客户端和服务器端可以是不同的语言编写的]（支持目前绝大多数语言，例如 `C++`、`C#`、`Java`、`python` 等）
6. 高性能，高可靠性
7. 使用 `protobuf` 编译器能自动生成代码，`Protobuf` 是将类的定义使用 `.proto` 文件进行描述。说明，在 `idea` 中编写 `.proto` 文件时，会自动提示是否下载 `.ptoto` 编写插件.可以让语法高亮。
8. 然后通过 `protoc.exe` 编译器根据 `.proto` 自动生成 `.java` 文件
9. `protobuf` 使用示意图
## 7.4 Protobuf 快速入门实例
编写程序，使用 `Protobuf` 完成如下功能
1. 客户端可以发送一个 `StudentPoJo` 对象到服务器(通过 `Protobuf` 编码)
2. 服务端能接收 `StudentPoJo` 对象，并显示信息(通过 `Protobuf` 解码)
3. 具体看老师演示步骤
```java
Student.proto
syntax = "proto3"; //版本
option java_outer_classname = "StudentPOJO";//生成的外部类名，同时也是文件名
//protobuf 使用message 管理数据
message Student { //会在 StudentPOJO 外部类生成一个内部类 Student， 他是真正发送的POJO对象
int32 id = 1; // Student 类中有 一个属性 名字为 id 类型为int32(protobuf类型) 1表示属性序号，不是值
string name = 2;
}
编译
protoc.exe--java_out=.Student.proto
将生成的 StudentPOJO 放入到项目使用
```
## 7.5 Protobuf 快速入门实例 2
1. 编写程序，使用 `Protobuf` 完成如下功能
2. 客户端可以随机发送 `StudentPoJo` / `WorkerPoJo` 对象到服务器(通过 `Protobuf` 编码)
3. 服务端能接收 `StudentPoJo` / `WorkerPoJo` 对象(需要判断是哪种类型)，并显示信息(通过 `Protobuf` 解码)
4. 具体看老师演示步骤
```java
Student.proto
syntax = "proto3";
option optimize_for = SPEED; // 加快解析
option java_package="com.atguigu.netty.codec2"; //指定生成到哪个包下
option java_outer_classname="MyDataInfo"; // 外部类名, 文件名
//protobuf 可以使用message 管理其他的message
message MyMessage {
//定义一个枚举类型
enum DataType {
StudentType = 0; //在proto3 要求enum的编号从0开始
WorkerType = 1;
}
//用data_type 来标识传的是哪一个枚举类型
DataType data_type = 1;
//表示每次枚举类型最多只能出现其中的一个, 节省空间
oneof dataBody {
Student student = 2;
Worker worker = 3;
}
}
message Student {
int32 id = 1;//Student类的属性
string name = 2; //
}
message Worker {
string name=1;
int32 age=2;
}
```
================================================
FILE: docs/_content/chapter08.md
================================================
## 8.1 基本说明
1. `Netty` 的组件设计：`Netty` 的主要组件有 `Channel`、`EventLoop`、`ChannelFuture`、`ChannelHandler`、`ChannelPipe` 等
2. `ChannelHandler` 充当了处理入站和出站数据的应用程序逻辑的容器。例如，实现 `ChannelInboundHandler` 接口（或 `ChannelInboundHandlerAdapter`），你就可以接收入站事件和数据，这些数据会被业务逻辑处理。当要给客户端发送响应时，也可以从 `ChannelInboundHandler` 冲刷数据。业务逻辑通常写在一个或者多个 `ChannelInboundHandler` 中。`ChannelOutboundHandler` 原理一样，只不过它是用来处理出站数据的
3. `ChannelPipeline` 提供了 `ChannelHandler` 链的容器。以客户端应用程序为例，如果事件的运动方向是从客户端到服务端的，那么我们称这些事件为出站的，即客户端发送给服务端的数据会通过 `pipeline` 中的一系列 `ChannelOutboundHandler`，并被这些 `Handler` 处理，反之则称为入站的
## 8.2编码解码器
1. 当 `Netty` 发送或者接受一个消息的时候，就将会发生一次数据转换。入站消息会被解码：从字节转换为另一种格式（比如 `java` 对象）；如果是出站消息，它会被编码成字节。
2. `Netty` 提供一系列实用的编解码器，他们都实现了 `ChannelInboundHadnler` 或者 `ChannelOutboundHandler` 接口。在这些类中，`channelRead` 方法已经被重写了。以入站为例，对于每个从入站 `Channel` 读取的消息，这个方法会被调用。随后，它将调用由解码器所提供的 `decode()` 方法进行解码，并将已经解码的字节转发给 `ChannelPipeline` 中的下一个 `ChannelInboundHandler`。
## 8.3 解码器 - ByteToMessageDecoder
1. 关系继承图
2. 由于不可能知道远程节点是否会一次性发送一个完整的信息，`tcp` 有可能出现粘包拆包的问题，这个类会对入站数据进行缓冲，直到它准备好被处理.
3. 一个关于 `ByteToMessageDecoder` 实例分析
## 8.4 Netty 的 handler 链的调用机制
实例要求:
1. 使用自定义的编码器和解码器来说明 `Netty` 的 `handler` 调用机制
客户端发送 `long` -> 服务器
服务端发送 `long` -> 客户端
2. 案例演示
3. 结论
- 不论解码器 `handler` 还是编码器 `handler` 即接收的消息类型必须与待处理的消息类型一致，否则该 `handler` 不会被执行
- 在解码器进行数据解码时，需要判断缓存区（`ByteBuf`）的数据是否足够，否则接收到的结果会期望结果可能不一致
## 8.5 解码器 - ReplayingDecoder
1. `public abstract class ReplayingDecoder<S> extends ByteToMessageDecoder`
2. `ReplayingDecoder` 扩展了 `ByteToMessageDecoder` 类，使用这个类，我们不必调用 `readableBytes()` 方法。参数 `S` 指定了用户状态管理的类型，其中 `Void` 代表不需要状态管理
3. 应用实例：使用 `ReplayingDecoder` 编写解码器，对前面的案例进行简化[案例演示]
```java
package com.atguigu.netty.inboundhandlerandoutboundhandler;
import io.netty.buffer.ByteBuf;
import io.netty.channel.ChannelHandlerContext;
import io.netty.handler.codec.ReplayingDecoder;
import java.util.List;
public class MyByteToLongDecoder2 extends ReplayingDecoder<Void> {
@Override
protected void decode(ChannelHandlerContext ctx, ByteBuf in, List<Object> out) throws Exception {
System.out.println("MyByteToLongDecoder2 被调用");
//在 ReplayingDecoder 不需要判断数据是否足够读取，内部会进行处理判断
out.add(in.readLong());
}
}
```
4. `ReplayingDecoder` 使用方便，但它也有一些局限性：
- 并不是所有的 `ByteBuf` 操作都被支持，如果调用了一个不被支持的方法，将会抛出一个 `UnsupportedOperationException`。
- `ReplayingDecoder` 在某些情况下可能稍慢于 `ByteToMessageDecoder`，例如网络缓慢并且消息格式复杂时，消息会被拆成了多个碎片，速度变慢
## 8.6 其它编解码器
### 8.6.1 其它解码器
1. `LineBasedFrameDecoder`：这个类在 `Netty` 内部也有使用，它使用行尾控制字符（\n或者\r\n）作为分隔符来解析数据。
2. `DelimiterBasedFrameDecoder`：使用自定义的特殊字符作为消息的分隔符。
3. `HttpObjectDecoder`：一个 `HTTP` 数据的解码器
4. `LengthFieldBasedFrameDecoder`：通过指定长度来标识整包消息，这样就可以自动的处理黏包和半包消息。
### 8.6.2 其它编码器
## 8.7 Log4j 整合到 Netty
1. 在 `Maven` 中添加对 `Log4j` 的依赖在 `pom.xml`
```xml
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.25</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.25</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
<version>1.7.25</version>
<scope>test</scope>
</dependency>
```
2. 配置 `Log4j`，在 `resources/log4j.properties`
```xml
log4j.rootLogger=DEBUG,stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[%p]%C{1}-%m%n
```
3. 演示整合
================================================
FILE: docs/_content/chapter09.md
================================================
## 9.1 TCP 粘包和拆包基本介绍
1. `TCP` 是面向连接的，面向流的，提供高可靠性服务。收发两端（客户端和服务器端）都要有一一成对的 `socket`，因此，发送端为了将多个发给接收端的包，更有效的发给对方，使用了优化方法（`Nagle` 算法），将多次间隔较小且数据量小的数据，合并成一个大的数据块，然后进行封包。这样做虽然提高了效率，但是接收端就难于分辨出完整的数据包了，因为面向流的通信是无消息保护边界的
2. 由于 `TCP` 无消息保护边界,需要在接收端处理消息边界问题，也就是我们所说的粘包、拆包问题,看一张图
3. 示意图 `TCP` 粘包、拆包图解
对图的说明:
假设客户端分别发送了两个数据包 `D1` 和 `D2` 给服务端，由于服务端一次读取到字节数是不确定的，故可能存在以下四种情况：
1. 服务端分两次读取到了两个独立的数据包，分别是 `D1` 和 `D2`，没有粘包和拆包
2. 服务端一次接受到了两个数据包，`D1` 和 `D2` 粘合在一起，称之为 `TCP` 粘包
3. 服务端分两次读取到了数据包，第一次读取到了完整的 `D1` 包和 `D2` 包的部分内容，第二次读取到了 `D2` 包的剩余内容，这称之为 `TCP` 拆包
4. 服务端分两次读取到了数据包，第一次读取到了 `D1` 包的部分内容 `D1_1`，第二次读取到了 `D1` 包的剩余部分内容 `D1_2` 和完整的 `D2` 包。
## 9.2 TCP 粘包和拆包现象实例
在编写 `Netty` 程序时，如果没有做处理，就会发生粘包和拆包的问题
看一个具体的实例：
```java
// 核心代码
MyClientHandler.java
package com.atguigu.netty.tcp;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import java.nio.charset.Charset;
public class MyClientHandler extends SimpleChannelInboundHandler<ByteBuf> {
private int count;
@Override
public void channelActive(ChannelHandlerContext ctx) throws Exception {
//使用客户端发送10条数据 hello,server 编号
for (int i = 0; i < 10; ++i) {
ByteBuf buffer = Unpooled.copiedBuffer("hello,server " + i, Charset.forName("utf-8"));
ctx.writeAndFlush(buffer);
}
}
@Override
protected void channelRead0(ChannelHandlerContext ctx, ByteBuf msg) throws Exception {
byte[] buffer = new byte[msg.readableBytes()];
msg.readBytes(buffer);
String message = new String(buffer, Charset.forName("utf-8"));
System.out.println("客户端接收到消息=" + message);
System.out.println("客户端接收消息数量=" + (++this.count));
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
cause.printStackTrace();
ctx.close();
}
}
MyServerHandler.java
package com.atguigu.netty.tcp;
import io.netty.buffer.ByteBuf;
import io.netty.buffer.Unpooled;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import java.nio.charset.Charset;
import java.util.UUID;
public class MyServerHandler extends SimpleChannelInboundHandler<ByteBuf> {
private int count;
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
//cause.printStackTrace();
ctx.close();
}
@Override
protected void channelRead0(ChannelHandlerContext ctx, ByteBuf msg) throws Exception {
byte[] buffer = new byte[msg.readableBytes()];
msg.readBytes(buffer);
//将buffer转成字符串
String message = new String(buffer, Charset.forName("utf-8"));
System.out.println("服务器接收到数据 " + message);
System.out.println("服务器接收到消息量=" + (++this.count));
//服务器回送数据给客户端, 回送一个随机id ,
ByteBuf responseByteBuf = Unpooled.copiedBuffer(UUID.randomUUID().toString() + " ", Charset.forName("utf-8"));
ctx.writeAndFlush(responseByteBuf);
}
}
```
## 9.3 TCP 粘包和拆包解决方案
1. 使用自定义协议+编解码器来解决
2. 关键就是要解决服务器端每次读取数据长度的问题，这个问题解决，就不会出现服务器多读或少读数据的问题，从而避免的 `TCP` 粘包、拆包。
## 9.4 看一个具体的实例
1. 要求客户端发送 `5` 个 `Message` 对象，客户端每次发送一个 `Message` 对象
2. 服务器端每次接收一个 `Message`，分 `5` 次进行解码，每读取到一个 `Message`，会回复一个 `Message` 对象给客户端。
3. 代码演示，全部代码核心
```java
// 核心
package com.atguigu.netty.protocoltcp;
//协议包
public class MessageProtocol {
private int len; //关键
private byte[] content;
public int getLen() {
return len;
}
public void setLen(int len) {
this.len = len;
}
public byte[] getContent() {
return content;
}
public void setContent(byte[] content) {
this.content = content;
}
}
package com.atguigu.netty.protocoltcp;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import java.nio.charset.Charset;
public class MyClientHandler extends SimpleChannelInboundHandler<MessageProtocol> {
private int count;
@Override
public void channelActive(ChannelHandlerContext ctx) throws Exception {
//使用客户端发送10条数据 "今天天气冷，吃火锅" 编号
for (int i = 0; i < 5; i++) {
String mes = "今天天气冷，吃火锅";
byte[] content = mes.getBytes(Charset.forName("utf-8"));
int length = mes.getBytes(Charset.forName("utf-8")).length;
//创建协议包对象
MessageProtocol messageProtocol = new MessageProtocol();
messageProtocol.setLen(length);
messageProtocol.setContent(content);
ctx.writeAndFlush(messageProtocol);
}
}
// @Override
protected void channelRead0(ChannelHandlerContext ctx, MessageProtocol msg) throws Exception {
int len = msg.getLen();
byte[] content = msg.getContent();
System.out.println("客户端接收到消息如下");
System.out.println("长度=" + len);
System.out.println("内容=" + new String(content, Charset.forName("utf-8")));
System.out.println("客户端接收消息数量=" + (++this.count));
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
System.out.println("异常消息=" + cause.getMessage());
ctx.close();
}
}
package com.atguigu.netty.protocoltcp;
import io.netty.buffer.ByteBuf;
import io.netty.channel.ChannelHandlerContext;
import io.netty.handler.codec.MessageToByteEncoder;
public class MyMessageEncoder extends MessageToByteEncoder<MessageProtocol> {
@Override
protected void encode(ChannelHandlerContext ctx, MessageProtocol msg, ByteBuf out) throws Exception {
System.out.println("MyMessageEncoder encode 方法被调用");
out.writeInt(msg.getLen());
out.writeBytes(msg.getContent());
}
}
package com.atguigu.netty.protocoltcp;
import io.netty.buffer.ByteBuf;
import io.netty.channel.ChannelHandlerContext;
import io.netty.handler.codec.ReplayingDecoder;
import java.util.List;
public class MyMessageDecoder extends ReplayingDecoder<Void> {
@Override
protected void decode(ChannelHandlerContext ctx, ByteBuf in, List<Object> out) throws Exception {
System.out.println("MyMessageDecoder decode 被调用");
//需要将得到二进制字节码-> MessageProtocol 数据包(对象)
int length = in.readInt();
byte[] content = new byte[length];
in.readBytes(content);
//封装成 MessageProtocol 对象，放入 out， 传递下一个handler业务处理
MessageProtocol messageProtocol = new MessageProtocol();
messageProtocol.setLen(length);
messageProtocol.setContent(content);
out.add(messageProtocol);
}
}
package com.atguigu.netty.protocoltcp;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.SimpleChannelInboundHandler;
import java.nio.charset.Charset;
import java.util.UUID;
//处理业务的handler
public class MyServerHandler extends SimpleChannelInboundHandler<MessageProtocol> {
private int count;
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
//cause.printStackTrace();
ctx.close();
}
@Override
protected void channelRead0(ChannelHandlerContext ctx, MessageProtocol msg) throws Exception {
//接收到数据，并处理
int len = msg.getLen();
byte[] content = msg.getContent();
System.out.println();
System.out.println();
System.out.println();
System.out.println("服务器接收到信息如下");
System.out.println("长度=" + len);
System.out.println("内容=" + new String(content, Charset.forName("utf-8")));
System.out.println("服务器接收到消息包数量=" + (++this.count));
//回复消息
String responseContent = UUID.randomUUID().toString();
int responseLen = responseContent.getBytes("utf-8").length;
byte[] responseContent2 = responseContent.getBytes("utf-8");
//构建一个协议包
MessageProtocol messageProtocol = new MessageProtocol();
messageProtocol.setLen(responseLen);
messageProtocol.setContent(responseContent2);
ctx.writeAndFlush(messageProtocol);
}
}
```
================================================
FILE: docs/_content/chapter10.md
================================================
## 10.1 基本说明
1. 只有看过 `Netty` 源码，才能说是真的掌握了 `Netty` 框架。
2. 在 `io.netty.example` 包下，有很多 `Netty` 源码案例，可以用来分析。
3. 源码分析章节是针对有 `Java` 项目经验，并且玩过框架源码的人员讲的，否则你听起来会有相当的难度。
## 10.2 Netty 启动过程源码剖析
### 10.2.1 源码剖析目的
用源码分析的方式走一下 `Netty`（服务器）的启动过程，更好的理解 `Netty` 的整体设计和运行机制。
### 10.2.2 源码剖析
说明：
1. 源码需要剖析到 `Netty` 调用 `doBind` 方法，追踪到 `NioServerSocketChannel` 的 `doBind`。
2. 并且要 `Debug` 程序到 `NioEventLoop` 类的 `run` 代码，无限循环，在服务器端运行。
### 10.2.3 源码剖析过程
**1. `demo` 源码的基本理解**
```java
// 服务器启动类源码
/*
* Copyright 2012 The Netty Project
*
* The Netty Project licenses this file to you under the Apache License,
* version 2.0 (the "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package atguigu.netty.example.echo2;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.logging.LogLevel;
import io.netty.handler.logging.LoggingHandler;
import io.netty.handler.ssl.SslContext;
import io.netty.handler.ssl.SslContextBuilder;
import io.netty.handler.ssl.util.SelfSignedCertificate;
/**
* Echoes back any received data from a client.
*/
public final class EchoServer {
static final boolean SSL = System.getProperty("ssl") != null;
static final int PORT = Integer.parseInt(System.getProperty("port", "8007"));
public static void main(String[] args) throws Exception {
// Configure SSL.
final SslContext sslCtx;
if (SSL) {
SelfSignedCertificate ssc = new SelfSignedCertificate();
sslCtx = SslContextBuilder.forServer(ssc.certificate(), ssc.privateKey()).build();
} else {
sslCtx = null;
}
// Configure the server.
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup();
try {
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.option(ChannelOption.SO_BACKLOG, 100)
.handler(new LoggingHandler(LogLevel.INFO))
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline p = ch.pipeline();
if (sslCtx != null) {
p.addLast(sslCtx.newHandler(ch.alloc()));
}
//p.addLast(new LoggingHandler(LogLevel.INFO));
p.addLast(new EchoServerHandler());
}
});
// Start the server.
ChannelFuture f = b.bind(PORT).sync();
// Wait until the server socket is closed.
f.channel().closeFuture().sync();
} finally {
// Shut down all event loops to terminate all threads.
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
```
说明：
1. 先看启动类：`main` 方法中，首先创建了关于 SSL 的配置类。
2. 重点分析下创建了两个 `EventLoopGroup` 对象：
```java
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup();
```
(1) 这两个对象是整个 `Netty` 的核心对象，可以说，整个 `Netty` 的运作都依赖于他们。`bossGroup` 用于接受 `TCP` 请求，他会将请求交给 `workerGroup`，`workerGroup` 会获取到真正的连接，然后和连接进行通信，比如读写解码编码等操作。
(2) `EventLoopGroup` 是事件循环组（线程组）含有多个 `EventLoop`，可以注册 `channel`，用于在事件循环中去进行选择（和选择器相关）。【debug看】
(3) `new NioEventLoopGroup(1);` 这个 `1` 表示 `bossGroup` 事件组有 `1` 个线程你可以指定，如果 `new NioEventLoopGroup()` 会含有默认个线程 `cpu核数 * 2`，即可以充分的利用多核的优势，【可以dubug一把】
```java
DEFAULT_EVENT_LOOP_THREADS = Math.max(1, SystemPropertyUtil.getInt("io.netty.eventLoopThreads", NettyRuntime.availableProcessors() * 2));
```
会创建 `EventExecutor` 数组 `children = new EventExecutor[nThreads];` // `debug` 一下每个元素的类型就是 `NIOEventLoop`，`NIOEventLoop` 实现了 `EventLoop` 接口和 `Executor` 接口 `try` 块中创建了一个 `ServerBootstrap` 对象，他是一个引导类，用于启动服务器和引导整个程序的初始化（看下源码 `allowseasybootstrapof{@linkServerChannel}`）。它和 `ServerChannel` 关联，而 `ServerChannel` 继承了 `Channel`，有一些方法 `remoteAddress` 等[可以Debug下]随后，变量 `b` 调用了 `group` 方法将两个 `group` 放入了自己的字段中，用于后期引导使用【`debug` 下 `group` 方法
```java
/**
*Set the {@link EventLoopGroup} for the parent (acceptor) and the child (client) . These
*{@link EventLoopGroup}'s are used to handle all the events and IO for {@link ServerChannel} and
*{@link Channel}'s.
*/
```
】。
(4) 然后添加了一个 `channel`，其中参数一个 `Class` 对象，引导类将通过这个 `Class` 对象反射创建 `ChannelFactory`。然后添加了一些 `TCP` 的参数。【说明：`Channel` 的创建在 `bind` 方法，可以 `Debug` 下 `bind`，会找到 `channel = channelFactory.newChannel();` 】
(5) 再添加了一个服务器专属的日志处理器 `handler` 。
(6) 再添加一个 `SocketChannel`（不是 `ServerSocketChannel`）的 `handler`。
(7) 然后绑定端口并阻塞至连接成功。
(8) 最后 `main` 线程阻塞等待关闭。
(9) `finally` 块中的代码将在服务器关闭时优雅关闭所有资源。
```java
/*
* Copyright 2012 The Netty Project
*
* The Netty Project licenses this file to you under the Apache License,
* version 2.0 (the "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package atguigu.netty.example.echo2;
import io.netty.channel.ChannelHandler.Sharable;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
/**
* Handler implementation for the echo server.
*/
@Sharable
public class EchoServerHandler extends ChannelInboundHandlerAdapter {
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) {
ctx.write(msg);
}
@Override
public void channelReadComplete(ChannelHandlerContext ctx) {
ctx.flush();
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
// Close the connection when an exception is raised.
cause.printStackTrace();
ctx.close();
}
}
```
说明:
1. 这是一个普通的处理器类，用于处理客户端发送来的消息，在我们这里，我们简单的解析出客户端传过来的内容，然后打印，最后发送字符串给客户端。
2. 大致讲解了我们的 `demo` 源码的作用。后面的 `debug` 的时候会详细。
**2. 分析 EventLoopGroup 的过程**
2.1 构造器方法
```java
public NioEventLoopGroup (int nThreads) {
this(nThreads, (Executor) null);
}
```
2.2 上面的 `this(nThreads, (Executor) null);` 调用构造器（通过 `alt + d` 看即可）
```java
public NioEventLoopGroup (int nThreads, Executor executor) {
this(nThreads, executor, SelectorProvider.provider());
}
```
2.3 上面的 `this(nThreads, executor, SelectorProvider.provider());` 调用下面构造器
```java
public NioEventLoopGroup (int nThreads, Executor executor, final SelectorProvider selectorProvider) {
this(nThreads, executor, selectorProvider,DefaultSelectStrategyFactory.INSTANCE);
}
```
2.4 上面的 `this()...` 调用构造器（`alt + d`）
```java
public NioEventLoopGroup (int nThreads, Executor executor, final SelectorProvider selectorProvider,final SelectStrategyFactory selectStrategyFactory) {
super(nThreads, executor, selectorProvider, selectStrategyFactory, RejectedExecutionHandlers.reject());
}
```
2.5 上面的 `super()..` 的方法是父类：`MultithreadEventLoopGroup`
```java
protected MultithreadEventLoopGroup (int nThreads, Executor executor, Object...args) {
super(nThreads == 0 ? DEFAULT_EVENT_LOOP_THREADS : nThreads, executor, args);
}
```
2.6 追踪到源码抽象类 `MultithreadEventExecutorGroup` 的构造器方法 `MultithreadEventExecutorGroup` 才是 `NioEventLoopGroup` 真正的构造方法，这里可以看成是一个模板方法，使用了设计模式的模板模式（可看我录制视频），所以，我们就需要好好分析 `MultithreadEventExecutorGroup` 方法了
2.7 分析 `MultithreadEventExecutorGroup`
参数说明：
- `@param nThreads` 使用的线程数，默认为 `core * 2`【可以追踪源码】
- `@param executor` 执行器:如果传入 `null`, 则采用 `Netty` 默认的线程工厂和默认的执行器 `ThreadPerTaskExecutor`
- `@param chooserFactory` 单例 `new DefaultEventExecutorChooserFactory()`
- `@param args args` 在创建执行器的时候传入固定参数
```java
protected MultithreadEventExecutorGroup(int nThreads, Executor executor,
EventExecutorChooserFactory chooserFactory, Object... args) {
if (nThreads <= 0) {
throw new IllegalArgumentException(String.format("nThreads: %d (expected: > 0)", nThreads));
}
if (executor == null) { // 如果传入的执行器是空的则采用默认的线程工厂和默认的执行器
executor = new ThreadPerTaskExecutor(newDefaultThreadFactory());
}
// 创建指定线程数的执行器数组
children = new EventExecutor[nThreads];
// 初始化线程数组
for (int i = 0; i < nThreads; i ++) {
boolean success = false;
try {
// 创建 new NioEventLoop
children[i] = newChild(executor, args);
success = true;
} catch (Exception e) {
// TODO: Think about if this is a good exception type
throw new IllegalStateException("failed to create a child event loop", e);
} finally {
// 如果创建失败，优雅关闭
if (!success) {
for (int j = 0; j < i; j ++) {
children[j].shutdownGracefully();
}
for (int j = 0; j < i; j ++) {
EventExecutor e = children[j];
try {
while (!e.isTerminated()) {
e.awaitTermination(Integer.MAX_VALUE, TimeUnit.SECONDS);
}
} catch (InterruptedException interrupted) {
// Let the caller handle the interruption.
Thread.currentThread().interrupt();
break;
}
}
}
}
}
chooser = chooserFactory.newChooser(children);
final FutureListener<Object> terminationListener = new FutureListener<Object>() {
@Override
public void operationComplete(Future<Object> future) throws Exception {
if (terminatedChildren.incrementAndGet() == children.length) {
terminationFuture.setSuccess(null);
}
}
};
// 为每一个单例线程池添加一个关闭监听器
for (EventExecutor e: children) {
e.terminationFuture().addListener(terminationListener);
}
Set<EventExecutor> childrenSet = new LinkedHashSet<EventExecutor>(children.length);
//将所有的单例线程池添加到一个 HashSet 中。
Collections.addAll(childrenSet, children);
readonlyChildren = Collections.unmodifiableSet(childrenSet);
}
```
说明：
1. 如果 `executor` 是 `null`，创建一个默认的 `ThreadPerTaskExecutor`，使用 `Netty` 默认的线程工厂。
2. 根据传入的线程数（`CPU * 2`）创建一个线程池（单例线程池）数组。
3. 循环填充数组中的元素。如果异常，则关闭所有的单例线程池。
4. 根据线程选择工厂创建一个线程选择器。
5. 为每一个单例线程池添加一个关闭监听器。
6. 将所有的单例线程池添加到一个 `HashSet` 中。
**3. ServerBootstrap 创建和构造过程**
3.1 `ServerBootstrap` 是个空构造，但是有默认的成员变量
```java
private final Map<ChannelOption<?>, Object> childOptions = new LinkedHashMap<ChannelOption<?>, Object>();
private final Map<AttributeKey<?>, Object> childAttrs = new ConcurrentHashMap<AttributeKey<?>, Object>();
// config 对象，会在后面起很大作用
private final ServerBootstrapConfig config = new ServerBootstrapConfig(this);
private volatile EventLoopGroup childGroup;
private volatile ChannelHandler childHandler;
```
3.2 分析一下 `ServerBootstrap` 基本使用情况
```java
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.option(ChannelOption.SO_BACKLOG, 100)
.handler(new LoggingHandler(LogLevel.INFO))
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline p = ch.pipeline();
if (sslCtx != null) {
p.addLast(sslCtx.newHandler(ch.alloc()));
}
//p.addLast(new LoggingHandler(LogLevel.INFO));
p.addLast(new EchoServerHandler());
}
});
```
说明:
1. 链式调用：`group` 方法，将 `boss` 和 `worker` 传入，`boss` 赋值给 `parentGroup` 属性, `worker` 赋值给 `childGroup` 属性。
2. `channel` 方法传入 `NioServerSocketChannelclass` 对象。会根据这个 `class` 创建 `channel` 对象。
3. `option` 方法传入 `TCP` 参数，放在一个 `LinkedHashMap` 中。
4. `handler` 方法传入一个 `handler` 中，这个 `hanlder` 只专属于 `ServerSocketChannel` 而不是 `SocketChannel`。
5. `childHandler` 传入一个 `hanlder`，这个 `handler` 将会在每个客户端连接的时候调用。供 `SocketChannel` 使用。
**4. 绑定端口的分析**
4.1 服务器就是在这个 `bind` 方法里启动完成的
4.2 `bind` 方法代码,追踪到创建了一个端口对象，并做了一些空判断，核心代码 `doBind`，我们看看
```java
public ChannelFuture bind(SocketAddress localAddress) {
validate();
if (localAddress == null) {
throw new NullPointerException("localAddress");
}
return doBind(localAddress);
}
```
4.3 `doBind` 源码剖析，核心是两个方法 `initAndRegister` 和 `doBind0`
```java
private ChannelFuture doBind(final SocketAddress localAddress) {
final ChannelFuture regFuture = initAndRegister();
final Channel channel = regFuture.channel();
if (regFuture.cause() != null) {
return regFuture;
}
if (regFuture.isDone()) {
// At this point we know that the registration was complete and successful.
ChannelPromise promise = channel.newPromise();
//============================================
//说明:执行doBind0方法，完成对端口的绑定
//============================================
doBind0(regFuture, channel, localAddress, promise);
return promise;
} else {
// Registration future is almost always fulfilled already, but just in case it's not.
final PendingRegistrationPromise promise = new PendingRegistrationPromise(channel);
regFuture.addListener(new ChannelFutureListener() {
@Override
public void operationComplete(ChannelFuture future) throws Exception {
Throwable cause = future.cause();
if (cause != null) {
// Registration on the EventLoop failed so fail the ChannelPromise directly to not cause an
// IllegalStateException once we try to access the EventLoop of the Channel.
promise.setFailure(cause);
} else {
// Registration was successful, so set the correct executor to use.
// See https://github.com/netty/netty/issues/2586
promise.registered();
doBind0(regFuture, channel, localAddress, promise);
}
}
});
return promise;
}
}
```
4.4 分析说明 `initAndRegister`
```java
final ChannelFuture initAndRegister() {
Channel channel = null;
try {
channel = channelFactory.newChannel();
/**
* 说明：channelFactory.newChannel() 方法的作用通过 ServerBootstrap 的通道工厂反射创建一个 NioServerSocketChannel,具体追踪源码可以得到下面结论
* (1)通过 NIO 的 SelectorProvider 的 openServerSocketChannel 方法得到 JDK 的 channel。目的是让 Netty 包装 JDK 的 channel。
* (2)创建了一个唯一的 ChannelId，创建了一个 NioMessageUnsafe，用于操作消息，创建了一个 DefaultChannelPipeline 管道，是个双向链表结构，用于过滤所有的进出的消息。
* (3)创建了一个 NioServerSocketChannelConfig 对象，用于对外展示一些配置。
* channel = channelFactory.newChannel();//NioServerSocketChannel
* 说明：init 初始化这个 NioServerSocketChannel，具体追踪源码可以得到如下结论
* (1) init 方法，这是个抽象方法 (AbstractBootstrap类的），由ServerBootstrap实现（可以追一下源码//setChannelOptions(channel,options,logger);）。
* (2)设置 NioServerSocketChannel 的 TCP 属性。
* (3)由于 LinkedHashMap 是非线程安全的，使用同步进行处理。
* (4)对 NioServerSocketChannel 的 ChannelPipeline 添加 ChannelInitializer 处理器。
* (5)可以看出，init 的方法的核心作用在和 ChannelPipeline 相关。
* (6)从 NioServerSocketChannel 的初始化过程中，我们知道，pipeline 是一个双向链表，并且，他本身就初始化了 head 和 tail，这里调用了他的 addLast 方法，也就是将整个 handler 插入到 tail 的前面，因为 tail 永远会在后面，需要做一些系统的固定工作。
*/
init(channel);
} catch (Throwable t) {
if (channel != null) {
channel.unsafe().closeForcibly();
return new DefaultChannelPromise(channel, GlobalEventExecutor.INSTANCE).setFailure(t);
}
return new DefaultChannelPromise(new FailedChannel(), GlobalEventExecutor.INSTANCE).setFailure(t);
}
ChannelFuture regFuture = config().group().register(channel);
if (regFuture.cause() != null) {
if (channel.isRegistered()) {
channel.close();
} else {
channel.unsafe().closeForcibly();
}
}
return regFuture;
}
```
说明：
1. 基本说明：`initAndRegister()` 初始化 `NioServerSocketChannel` 通道并注册各个 `handler`，返回一个 `future`。
2. 通过 `ServerBootstrap` 的通道工厂反射创建一个 `NioServerSocketChannel`。
3. `init` 初始化这个 `NioServerSocketChannel`。
4. `config().group().register(channel)` 通过 `ServerBootstrap` 的 `bossGroup` 注册 `NioServerSocketChannel`。
5. 最后，返回这个异步执行的占位符即 `regFuture`。
4.5 `init` 方法会调用 `addLast`，现在进入到 `addLast` 方法内查看
```java
@Override
public final ChannelPipeline addLast(EventExecutorGroup group, String name, ChannelHandler handler) {
final AbstractChannelHandlerContext newCtx;
synchronized (this) {
checkMultiplicity(handler);
newCtx = newContext(group, filterName(name, handler), handler);
addLast0(newCtx);
if (!registered) {
newCtx.setAddPending();
callHandlerCallbackLater(newCtx, true);
return this;
}
EventExecutor executor = newCtx.executor();
if (!executor.inEventLoop()) {
callHandlerAddedInEventLoop(newCtx, executor);
return this;
}
}
callHandlerAdded0(newCtx);
return this;
}
```
说明：
1. `addLast` 方法，在 `DefaultChannelPipeline` 类中
2. `addLast` 方法这就是 `pipeline` 方法的核心
3. 检查该 `handler` 是否符合标准。
4. 创建一个 `AbstractChannelHandlerContext` 对象，这里说一下，`ChannelHandlerContext` 对象是 `ChannelHandler` 和 `ChannelPipeline` 之间的关联，每当有 `ChannelHandler` 添加到 `Pipeline` 中时，都会创建 `Context`。`Context` 的主要功能是管理他所关联的 `Handler` 和同一个 `Pipeline` 中的其他 `Handler` 之间的交互。
5. 将 `Context` 添加到链表中。也就是追加到 `tail` 节点的前面。
6. 最后，同步或者异步或者晚点异步的调用 `callHandlerAdded0` 方法
4.6 前面说了 `dobind` 方法有 `2` 个重要的步骤，`initAndRegister` 说完，接下来看 `doBind0` 方法，代码如下
```java
private static void doBind0(
final ChannelFuture regFuture, final Channel channel,
final SocketAddress localAddress, final ChannelPromise promise) {
// This method is invoked before channelRegistered() is triggered. Give user handlers a chance to set up
// the pipeline in its channelRegistered() implementation.
channel.eventLoop().execute(new Runnable() {
@Override
public void run() {
if (regFuture.isSuccess()) {
//bind方法这里下断点，这里下断点，来玩!!
channel.bind(localAddress, promise).addListener(ChannelFutureListener.CLOSE_ON_FAILURE);
} else {
promise.setFailure(regFuture.cause());
}
}
});
}
```
说明：
1. 该方法的参数为 `initAndRegister` 的 `future`，`NioServerSocketChannel`，端口地址，`NioServerSocketChannel` 的 `promise`
2. 这里就可以根据前面下的断点，一直 `debug`：
```java
// 将调用 LoggingHandler 的 invokeBind 方法,最后会追到
// DefaultChannelPipeline 类的 bind
// 然后进入到 unsafe.bind 方法 debug，注意要追踪到
// unsafe.bind，要 debug 第二圈的时候，才能看到。
@Override
public void bind (ChannelHandlerContext ctx, SocketAddress localAddress, ChannelPromise promise) throws Exception {
unsafe.bind(localAddress,promise);
}
// 继续追踪 AbstractChannel 的
public final void bind (final SocketAddress localAddress, final ChannelPromise promise) {
//....
try{
//!!!! 小红旗可以看到，这里最终的方法就是 doBind 方法，执行成功后，执行通道的 fireChannelActive 方法，告诉所有的 handler，已经成功绑定。
doBind(localAddress);//
} catch (Throwable t) {
safeSetFailure(promise, t);
closeIfClosed();
return;
}
}
```
3. 最终 `doBind` 就会追踪到 `NioServerSocketChannel` 的 `doBind`，说明 `Netty` 底层使用的是 `NIO`
```java
@Override
protected void doBind (SocketAddress localAddress) throws Exception {
if (PlatformDependent.javaVersion() >= 7) {
javaChannel().bind(localAddress, config.getBacklog());
} else {
javaChannel().socket().bind(localAddress, config.getBacklog());
}
}
```
4. 回到 `bind` 方法（`alt + v`），最后一步：`safeSetSuccess(promise)`，告诉 `promise` 任务成功了。其可以执行监听器的方法了。到此整个启动过程已经结束了，ok 了
5. 继续 `atl + v` 服务器就回进入到（`NioEventLoop` 类）一个循环代码，进行监听
```java
@Override
protected void run() {
for(;;) {
try{
}
}
}
```
### 10.2.4 Netty 启动过程梳理
1. 创建 `2` 个 `EventLoopGroup` 线程池数组。数组默认大小 `CPU * 2`，方便 `chooser` 选择线程池时提高性能
2. `BootStrap` 将 `boss` 设置为 `group` 属性，将 `worker` 设置为 `childer` 属性
3. 通过 `bind` 方法启动，内部重要方法为 `initAndRegister` 和 `dobind` 方法
4. `initAndRegister` 方法会反射创建 `NioServerSocketChannel` 及其相关的 `NIO` 的对象，`pipeline`，`unsafe`，同时也为 `pipeline` 初始了 `head` 节点和 `tail` 节点。
5. 在 `register0` 方法成功以后调用在 `dobind` 方法中调用 `doBind0` 方法，该方法会调用 `NioServerSocketChannel` 的 `doBind` 方法对 `JDK` 的 `channel` 和端口进行绑定，完成 `Netty` 服务器的所有启动，并开始监听连接事件。
## 10.3 Netty 接受请求过程源码剖析
### 10.3.1 源码剖析目的
1. 服务器启动后肯定是要接受客户端请求并返回客户端想要的信息的，下面源码分析 `Netty` 在启动之后是如何接受客户端请求的
2. 在 `io.netty.example` 包下
### 10.3.2 源码剖析
说明：
1. 从之前服务器启动的源码中，我们得知，服务器最终注册了一个 `Accept` 事件等待客户端的连接。我们也知道，`NioServerSocketChannel` 将自己注册到了 `boss` 单例线程池（`reactor` 线程）上，也就是 `EventLoop`。
2. 先简单说下 `EventLoop` 的逻辑(后面我们详细讲解 `EventLoop`)
`EventLoop` 的作用是一个死循环，而这个循环中做 3 件事情：
1. 有条件的等待 `NIO` 事件。
2. 处理 `NIO` 事件。
3. 处理消息队列中的任务。
4. 仍用前面的项目来分析：进入到 `NioEventLoop` 源码中后，在 `private void processSelectedKey(SelectionKey k, AbstractNioChannel ch)` 方法开始调试最终我们要分析到 `AbstractNioChannel` 的 `doBeginRead` 方法，当到这个方法时，针对于这个客户端的连接就完成了，接下来就可以监听读事件了
源码分析过程
1. 断点位置 `NioEventLoop` 的如下方法 `processSelectedKey`
```java
if((readyOps & (SelectionKey.OP_READ | SelectionKey.OP_ACCEPT)) != 0 || readyOps == 0) {
unsafe.read();//断点位置
}
```
2. 执行浏览器 `http://localhost:8007/` ，客户端发出请求
3. 从的断点我们可以看到，`readyOps` 是 `16`，也就是 `Accept` 事件。说明浏览器的请求已经进来了。
4. 这个 `unsafe` 是 `boss` 线程中 `NioServerSocketChannel` 的 `AbstractNioMessageChannel$NioMessageUnsafe` 对象。我们进入到 `AbstractNioMessageChannel$NioMessageUnsafe` 的 `read` 方法中
5. `read` 方法代码并分析:
```java
@Override
public void read() {
asserteventLoop().inEventLoop();
final ChannelConfig config = config();
final ChannelPipeline pipeline = pipeline();
final RecvByteBufAllocator.Handle allocHandle = unsafe().recvBufAllocHandle();
allocHandle.reset(config);
booleanclosed = false;
Throwable exception = null;
try {
try {
do {
int localRead = doReadMessages(readBuf);
if (localRead == 0) {
break;
}
if (localRead < 0) {
closed = true;
break;
}
allocHandle.incMessagesRead(localRead);
} while (allocHandle.continueReading());
} catch (Throwable t) {
exception = t;
}
int size = readBuf.size();
for (int i = 0; i < size; i++) {
readPending = false;
pipeline.fireChannelRead(readBuf.get(i));
}
readBuf.clear();
allocHandle.readComplete();
pipeline.fireChannelReadComplete();
if (exception != null) {
closed = closeOnReadError(exception);
pipeline.fireExceptionCaught(exception);
}
if (closed) {
inputShutdown = true;
if(isOpen()) {
close(voidPromise());
}
}
} finally {
//Check if there is a readPending which was not processed yet.
//This could be for two reasons:
//* The user called Channel.read() or ChannelHandlerContext.read() in channelRead(...) method
//* The user called Channel.read() or ChannelHandlerContext.read() in channelReadComplete(...) method
//
// See https://github.com/netty/netty/issues/2254
if (!readPending && !config.isAutoRead()) {
removeReadOp();
}
}
}
```
说明：
1)检查该 `eventloop` 线程是否是当前线程。`asserteventLoop().inEventLoop()`
2)执行 `doReadMessages` 方法，并传入一个 `readBuf` 变量，这个变量是一个 `List`，也就是容器。
3)循环容器，执行 `pipeline.fireChannelRead(readBuf.get(i));`
4)`doReadMessages` 是读取 `boss` 线程中的 `NioServerSocketChannel` 接受到的请求。并把这些请求放进容器，一会我们 `debug` 下 `doReadMessages` 方法。
5)循环遍历容器中的所有请求，调用 `pipeline` 的 `fireChannelRead` 方法，用于处理这些接受的请求或者其他事件，在 `read` 方法中，循环调用 `ServerSocket` 的 `pipeline` 的 `fireChannelRead` 方法,开始执行管道中的 `handler` 的 `ChannelRead` 方法（`debug` 进入）
6. 追踪一下 `doReadMessages` 方法，就可以看得更清晰
```java
protected int doReadMessages (List<Object> buf) throws Exception {
SocketChannel ch = SocketUtils.accept(javaChannel());
buf.add(newNioSocketChannel(this, ch));
return 1;
}
```
说明：
1)通过工具类，调用 `NioServerSocketChannel` 内部封装的 `serverSocketChannel` 的 `accept` 方法，这是 `NIO` 做法。
2)获取到一个 `JDK` 的 `SocketChannel`，然后，使用 `NioSocketChannel` 进行封装。最后添加到容器中
3)这样容器 `buf` 中就有了 `NioSocketChannel` 【如果有兴趣可以追一下 `NioSocketChannel` 是如何创建的，我就不追了】
7. 回到 `read` 方法，继续分析循环执行 `pipeline.fireChannelRead` 方法
1)前面分析 `doReadMessages` 方法的作用是通过 `ServerSocket` 的 `accept` 方法获取到 `TCP` 连接，然后封装成 `Netty` 的 `NioSocketChannel` 对象。最后添加到容器中
2)在 `read` 方法中，循环调用 `ServerSocket` 的 `pipeline` 的 `fireChannelRead` 方法,开始执行管道中的 `handler` 的 `ChannelRead` 方法（`debug` 进入）
3)经过 `dubug`（多次），可以看到会反复执行多个 `handler` 的 `ChannelRead`，我们知道，`pipeline` 里面又 `4` 个 `handler`，分别是 `Head`，`LoggingHandler`，`ServerBootstrapAcceptor`，`Tail`。
4)我们重点看看 `ServerBootstrapAcceptor`。`debug` 之后，断点会进入到 `ServerBootstrapAcceptor` 中来。我们来看看 `ServerBootstrapAcceptor` 的 `channelRead` 方法（要多次 `debug` 才可以）
5)`channelRead` 方法
```java
public void channelRead (ChannelHandlerContext ctx, Object msg) {
final Channelchild = (Channel)msg;
child.pipeline().addLast(childHandler);
setChannelOptions(child, childOptions, logger);
for (Entry<AttributeKey<?>, Object> e : childAttrs) {
child.attr((AttributeKey<Object>)e.getKey()).set(e.getValue());
}
try {//将客户端连接注册到 worker 线程池
childGroup.register(child).addListener(new ChannelFutureListener() {
@Override
public void operationComplete(ChannelFuturefuture) throws Exception {
if (!future.isSuccess()) {
forceClose(child, future.cause());
}
}
});
} catch (Throwable t) {
forceClose(child, t);
}
}
```
说明：
1)`msg` 强转成 `Channel`，实际上就是 `NioSocketChannel`。
2)添加 `NioSocketChannel` 的 `pipeline` 的 `handler`，就是我们 `main` 方法里面设置的 `childHandler` 方法里的。
3)设置 `NioSocketChannel` 的各种属性。
4)将该 `NioSocketChannel` 注册到 `childGroup` 中的一个 `EventLoop` 上，并添加一个监听器。
5)这个 `childGroup` 就是我们 `main` 方法创建的数组 `workerGroup`。
8. 进入 `register` 方法查看(步步追踪会到)
```java
@Override
public final void register (EventLoop eventLoop, final ChannelPromise promise) {
AbstractChannel.this.eventLoop = eventLoop;
if (eventLoop.inEventLoop()) {
register0(promise);
} else {
eventLoop.execute(new Runnable(){
@Override
public void run() {
register0(promise);//进入到这里
}
});
}
}
// 继续进入到下面方法，执行管道中可能存在的任务,这里我们就不追了
```
9. 最终会调用 `doBeginRead` 方法，也就是 `AbstractNioChannel` 类的方法
```java
@Override
protected void doBeginRead() throws Exception {
//Channel.read() or ChannelHandlerContext.read() was called
final SelectionKey selectionKey = this.selectionKey;//断点
if (!selectionKey.isValid()) {
return;
}
readPending = true;
final int interestOps = selectionKey.interestOps();
if ((interestOps&readInterestOp) == 0) {
selectionKey.interestOps(interestOps | readInterestOp);
}
}
```
10. 这个地方调试时，请把前面的断点都去掉，然后启动服务器就会停止在 `doBeginRead`（需要先放过该断点，然后浏览器请求，才能看到效果）
11. 执行到这里时，针对于这个客户端的连接就完成了，接下来就可以监听读事件了
### 10.3.3 Netty 接受请求过程梳理
总体流程：接受连接 --> 创建一个新的 `NioSocketChannel` --> 注册到一个 `workerEventLoop` 上 --> 注册 `selecotRead` 事件。
1. 服务器轮询 `Accept` 事件，获取事件后调用 `unsafe` 的 `read` 方法，这个 `unsafe` 是 `ServerSocket` 的内部类，该方法内部由 `2` 部分组成
2. `doReadMessages` 用于创建 `NioSocketChannel` 对象，该对象包装 `JDK` 的 `NioChannel` 客户端。该方法会像创建 `ServerSocketChanel` 类似创建相关的 `pipeline`，`unsafe`，`config`
3. 随后执行执行 `pipeline.fireChannelRead` 方法，并将自己绑定到一个 `chooser` 选择器选择的 `workerGroup` 中的一个 `EventLoop`。并且注册一个 `0`，表示注册成功，但并没有注册读（1）事件
## 10.4 Pipeline Handler HandlerContext 创建源码剖析
### 10.4.1 源码剖析目的
`Netty` 中的 `ChannelPipeline`、`ChannelHandler` 和 `ChannelHandlerContext` 是非常核心的组件，我们从源码来分析 `Netty` 是如何设计这三个核心组件的，并分析是如何创建和协调工作的.
### 10.4.2 源码剖析说明
说明
分析过程中，有很多的图形，所以我们准备了一个文档，在文档的基础上来做源码剖析
### 10.4.3 源码剖析
1. ChannelPipeline | ChannelHandler | ChannelHandlerContext介绍
1.1 三者关系
1)每当 `ServerSocket` 创建一个新的连接，就会创建一个 `Socket`，对应的就是目标客户端。
2)每一个新创建的 `Socket` 都将会分配一个全新的 `ChannelPipeline`（以下简称 `pipeline`）
3)每一个 `ChannelPipeline` 内部都含有多个 `ChannelHandlerContext`（以下简称 `Context`）
4)他们一起组成了双向链表，这些 `Context` 用于包装我们调用 `addLast` 方法时添加的 `ChannelHandler`（以下简称 `handler`）
1)上图中：`ChannelSocket` 和 `ChannelPipeline` 是一对一的关联关系，而 `pipeline` 内部的多个 `Context` 形成了链表，`Context` 只是对 `Handler` 的封装。
2)当一个请求进来的时候，会进入 `Socket` 对应的 `pipeline`，并经过 `pipeline` 所有的 `handler`，对，就是设计模式中的过滤器模式。
1.2 ChannelPipeline 作用及设计
1)`pipeline` 的接口设计
部分源码
可以看到该接口继承了 `inBound`，`outBound`，`Iterable` 接口，表示他可以调用数据出站的方法和入站的方法，同时也能遍历内部的链表，看看他的几个代表性的方法，基本上都是针对 `handler` 链表的插入，追加，删除，替换操作，类似是一个 `LinkedList`。同时，也能返回 `channel`（也就是 `socket`）
1)在 `pipeline` 的接口文档上，提供了一幅图
对上图的解释说明：
*这是一个 `handler` 的 `list`，`handler` 用于处理或拦截入站事件和出站事件，`pipeline` 实现了过滤器的高级形式，以便用户控制事件如何处理以及 `handler` 在 `pipeline` 中如何交互。
*上图描述了一个典型的 `handler` 在 `pipeline` 中处理 `I/O` 事件的方式，`IO` 事件由 `inboundHandler` 或者 `outBoundHandler` 处理，并通过调用 `ChannelHandlerContext.fireChannelRead` 方法转发给其最近的处理程序。
*入站事件由入站处理程序以自下而上的方向处理，如图所示。入站处理程序通常处理由图底部的 `I/O` 线程生成入站数据。入站数据通常从如 `SocketChannel.read(ByteBuffer)` 获取。
*通常一个 `pipeline` 有多个 `handler`，例如，一个典型的服务器在每个通道的管道中都会有以下处理程序协议解码器-将二进制数据转换为 `Java` 对象。协议编码器-将 `Java` 对象转换为二进制数据。业务逻辑处理程序-执行实际业务逻辑（例如数据库访问）
*你的业务程序不能将线程阻塞，会影响 `IO` 的速度，进而影响整个 `Netty` 程序的性能。如果你的业务程序很快，就可以放在 `IO` 线程中，反之，你需要异步执行。或者在添加 `handler` 的时候添加一个线程池，例如：
// 下面这个任务执行的时候，将不会阻塞 `IO` 线程，执行的线程来自 `group` 线程池
`pipeline.addLast(group, "handler", new MyBusinessLogicHandler());`
1.3 `ChannelHandler` 作用及设计
1)源码
```java
public interface ChannelHandler {
//当把 ChannelHandler 添加到 pipeline 时被调用
void handlerAdded(ChannelHandlerContext ctx) throws Exception;
//当从 pipeline 中移除时调用
void handlerRemoved(ChannelHandlerContext ctx) throws Exception;
//当处理过程中在 pipeline 发生异常时调用
@Deprecated
void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception;
}
```
2)`ChannelHandler` 的作用就是处理 `IO` 事件或拦截 `IO` 事件，并将其转发给下一个处理程序 `ChannelHandler`。`Handler` 处理事件时分入站和出站的，两个方向的操作都是不同的，因此，`Netty` 定义了两个子接口继承 `ChannelHandler`
2)`ChannelInboundHandler` 入站事件接口
*`channelActive` 用于当 `Channel` 处于活动状态时被调用；
*`channelRead` 当从 `Channel` 读取数据时被调用等等方法。
*程序员需要重写一些方法，当发生关注的事件，需要在方法中实现我们的业务逻辑，因为当事件发生时，`Netty` 会回调对应的方法。
3)`ChannelOutboundHandler 出站事件接口
*`bind` 方法，当请求将 `Channel` 绑定到本地地址时调用
*`close` 方法，当请求关闭 `Channel` 时调用等等
*出站操作都是一些连接和写出数据类似的方法。
4)`ChannelDuplexHandler` 处理出站和入站事件
*`ChannelDuplexHandler` 间接实现了入站接口并直接实现了出站接口。
*是一个通用的能够同时处理入站事件和出站事件的类。
1.4 `ChannelHandlerContext` 作用及设计
1)`ChannelHandlerContext` `UML` 图
`ChannelHandlerContext` 继承了出站方法调用接口和入站方法调用接口
1)`ChannelOutboundInvoker` 和 `ChannelInboundInvoker` 部分源码
*这两个 `invoker` 就是针对入站或出站方法来的，就是在入站或出站 `handler` 的外层再包装一层，达到在方法前后拦截并做一些特定操作的目的
2)`ChannelHandlerContext` 部分源码
*`ChannelHandlerContext` 不仅仅时继承了他们两个的方法，同时也定义了一些自己的方法
*这些方法能够获取 `Context` 上下文环境中对应的比如 `channel`，`executor`，`handler`，`pipeline`，内存分配器，关联的 `handler` 是否被删除。
*`Context` 就是包装了 `handler` 相关的一切，以方便 `Context` 可以在 `pipeline` 方便的操作 `handler`
2.ChannelPipeline | ChannelHandler | ChannelHandlerContext
创建过程分为 `3` 个步骤来看创建的过程：
*任何一个 `ChannelSocket` 创建的同时都会创建一个 `pipeline`。
*当用户或系统内部调用 `pipeline` 的 `add`
*** 方法添加 `handler` 时，都会创建一个包装这 `handler` 的 `Context`。
*这些 `Context` 在 `pipeline` 中组成了双向链表。
2.1 `Socket` 创建的时候创建 `pipeline` 在 `SocketChannel` 的抽象父类 `AbstractChannel` 的构造方法中
```java
protected AbstractChannel(Channel parent) {
this.parent=parent;//断点测试
id = newId();
unsafe = new Unsafe();
pipeline = new ChannelPipeline();
}
```
`Debug` 一下，可以看到代码会执行到这里，然后继续追踪到
```java
protected DefaultChannelPipeline(Channel channel) {
this.channel = ObjectUtil.checkNotNull(channel, "channel");
succeededFuture = new SucceededChannelFuture(channel, null);
voidPromise = new VoidChannelPromise(channel, true);
tail = new TailContext(this);
head = new HeadContext(this);
head.next = tail;
tail.prev = head;
}
```
说明：
1）将 `channel` 赋值给 `channel` 字段，用于 `pipeline` 操作 `channel`。
2）创建一个 `future` 和 `promise`，用于异步回调使用。
3）创建一个 `inbound` 的 `tailContext`，创建一个既是 `inbound` 类型又是 `outbound` 类型的 `headContext`。
4）最后，将两个 `Context` 互相连接，形成双向链表。
5）`tailContext` 和 `HeadContext` 非常的重要，所有 `pipeline` 中的事件都会流经他们，
2.2 在 add**添加处理器的时候创建Context**看下 `DefaultChannelPipeline` 的 `addLast` 方法如何创建的 `Context`，代码如下
```java
@Override
public final ChannelPipeline addLast(EventExecutorGroup executor, ChannelHandler... handlers) {
if (handlers == null) {//断点
throw new NullPointerException("handlers");
}
for (ChannelHandler h : handlers) {
if (h == null) {
break;
}
addLast(executor, null, h);
}
return this;
}
```
继续 Debug
```java
public final ChannelPipeline addLast(EventExecutorGroup group, String name, ChannelHandler handler) {
final AbstractChannelHandlerContext newCtx;
synchronized(this) {
checkMultiplicity(handler);
newCtx = newContext(group, filterName(name, handler), handler);
addLast0(newCtx);
//If the registered is false it means that the channel was not registered on an eventloop yet.
//In this case we add the context to the pipeline and add a task that will call
//ChannelHandler.handlerAdded(...) once the channel is registered.
if (!registered) {
newCtx.setAddPending();
callHandlerCallbackLater(newCtx, true);
return this;
}
EventExecutor executor = newCtx.executor();
if (!executor.inEventLoop()) {
newCtx.setAddPending();
executor.execute(new Runnable() {
@Override
public void run () {
callHandlerAdded0(newCtx);
}
});
return this;
}
}
callHandlerAdded0(newCtx);
return this;
}
```
说明
1)`pipeline` 添加 `handler`，参数是线程池，`name` 是 `null`，`handler` 是我们或者系统传入的 `handler`。`Netty` 为了防止多个线程导致安全问题，同步了这段代码，步骤如下：
2)检查这个 `handler` 实例是否是共享的，如果不是，并且已经被别的 `pipeline` 使用了，则抛出异常。
3)调用 `new Context(group, filterName(name, handler), handler)` 方法，创建一个 `Context`。从这里可以看出来了，每次添加一个 `handler` 都会创建一个关联 `Context`。
4)调用 `addLast` 方法，将 `Context` 追加到链表中。
5)如果这个通道还没有注册到 `selecor` 上，就将这个 `Context` 添加到这个 `pipeline` 的待办任务中。当注册好了以后，就会调用 `callHandlerAdded0` 方法（默认是什么都不做，用户可以实现这个方法）。
6)到这里，针对三对象创建过程，了解的差不多了，和最初说的一样，每当创建 `ChannelSocket` 的时候都会创建一个绑定的 `pipeline`，一对一的关系，创建 `pipeline` 的时候也会创建 `tail` 节点和 `head` 节点，形成最初的链表。`tail` 是入站 `inbound` 类型的 `handler`，`head` 既是 `inbound` 也是 `outbound` 类型的 `handler`。在调用 `pipeline` 的 `addLast` 方法的时候，会根据给定的 `handler` 创建一个 `Context`，然后，将这个 `Context` 插入到链表的尾端（`tail` 前面）。到此就 `OK` 了。
### 10.4.4 Pipeline Handler HandlerContext 创建过程梳理
1. 每当创建 `ChannelSocket` 的时候都会创建一个绑定的 `pipeline`，一对一的关系，创建 `pipeline` 的时候也会创建 `tail` 节点和 `head` 节点，形成最初的链表。
2. 在调用 `pipeline` 的 `addLast` 方法的时候，会根据给定的 `handler` 创建一个 `Context`，然后，将这个 `Context` 插入到链表的尾端（`tail` 前面）。
3. `Context` 包装 `handler`，多个 `Context` 在 `pipeline` 中形成了双向链表
4. 入站方向叫 `inbound`，由 `head` 节点开始，出站方法叫 `outbound`，由 `tail` 节点开始
## 10.5 ChannelPipeline 调度 handler 的源码剖析
### 10.5.1 源码剖析目的
1. 当一个请求进来的时候，`ChannelPipeline` 是如何调用内部的这些 `handler` 的呢？我们一起来分析下。
2. 首先，当一个请求进来的时候，会第一个调用 `pipeline` 的相关方法，如果是入站事件，这些方法由 `fire` 开头，表示开始管道的流动。让后面的 `handler` 继续处理
### 10.5.2 源码剖析
说明
当浏览器输入 `http://localhost:8007` 。可以看到会执行 `handler`
在 `Debug` 时，可以将断点下在 `DefaultChannelPipeline` 类的
```java
public final ChannelPipeline fireChannelActive() {
AbstractChannelHandlerContext.invokeChannelActive(head);//断点
return this;
}
```
源码分析
3. `DefaultChannelPipeline` 是如何实现这些 `fire` 方法的
3.1 `DefaultChannelPipeline` 源码
```java
public class DefaultChannelPipeline implements ChannelPipeline {
@Override
public final ChannelPipeline fireChannelActive() {
AbstractChannelHandlerContext.invokeChannelActive(head);
return this;
}
@Override
public final ChannelPipelinefireChannelInactive() {
AbstractChannelHandlerContext.invokeChannelInactive(head);
return this;
}
@Override
public final ChannelPipeline fireExceptionCaught(Throwable cause) {
AbstractChannelHandlerContext.invokeExceptionCaught(head, cause);
return this;
}
@Override
public final ChannelPipeline fireUserEventTriggered(Object event) {
AbstractChannelHandlerContext.invokeUserEventTriggered(head, event);
return this;
}
@Override
public final ChannelPipeline fireChannelRead(Objectmsg) {
AbstractChannelHandlerContext.invokeChannelRead(head, msg);
return this;
}
@Override
public final ChannelPipeline fireChannelReadComplete() {
AbstractChannelHandlerContext.invokeChannelReadComplete(head);
return this;
}
@Override
public final ChannelPipeline fireChannelWritabilityChanged() {
AbstractChannelHandlerContext.invokeChannelWritabilityChanged(head);
return this;
}
}
```
说明：
可以看出来，这些方法都是 `inbound` 的方法，也就是入站事件，调用静态方法传入的也是 `inbound` 的类型 `head` `handler`。这些静态方法则会调用 `head` 的 `ChannelInboundInvoker` 接口的方法，再然后调用 `handler` 的真正方法
3.2再看下 `piepline` 的 `outbound` 的 `fire` 方法实现源码
```java
public class DefaultChannelPipeline implements ChannelPipeline {
@Override
public final ChannelFuture bind(SocketAddress localAddress) {
return tail.bind(localAddress);
}
@Override
public final ChannelFuture connect(SocketAddress remoteAddress) {
return tail.connect(remoteAddress);
}
@Override
public final ChannelFuture connect(SocketAddress remoteAddress, SocketAddress localAddress) {
return tail.connect(remoteAddress, localAddress);
}
@Override
public final ChannelFuture disconnect(){
return tail.disconnect();
}
@Override
public final ChannelFuture close() {
return tail.close();
}
@Override
public final ChannelFuture deregister() {
return tail.deregister();
}
@Override
public final ChannelPipeline flush() {
tail.flush();
return this;
}
@Override
public final ChannelFuture bind(SocketAddress localAddress, ChannelPromise promise) {
return tail.bind(localAddress, promise);
}
@Override
public final ChannelFuture connect(SocketAddress remoteAddress, ChannelPromise promise) {
return tail.connect(remoteAddress, promise);
}
@Override
public final ChannelFuture connect(SocketAddress remoteAddress, SocketAddress localAddress, ChannelPromise promise) {
return tail.connect(remoteAddress, localAddress, promise);
}
@Override
public final ChannelFuture disconnect(ChannelPromise promise) {
return tail.disconnect(promise);
}
}
```
说明：
1)这些都是出站的实现，但是调用的是 `outbound` 类型的 `tailhandler` 来进行处理，因为这些都是 `outbound` 事件。
2)出站是 `tail` 开始，入站从 `head` 开始。因为出站是从内部向外面写，从 `tail` 开始，能够让前面的 `handler` 进行处理，防止 `handler` 被遗漏，比如编码。反之，入站当然是从 `head` 往内部输入，让后面的 `handler` 能够处理这些输入的数据。比如解码。因此虽然 `head` 也实现了 `outbound` 接口，但不是从 head 开始执行出站任务
4.关于如何调度，用一张图来表示:
说明：
1)`pipeline` 首先会调用 `Context` 的静态方法 `fireXXX`，并传入 `Context`
2)然后，静态方法调用 `Context` 的 `invoker` 方法，而 `invoker` 方法内部会调用该 `Context` 所包含的 `Handler` 的真正的 `XXX` 方法，调用结束后，如果还需要继续向后传递，就调用 `Context` 的 `fireXXX2` 方法，循环往复。
### 10.5.3 ChannelPipeline 调度 handler 梳理
1. `Context` 包装 `handler`，多个 `Context` 在 `pipeline` 中形成了双向链表，入站方向叫 `inbound`，由 `head` 节点开始，出站方法叫 `outbound`，由 `tail` 节点开始。
2. 而节点中间的传递通过 `Abstract ChannelHandlerContext` 类内部的 `fire` 系列方法，找到当前节点的下一个节点不断的循环传播。是一个过滤器形式完成对 `handler` 的调度
## 10.6 Netty 心跳(heartbeat)服务源码剖析
### 10.6.1 源码剖析目的
`Netty` 作为一个网络框架，提供了诸多功能，比如编码解码等，`Netty` 还提供了非常重要的一个服务 -- 心跳机制 `heartbeat`。通过心跳检查对方是否有效，这是 `RPC` 框架中是必不可少的功能。下面我们分析一下 `Netty` 内部心跳服务源码实现。
### 10.6.2 源码剖析
说明
`Netty` 提供了 `IdleStateHandler`，`ReadTimeoutHandler`，`WriteTimeoutHandler` 三个 `Handler` 检测连接的有效性，重点分析 `IdleStateHandler`。
如图
源码剖析：
5.`Netty` 提供的心跳介绍
1)`Netty` 提供了 `IdleStateHandler`，`ReadTimeoutHandler`，`WriteTimeoutHandler` 三个 `Handler` 检测连接的有效性。
2)如图
3)`ReadTimeout` 事件和 `WriteTimeout` 事件都会自动关闭连接，而且，属于异常处理，所以，这里只是介绍以下，我们重点看 `IdleStateHandler`。
6.`IdleStateHandler` 分析
6.1 `4` 个属性
```java
private final boolean observeOutput; //是否考虑出站时较慢的情况。默认值是 false
private final long readerIdleTimeNanos; //读事件空闲时间，0 则禁用事件
private final long writerIdleTimeNanos;//写事件空闲时间，0 则禁用事件
private final long allIdleTimeNanos;//读或写空闲时间，0 则禁用事件
```
6.2`handlerAdded` 方法
当该 `handler` 被添加到 `pipeline` 中时，则调用 `initialize` 方法
```java
private void initialize(ChannelHandlerContext ctx) {
//Avoid the case where destroy() is called before scheduling timeouts.
//See:https://github.com/netty/netty/issues/143
switch(state) {
case1:
case2:
return;
}
state=1;
initOutputChanged(ctx);
lastReadTime = lastWriteTime = ticksInNanos();
if(readerIdleTimeNanos > 0) {
//这里的 schedule 方法会调用 eventLoop 的 schedule 方法，将定时任务添加进队列中
readerIdleTimeout = schedule(ctx, new ReaderIdleTimeoutTask(ctx), readerIdleTimeNanos, TimeUnit.NANOSECONDS);
}
if(writerIdleTimeNanos > 0) {
writerIdleTimeout = schedule(ctx, new WriterIdleTimeoutTask(ctx), writerIdleTimeNanos, TimeUnit.NANOSECONDS);
}
if(allIdleTimeNanos > 0) {
allIdleTimeout = schedule(ctx, new AllIdleTimeoutTask(ctx), allIdleTimeNanos, TimeUnit.NANOSECONDS);
}
}
```
只要给定的参数大于 `0`，就创建一个定时任务，每个事件都创建。同时，将 `state` 状态设置为 `1`，防止重复初始化。调用 `initOutputChanged` 方法，初始化“监控出站数据属性”。
6.3该类内部的 `3` 个定时任务类
1)这 `3` 个定时任务分别对应读，写，读或者写事件。共有一个父类（`AbstractIdleTask`）。这个父类提供了一个模板方法
```java
private abstract static class AbstractIdleTask implements Runnable {
private final ChannelHandlerContext ctx;
AbstractIdleTask(ChannelHandlerContext ctx) {
this.ctx = ctx;
}
@Override
public void run() {
if(!ctx.channel().isOpen()) {
return;
}
run(ctx);
}
protected abstract void run(ChannelHandlerContext ctx);
}
```
说明：当通道关闭了，就不执行任务了。反之，执行子类的 `run` 方法
7.读事件的 `run` 方法（即 `ReaderIdleTimeoutTask` 的 `run` 方法）分析
1)代码及其说明
```java
@Override
protected void run(ChannelHandlerContext ctx) {
long nextDelay = readerIdleTimeNanos;
if(!reading) {
nextDelay -= ticksInNanos() - lastReadTime;
}
if(nextDelay <= 0) {
//Reader is idle-set a new timeout and notify the callback.
//用于取消任务 promise
readerIdleTimeout = schedule(ctx, this, readerIdleTimeNanos, TimeUnit.NANOSECONDS);
boolean first = firstReaderIdleEvent;
firstReaderIdleEvent = false;
try {
//再次提交任务
IdleStateEvent event = new IdleStateEvent(IdleState.READER_IDLE, first);
//触发用户 handler use
channelIdle(ctx, event);
} catch (Throwable t) {
ctx.fireExceptionCaught(t);
}
} else {
//Read occurred before the timeout - set a new timeout with shorter delay.
readerIdleTimeout = schedule(ctx, this, nextDelay, TimeUnit.NANOSECONDS);
}
}
```
说明：
1)得到用户设置的超时时间。
2)如果读取操作结束了（执行了 `channelReadComplete` 方法设置），就用当前时间减去给定时间和最后一次读（执操作的时间行了 `channelReadComplete` 方法设置），如果小于 `0`，就触发事件。反之，继续放入队列。间隔时间是新的计算时间。
3)触发的逻辑是：首先将任务再次放到队列，时间是刚开始设置的时间，返回一个 `promise` 对象，用于做取消操作。然后，设置 `first` 属性为`false`，表示，下一次读取不再是第一次了，这个属性在 `channelRead` 方法会被改成 `true`。
4)创建一个 `IdleStateEvent` 类型的写事件对象，将此对象传递给用户的 `UserEventTriggered` 方法。完成触发事件的操作。
5)总的来说，每次读取操作都会记录一个时间，定时任务时间到了，会计算当前时间和最后一次读的时间的间隔，如果间隔超过了设置的时间，就触发 `UserEventTriggered` 方法。//前面介绍 `IdleStateHandler` 说过,可以看一下
8.写事件的 `run` 方法（即 `WriterIdleTimeoutTask` 的 `run` 方法）分析
1)`run` 代码和分析
```java
@Override
protected void run(ChannelHandlerContext ctx) {
long lastWriteTime = IdleStateHandler.this.lastWriteTime;
long nextDelay = writerIdleTimeNanos - (ticksInNanos()-lastWriteTime);
if (nextDelay <=0 ) {
//Writer is idle - set a new timeout and notify the callback.
writerIdleTimeout = schedule(ctx, this, writerIdleTimeNanos, TimeUnit.NANOSECONDS);
boolean first = firstWriterIdleEvent;
firstWriterIdleEvent = false;
try {
if(hasOutputChanged(ctx, first)) {
return;
}
IdleStateEvent event = new IdleStateEvent(IdleState.WRITER_IDLE, first);
channelIdle(ctx, event);
} catch (Throwable t) {
ctx.fireExceptionCaught(t);
}
} else {
//Write occurred before the timeout - set a new timeout with shorter delay.
writerIdleTimeout = schedule(ctx, this, nextDelay, TimeUnit.NANOSECONDS);
}
}
```
说明：写任务的 `run` 代码逻辑基本和读任务的逻辑一样，唯一不同的就是有一个针对出站较慢数据的判断 `hasOutputChanged`
9.所有事件的 `run` 方法（即 `AllIdleTimeoutTask` 的 `run` 方法）分析
代码分析
```java
@Override
protected void run(ChannelHandlerContext ctx) {
long nextDelay = allIdleTimeNanos;
if(!reading) {
nextDelay -= ticksInNanos() - Math.max(lastReadTime, lastWriteTime);
}
if(nextDelay <= 0) {
//Both reader and writer are idle - set a new timeout and
//notify the callback.
allIdleTimeout = schedule(ctx, this, allIdleTimeNanos, TimeUnit.NANOSECONDS);
boolean first = firstAllIdleEvent;
firstAllIdleEvent = false;
try {
if(hasOutputChanged(ctx, first)) {
return;
}
IdleStateEvent event = new IdleStateEvent(IdleState.ALL_IDLE, first);
channelIdle(ctx, event);
} catch(Throwable t) {
ctx.fireExceptionCaught(t);
}
} else {
//Either read or write occurred before the timeout - set a new
//timeout with shorter delay.
allIdleTimeout = schedule(ctx, this, nextDelay, TimeUnit.NANOSECONDS);
}
}
```
说明：
1)表示这个监控着所有的事件。当读写事件发生时，都会记录。代码逻辑和写事件的的基本一致：
2)需要大家注意的地方是
```java
long nextDelay = allIdleTimeNanos;
if(!reading) {
//当前时间减去最后一次写或读的时间，若大于 0，说明超时了
nextDelay -= ticksInNanos() - Math.max(lastReadTime, lastWriteTime);
}
```
3)这里的时间计算是取读写事件中的最大值来的。然后像写事件一样，判断是否发生了写的慢的情况。
10.小结 `Netty` 的心跳机制
1)`IdleStateHandler` 可以实现心跳功能，当服务器和客户端没有任何读写交互时，并超过了给定的时间，则会触发用户 `handler` 的 `userEventTriggered` 方法。用户可以在这个方法中尝试向对方发送信息，如果发送失败，则关闭连接。
2)`IdleStateHandler` 的实现基于 `EventLoop` 的定时任务，每次读写都会记录一个值，在定时任务运行的时候，通过计算当前时间和设置时间和上次事件发生时间的结果，来判断是否空闲。
3)内部有 `3` 个定时任务，分别对应读事件，写事件，读写事件。通常用户监听读写事件就足够了。
4)同时，`IdleStateHandler` 内部也考虑了一些极端情况：客户端接收缓慢，一次接收数据的速度超过了设置的空闲时间。`Netty` 通过构造方法中的 `observeOutput` 属性来决定是否对出站缓冲区的情况进行判断。
5)如果出站缓慢，`Netty` 不认为这是空闲，也就不触发空闲事件。但第一次无论如何也是要触发的。因为第一次无法判断是出站缓慢还是空闲。当然，出站缓慢的话，可能造成 `OOM`，`OOM` 比空闲的问题更大。
6)所以，当你的应用出现了内存溢出，`OOM` 之类，并且写空闲极少发生（使用了 `observeOutput` 为 `true`），那么就需要注意是不是数据出站速度过慢。
7)还有一个注意的地方：就是 `ReadTimeoutHandler`，它继承自 `IdleStateHandler`，当触发读空闲事件的时候，就触发 `ctx`. `fireExceptionCaught` 方法，并传入一个 `ReadTimeoutException`，然后关闭 `Socket`。
8)而 `WriteTimeoutHandler` 的实现不是基于 `IdleStateHandler` 的，他的原理是，当调用 `write` 方法的时候，会创建一个定时任务，任务内容是根据传入的 `promise` 的完成情况来判断是否超出了写的时间。当定时任务根据指定时间开始运行，发现 `promise` 的 `isDone` 方法返回 `false`，表明还没有写完，说明超时了，则抛出异常。当 `write` 方法完成后，会打断定时任务。
## 10.7 Netty 核心组件 EventLoop 源码剖析
### 10.7.1 源码剖析目的
`Echo` 第一行代码就是：`EventLoopGroup bossGroup = new NioEventLoopGroup(1)`; 下面分析其最核心的组件 `EventLoop`。
### 10.7.2 源码剖析
源码剖析
1.`EventLoop`介绍
1.1首先看看 `NioEventLoop` 的继承图
说明重点：
1)`ScheduledExecutorService` 接口表示是一个定时任务接口，`EventLoop` 可以接受定时任务。
2)`EventLoop` 接口：`Netty` 接口文档说明该接口作用：一旦 `Channel` 注册了，就处理该 `Channel` 对应的所有 `I/O` 操作。
3)`SingleThreadEventExecutor` 表示这是一个单个线程的线程池
4)`EventLoop` 是一个单例的线程池，里面含有一个死循环的线程不断的做着 `3` 件事情：监听端口，处理端口事件，处理队列事件。每个 `EventLoop` 都可以绑定多个 `Channel`，而每个 `Channel` 始终只能由一个 `EventLoop` 来处理
2. `NioEventLoop` 的使用 - `execute` 方法
2.1 `execute` 源码剖析
在 `EventLoop` 的使用，一般就是 `eventloop.execute(task);` 看下 `execute` 方法的实现(在 `SingleThreadEventExecutor` 类中)
```java
@Override
public void execute(Runnable task) {
if(task == null) {
throw new NullPointerException("task");
}
boolean inEventLoop = inEventLoop();
if(inEventLoop) {
addTask(task);
} else {
startThread();
addTask(task);
if(isShutdown() && removeTask(task)) {
reject();
}
}
if(!addTaskWakesUp&&wakesUpForTask(task)) {
wakeup(inEventLoop);
}
}
```
说明:
1)首先判断该 `EventLoop` 的线程是否是当前线程，如果是，直接添加到任务队列中去，如果不是，则尝试启动线程（但由于线程是单个的，因此只能启动一次），随后再将任务添加到队列中去。
2)如果线程已经停止，并且删除任务失败，则执行拒绝策略，默认是抛出异常。
3)如果 `addTaskWakesUp` 是 `false`，并且任务不是 `NonWakeupRunnable` 类型的，就尝试唤醒 `selector`。这个时候，阻塞在 `selecor`的线程就会立即返回
4)可以下断点来追踪
2.2我们 `debugaddTask` 和 `offerTask` 方法源码
```java
protected void addTask(Runnable task) {
if(task == null) {
throw new NullPointerException("task");
}
if(!offerTask(task)) {
reject(task);
}
}
final boolean offerTask(Runnable task) {
if(isShutdown()) {
reject();
}
return taskQueue.offer(task);
}
```
3.`NioEventLoop` 的父类 `SingleThreadEventExecutor` 的 `startThread` 方法
3.1当执行 `execute` 方法的时候，如果当前线程不是 `EventLoop` 所属线程，则尝试启动线程，也就是 `startThread` 方法，dubug 代码如下：
```java
private void startThread() {
if(state == ST_NOT_STARTED) {
if(STATE_UPDATER.compareAndSet(this, ST_NOT_STARTED, ST_STARTED)) {
try{
doStartThread();
} catch(Throwable cause) {
STATE_UPDATER.set(this, ST_NOT_STARTED);
PlatformDependent.throwException(cause);
}
}
}
}
```
说明:该方法首先判断是否启动过了，保证 `EventLoop` 只有一个线程，如果没有启动过，则尝试使用 `Cas` 将 `state` 状态改为 `ST_STARTED`，也就是已启动。然后调用 `doStartThread` 方法。如果失败，则进行回滚
看下 `doStartThread` 方法
```java
private void doStartThread() {
executor.execute(new Runnable() {
@Override
public void run() {
boolean success = false;
updateLastExecutionTime();
try{
SingleThreadEventExecutor.this.run();
success=true;
} finally {
for( ; ; ) {
intoldState = state;
if(oldState >= ST_SHUTTING_DOWN || STATE_UPDATER.compareAndSet(SingleThreadEventExecutor.this, oldState, ST_SHUTTING_DOWN)) {
break;
}
}
try {
for( ; ; ) {
if(confirmShutdown()) {
break;
}
}
} finally {
try {
cleanup();
} finally {
STATE_UPDATER.set(SingleThreadEventExecutor.this,ST_TERMINATED);
threadLock.release();
terminationFuture.setSuccess(null);
}
}
}
}
});
}
```
说明：
1)首先调用 `executor` 的 `execute` 方法，这个 `executor` 就是在创建 `EventLoopGroup` 的时候创建的 `ThreadPerTaskExecutor` 类。该 `execute` 方法会将 `Runnable` 包装成 `Netty` 的 `FastThreadLocalThread`。
2)任务中，首先判断线程中断状态，然后设置最后一次的执行时间。
3)执行当前 `NioEventLoop` 的 `run` 方法，注意：这个方法是个死循环，是整个 `EventLoop` 的核心
4)在 `finally` 块中，使用 `CAS` 不断修改 `state` 状态，改成 `ST_SHUTTING_DOWN`。也就是当线程 `Loop` 结束的时候。关闭线程。最后还要死循环确认是否关闭，否则不会 `break`。然后，执行 `cleanup` 操作，更新状态为
5)`ST_TERMINATED`，并释放当前线程锁。如果任务队列不是空，则打印队列中还有多少个未完成的任务。并回调 `terminationFuture` 方法。
6)其实最核心的就是 `EventLoop` 自身的 `run` 方法。再继续深入 `run` 方法
4.`EventLoop` 中的 `Loop` 是靠 `run` 实现的，我们分析下 `run` 方法(该方法在 `NioEventLoop`)
```java
@Override
protected void run() {
for( ; ; ) {
try {
switch(selectStrategy.calculateStrategy(selectNowSupplier,hasTasks())) {
case SelectStrategy.CONTINUE:
continue;
case SelectStrategy.SELECT:
select(wakenUp.getAndSet(false));
if(wakenUp.get()) {
selector.wakeup();
}
default:
}
cancelledKeys = 0;
needsToSelectAgain = false;
final int ioRatio = this.ioRatio;
if(ioRatio == 100) {
try {
processSelectedKeys();
} finally {
//Ensure we always run tasks.
runAllTasks();
}
} else {
final long ioStartTime = System.nanoTime();
try {
processSelectedKeys();
} finally {
//Ensure we always runtasks.
final long ioTime = System.nanoTime() - ioStartTime;
runAllTasks(ioTime * (100 - ioRatio) / ioRatio);
}
}
} catch(Throwable t) {
handleLoopException(t);
}
//Always handle shutdown even if the loop processing threw an exception.
try {
if(isShuttingDown()) {
closeAll();
if(confirmShutdown()) {
return;
}
}
} catch (Throwable t) {
handleLoopException(t);
}
}
}
```
说明:
1)从上面的步骤可以看出，整个 `run` 方法做了 `3` 件事情：
`select` 获取感兴趣的事件。
`processSelectedKeys` 处理事件。
`runAllTasks` 执行队列中的任务。
2)上面的三个方法，我们就追一下 `select` 方法(体现非阻塞)核心 `select` 方法解析
```java
private void select(boolean oldWakenUp) throws IOException {
Selector selector = this.selector;
try {
int selectCnt = 0;
long currentTimeNanos = System.nanoTime();
long selectDeadLineNanos = currentTimeNanos + delayNanos(currentTimeNanos);
for( ; ; ) {
long timeoutMillis = (selectDeadLineNanos - currentTimeNanos + 500000L)/1000000L;
if(timeoutMillis <= 0) {
if(selectCnt == 0) {
selector.selectNow();
selectCnt=1;
}
break;
}
//If a task was submitted when wakenUp value was true, the task didn't get a chance to call
//Selector#wakeup. So we need to check task queue again before executing select operation.
//If wedon't, the task might be pended until select operation was timedout.
//It might be pended until idle timeout if IdleStateHandler existed inpipeline.
if(hasTasks() && wakenUp.compareAndSet(false, true)) {
selector.selectNow();
selectCnt = 1;
break;
}
int selectedKeys = selector.select(timeoutMillis);//否则阻塞给定时间，默认一秒
selectCnt++;
//如果 1 秒后返回，有返回值||select被用户唤醒||任务队列有任务||有定时任务即将被执行；则跳出循环
if(selectedKeys != 0 || oldWakenUp || wakenUp.get() || hasTasks() || hasScheduledTasks()) {
//-Selected something,
//-waken up by user,or
//-the task queue has apending task.
//-a scheduled task is ready for processing
break;
}
if(Thread.interrupted()) {
//Thread was interrupted so reset selected keys and break so we not run into a busy loop.
//As this is most likely a bug in the handler of the user or it's client library we will
//also log it.
//
//See https://github.com/netty/netty/issues/2426
if(logger.isDebugEnabled()) {
logger.debug("Selector.select() returned prematurely because " + " Thread.currentThread().interrupt() was called. Use " + " NioEventLoop.shutdownGracefully() to shutdowntheNioEventLoop.");
}
selectCnt = 1;
break;
}
long time = System.nanoTime();
if(time - TimeUnit.MILLISECONDS.toNanos(timeoutMillis) >= currentTimeNanos) {
//timeoutMillis elapsed without any thing selected.
selectCnt =1;
} else if(SELECTOR_AUTO_REBUILD_THRESHOLD > 0 && selectCnt >= SELECTOR_AUTO_REBUILD_THRESHOLD) {
//The selector returned prematurely many times in a row.
//Rebuild the selector to work around the problem.
logger.warn("Selector.select() returned prematurely {} times in a row; rebuilding Selector {}.", selectCnt, selector);
rebuildSelector();
selector = this.selector;
//Select again to populate selectedKeys.
selector.selectNow();
selectCnt = 1;
break;
}
currentTimeNanos = time;
}
if(selectCnt > MIN_PREMATURE_SELECTOR_RETURNS) {
if(logger.isDebugEnabled()) {
logger.debug("Selector.select()returned prematurely {} times in a row for Selector{}.", selectCnt - 1, selector);
}
}
} catch (CancelledKeyException e) {
if(logger.isDebugEnabled()) {
logger.debug(CancelledKeyException.class.getSimpleName() + "raisedbyaSelector {} - JDKbug?", selector, e);
}
//Harmless exception - log anyway
}
}
```
说明：调用 `selector` 的 `select` 方法，默认阻塞一秒钟，如果有定时任务，则在定时任务剩余时间的基础上在加上 `0.5` 秒进行阻塞。当执行 `execute` 方法的时候，也就是添加任务的时候，唤醒 `selector`，防止 `selector` 阻塞时间过长
5.`EventLoop` 作为 `Netty` 的核心的运行机制小结
1)每次执行 `execute` 方法都是向队列中添加任务。当第一次添加时就启动线程，执行 `run` 方法，而 `run` 方法是整个 `EventLoop` 的核心，就像 `EventLoop` 的名字一样，`LoopLoop`，不停的 `Loop`，`Loop` 做什么呢？做 `3` 件事情。
调用 `selector` 的 `select` 方法，默认阻塞一秒钟，如果有定时任务，则在定时任务剩余时间的基础上在加上 `0.5` 秒进行阻塞。当执行 `execute` 方法的时候，也就是添加任务的时候，唤醒 `selecor`，防止 `selector` 阻塞时间过长。
当 `selector` 返回的时候，回调用 `processSelectedKeys` 方法对 `selectKey` 进行处理。
当 `processSelectedKeys` 方法执行结束后，则按照 `ioRatio` 的比例执行 `runAllTasks` 方法，默认是 `IO` 任务时间和非 `IO` 任务时间是相同的，你也可以根据你的应用特点进行调优。比如非 `IO` 任务比较多，那么你就将
`ioRatio` 调小一点，这样非 `IO` 任务就能执行的长一点。防止队列积攒过多的任务。
## 10.8 handler 中加入线程池和 Context 中添加线程池的源码剖析
### 10.8.1 源码剖析目的
1. 在 `Netty` 中做耗时的，不可预料的操作，比如数据库，网络请求，会严重影响 `Netty` 对 `Socket` 的处理速度。
2. 而解决方法就是将耗时任务添加到异步线程池中。但就添加线程池这步操作来讲，可以有 `2` 种方式，而且这 `2` 种方式实现的区别也蛮大的。
3. 处理耗时业务的第一种方式 -- `handler` 中加入线程池
4. 处理耗时业务的第二种方式 -- `Context` 中添加线程池
5. 我们就来分析下两种方式
### 10.8.2 源码剖析
说明 演示两种方式的实现，以及从源码来追踪两种方式执行流程
11. 处理耗时业务的第一种方式 -- handler种加入线程池
11.1对前面的 `Netty` `demo`源码进行修改，在 `EchoServerHandler` 的 `channelRead` 方法进行异步
```java
@Sharable
public class EchoServerHandler extends ChannelInboundHandlerAdapter {
static final EventExecutorGroup group = new DefaultEventExecutorGroup(16);
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws UnsupportedEncodingException, InterruptedException {
final Object msgCop = msg;
final ChannelHandlerContext cxtCop = ctx;
group.submit(new Callable<Object>() {
@Override
public Object call() throws Exception {
ByteBuf buf = (ByteBuf)msgCop;
byte[] req = new byte[buf.readableBytes()];
buf.readBytes(req);
String body = new String(req, "UTF-8");
Thread.sleep(10 * 1000);
System.err.println(body + " " + Thread.currentThread().getName());
String reqString = "Helloiamserver~~~";
ByteBuf resp = Unpooled.copiedBuffer(reqString.getBytes());
cxtCop.writeAndFlush(resp);
return null;
}
});
System.out.println("goon..");
}
@Override
public void channelReadComplete(ChannelHandlerContext ctx) {
ctx.flush();
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
// Close the connection when an exception is raised.
cause.printStackTrace();
ctx.close();
}
}
```
说明：
1)在 `channelRead` 方法，模拟了一个耗时 `10` 秒的操作，这里，我们将这个任务提交到了一个自定义的业务线程池中，这样，就不会阻塞 `Netty` 的 `IO` 线程。
11.2这样处理之后，整个程序的逻辑如图
说明：
1)解释一下上图，当 `IO` 线程轮询到一个 `socket` 事件，然后，`IO` 线程开始处理，当走到耗时 `handler` 的时候，将耗时任务交给业务线程池。
2)当耗时任务执行完毕再执行 `pipeline write` 方法的时候，(代码中使用的是 `context` 的 `write` 方法，上图画的是执行 `pipeline` 方法，是一个意思)会将任务这个任务交给 `IO` 线程
11.3 `write` 方法的源码(在 `AbstractChannelHandlerContext` 类)
```java
private void write(Object msg, boolean flush, ChannelPromise promise) {
AbstractChannelHandlerContext next = findContextOutbound();
final Object m = pipeline.touch(msg, next);
EventExecutor executor = next.executor();
if(executor.inEventLoop()) {
if(flush) {
next.invokeWriteAndFlush(m, promise);
} else {
next.invokeWrite(m, promise);
}
} else {
AbstractWriteTask task;
if(flush) {
task = WriteAndFlushTask.newInstance(next, m, promise);
} else {
task = WriteTask.newInstance(next, m, promise);
}
safeExecute(executor, task, promise, m);
}
}
```
说明:
1)当判定下个 `outbound` 的 `executor` 线程不是当前线程的时候，会将当前的工作封装成 `task`，然后放入 `mpsc` 队列中，等待 `IO` 任务执行完毕后执行队列中的任务。
2)这里可以 Debug 来验证(提醒：Debug 时，服务器端 Debug, 客户端 `Run` 的方式)，当我们使用了 `group.submit(new Callable<Object> (){}` 在 `handler` 中加入线程池，就会进入到 `safeExecute(executor, task, promise, m);` 如果去掉这段代码，而使用普通方式来执行耗时的业务，那么就不会进入到 `safeExecute(executor, task, promise, m);`（说明：普通方式执行耗时代码，看我准备好的案例即可）
12.处理耗时业务的第二种方式 -`Context` 中添加线程池
1.1在添加 `pipeline` 中的 `handler` 时候，添加一个线程池
//属性
```java
static final EventExecutorGroup group = new DefaultEventExecutorGroup(16);
ServerBootstrap b = new ServerBootstrap();
b.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.option(ChannelOption.SO_BACKLOG, 100)
.handler(newLoggingHandler(LogLevel.INFO))
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
public void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline p = ch.pipeline();
if(sslCtx != null) {
p.addLast(sslCtx.newHandler(ch.alloc()));
}
//p.addLast(new LoggingHandler(LogLevel.INFO));
//p.addLast(new EchoServerHandler());
p.addLast(group, new EchoServerHandler());
}
});
```
说明：
1)`handler` 中的代码就使用普通的方式来处理耗时业务。
2)当我们在调用 `addLast` 方法添加线程池后，`handler` 将优先使用这个线程池，如果不添加，将使用 `IO` 线程
3)当走到 `AbstractChannelHandlerContext` 的 `invokeChannelRead` 方法的时候，`executor.inEventLoop()` 是不会通过的，因为当前线程是 `IO` 线程 `Context`（也就是 `Handler`）的 `executor` 是业务线程，所以会异步执行，debug 下源码
```java
static void invokeChannelRead(final AbstractChannelHandlerContext next, Object msg) {
final Object m = next.pipeline.touch(ObjectUtil.checkNotNull(msg, "msg"), next);
EventExecutor executor = next.executor();
if(executor.inEventLoop()) {
next.invokeChannelRead(m);
} else {
executor.execute(new Runnable() {//执行run
@Override
public void run() {
next.invokeChannelRead(m);
}
});
}
}
```
4)验证时，我们如果去掉 `p.addLast(group,newEchoServerHandler());` 改成 `p.addLastnewEchoServerHandler());` 你会发现代码不会进行异步执行。
5)后面的整个流程就变成和第一个方式一样了
13.两种方式的比较
1)第一种方式在 `handler` 中添加异步，可能更加的自由，比如如果需要访问数据库，那我就异步，如果不需要，就不异步，异步会拖长接口响应时间。因为需要将任务放进 `mpscTask` 中。如果 `IO` 时间很短，`task` 很多，可能一个循环下来，都没时间执行整个 `task`，导致响应时间达不到指标。
2)第二种方式是 `Netty` 标准方式(即加入到队列)，但是，这么做会将整个 `handler` 都交给业务线程池。不论耗时不耗时，都加入到队列里，不够灵活。
3)各有优劣，从灵活性考虑，第一种较好。
================================================
FILE: docs/_content/chapter11.md
================================================
## 11.1 RPC 基本介绍
1. `RPC（Remote Procedure Call）`—远程过程调用，是一个计算机通信协议。该协议允许运行于一台计算机的程序调用另一台计算机的子程序，而程序员无需额外地为这个交互作用编程
2. 两个或多个应用程序都分布在不同的服务器上，它们之间的调用都像是本地方法调用一样(如图)
3. 常见的 `RPC` 框架有：比较知名的如阿里的 `Dubbo`、`Google` 的 `gRPC`、`Go` 语言的 `rpcx`、`Apache` 的 `thrift`，`Spring` 旗下的 `SpringCloud`。
## 11.2 RPC 调用流程图
## 11.3 PRC 调用流程说明
1. 服务消费方（`client`）以本地调用方式调用服务
2. `client stub` 接收到调用后负责将方法、参数等封装成能够进行网络传输的消息体
3. `client stub` 将消息进行编码并发送到服务端
4. `server stub` 收到消息后进行解码
5. `server stub` 根据解码结果调用本地的服务
6. 本地服务执行并将结果返回给 `server stub`
7. `server stub` 将返回导入结果进行编码并发送至消费方
8. `client stub` 接收到消息并进行解码
9. 服务消费方（`client`）得到结果
小结：`RPC` 的目标就是将 `2 - 8` 这些步骤都封装起来，用户无需关心这些细节，可以像调用本地方法一样即可完成远程服务调用
## 11.4 自己实现 Dubbo RPC（基于 Netty）
### 11.4.1 需求说明
1. `Dubbo` 底层使用了 `Netty` 作为网络通讯框架，要求用 `Netty` 实现一个简单的 `RPC` 框架
2. 模仿 `Dubbo`，消费者和提供者约定接口和协议，消费者远程调用提供者的服务，提供者返回一个字符串，消费者打印提供者返回的数据。底层网络通信使用 `Netty 4.1.20`
### 11.4.2 设计说明
1. 创建一个接口，定义抽象方法。用于消费者和提供者之间的约定。
2. 创建一个提供者，该类需要监听消费者的请求，并按照约定返回数据。
3. 创建一个消费者，该类需要透明的调用自己不存在的方法，内部需要使用 `Netty` 请求提供者返回数据
4. 开发的分析图
### 11.4.3 代码实现
```java
package com.atguigu.netty.dubborpc.publicinterface;
//这个是接口，是服务提供方和 服务消费方都需要
public interface HelloService {
String hello(String mes);
}
package com.atguigu.netty.dubborpc.provider;
import com.atguigu.netty.dubborpc.publicinterface.HelloService;
public class HelloServiceImpl implements HelloService {
private static int count = 0;
//当有消费方调用该方法时， 就返回一个结果
@Override
public String hello(String mes) {
System.out.println("收到客户端消息=" + mes);
//根据mes 返回不同的结果
if (mes != null) {
return "你好客户端, 我已经收到你的消息 [" + mes + "] 第" + (++count) + " 次";
} else {
return "你好客户端, 我已经收到你的消息 ";
}
}
}
package com.atguigu.netty.dubborpc.provider;
import com.atguigu.netty.dubborpc.netty.NettyServer;
//ServerBootstrap 会启动一个服务提供者，就是 NettyServer
public class ServerBootstrap {
public static void main(String[] args) {
//代码代填..
NettyServer.startServer("127.0.0.1", 7000);
}
}
package com.atguigu.netty.dubborpc.netty;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.codec.string.StringDecoder;
import io.netty.handler.codec.string.StringEncoder;
public class NettyServer {
public static void startServer(String hostName, int port) {
startServer0(hostName, port);
}
//编写一个方法，完成对NettyServer的初始化和启动
private static void startServer0(String hostname, int port) {
EventLoopGroup bossGroup = new NioEventLoopGroup(1);
EventLoopGroup workerGroup = new NioEventLoopGroup();
try {
ServerBootstrap serverBootstrap = new ServerBootstrap();
serverBootstrap.group(bossGroup, workerGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline pipeline = ch.pipeline();
pipeline.addLast(new StringDecoder());
pipeline.addLast(new StringEncoder());
pipeline.addLast(new NettyServerHandler()); //业务处理器
}
}
);
ChannelFuture channelFuture = serverBootstrap.bind(hostname, port).sync();
System.out.println("服务提供方开始提供服务~~");
channelFuture.channel().closeFuture().sync();
} catch (Exception e) {
e.printStackTrace();
} finally {
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}
package com.atguigu.netty.dubborpc.netty;
import com.atguigu.netty.dubborpc.customer.ClientBootstrap;
import com.atguigu.netty.dubborpc.provider.HelloServiceImpl;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
//服务器这边handler比较简单
public class NettyServerHandler extends ChannelInboundHandlerAdapter {
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
//获取客户端发送的消息，并调用服务
System.out.println("msg=" + msg);
//客户端在调用服务器的api 时，我们需要定义一个协议
//比如我们要求 每次发消息是都必须以某个字符串开头 "HelloService#hello#你好"
if (msg.toString().startsWith(ClientBootstrap.providerName)) {
String result = new HelloServiceImpl().hello(msg.toString().substring(msg.toString().lastIndexOf("#") + 1));
ctx.writeAndFlush(result);
}
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
ctx.close();
}
}
package com.atguigu.netty.dubborpc.netty;
import io.netty.channel.ChannelHandlerContext;
import io.netty.channel.ChannelInboundHandlerAdapter;
import java.util.concurrent.Callable;
public class NettyClientHandler extends ChannelInboundHandlerAdapter implements Callable {
private ChannelHandlerContext context;//上下文
private String result; //返回的结果
private String para; //客户端调用方法时，传入的参数
//与服务器的连接创建后，就会被调用, 这个方法是第一个被调用(1)
@Override
public void channelActive(ChannelHandlerContext ctx) throws Exception {
System.out.println(" channelActive 被调用 ");
context = ctx; //因为我们在其它方法会使用到 ctx
}
//收到服务器的数据后，调用方法 (4)
//
@Override
public synchronized void channelRead(ChannelHandlerContext ctx, Object msg) throws Exception {
System.out.println(" channelRead 被调用 ");
result = msg.toString();
notify(); //唤醒等待的线程
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
ctx.close();
}
//被代理对象调用, 发送数据给服务器，-> wait -> 等待被唤醒(channelRead) -> 返回结果 (3)-》5
@Override
public synchronized Object call() throws Exception {
System.out.println(" call1 被调用 ");
context.writeAndFlush(para);
//进行wait
wait(); //等待channelRead 方法获取到服务器的结果后，唤醒
System.out.println(" call2 被调用 ");
return result; //服务方返回的结果
}
//(2)
void setPara(String para) {
System.out.println(" setPara ");
this.para = para;
}
}
package com.atguigu.netty.dubborpc.netty;
import io.netty.bootstrap.Bootstrap;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioSocketChannel;
import io.netty.handler.codec.string.StringDecoder;
import io.netty.handler.codec.string.StringEncoder;
import java.lang.reflect.Proxy;
import java.util.concurrent.Executor;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
public class NettyClient {
//创建线程池
private static ExecutorService executor = Executors.newFixedThreadPool(Runtime.getRuntime().availableProcessors());
private static NettyClientHandler client;
private int count = 0;
//编写方法使用代理模式，获取一个代理对象
public Object getBean(final Class<?> serivceClass, final String providerName) {
return Proxy.newProxyInstance(Thread.currentThread().getContextClassLoader(),
new Class<?>[]{serivceClass}, (proxy, method, args) -> {
System.out.println("(proxy, method, args) 进入...." + (++count) + " 次");
//{} 部分的代码，客户端每调用一次 hello, 就会进入到该代码
if (client == null) {
initClient();
}
//设置要发给服务器端的信息
//providerName 协议头 args[0] 就是客户端调用api hello(???), 参数
client.setPara(providerName + args[0]);
//
return executor.submit(client).get();
});
}
//初始化客户端
private static void initClient() {
client = new NettyClientHandler();
//创建EventLoopGroup
NioEventLoopGroup group = new NioEventLoopGroup();
Bootstrap bootstrap = new Bootstrap();
bootstrap.group(group)
.channel(NioSocketChannel.class)
.option(ChannelOption.TCP_NODELAY, true)
.handler(
new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ChannelPipeline pipeline = ch.pipeline();
pipeline.addLast(new StringDecoder());
pipeline.addLast(new StringEncoder());
pipeline.addLast(client);
}
}
);
try {
bootstrap.connect("127.0.0.1", 7000).sync();
} catch (Exception e) {
e.printStackTrace();
}
}
}
package com.atguigu.netty.dubborpc.customer;
import com.atguigu.netty.dubborpc.netty.NettyClient;
import com.atguigu.netty.dubborpc.publicinterface.HelloService;
public class ClientBootstrap {
//这里定义协议头
public static final String providerName = "HelloService#hello#";
public static void main(String[] args) throws Exception {
//创建一个消费者
NettyClient customer = new NettyClient();
//创建代理对象
HelloService service = (HelloService) customer.getBean(HelloService.class, providerName);
for (; ; ) {
Thread.sleep(2 * 1000);
//通过代理对象调用服务提供者的方法(服务)
String res = service.hello("你好 dubbo~");
System.out.println("调用的结果 res= " + res);
}
}
}
```
================================================
FILE: docs/_content/chapter_blank.md
================================================
================================================
FILE: docs/_coverpage.md
================================================
> 《尚硅谷 Netty 核心技术及源码剖析》课程学习手册
* 本课程不适合零基础的学员，需要掌握常用的设计模式和数据结构
* 掌握 Java 的面向对象编程、多线程编程、IO 编程、网络编程等知识
* 《Netty 核心源码剖析章节》内容学习最好有项目开发和阅读源码的经历
[](https://github.com/dongzl/netty-handbook)
[](https://github.com/dongzl/netty-handbook)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[GitHub](https://github.com/dongzl/netty-handbook/)
[Get Started](README.md)
================================================
FILE: docs/_navbar.md
================================================
<!-- * [En](/)
* [中文](/zh-cn/)-->
<!--
- Translations
- [:uk: English](/)
- [:cn: 中文](/zh-cn/)
- [:de: Deutsch](/de-de/)
- [:es: Spanish](/es/)
- [:ru: Russian](/ru-ru/)
-->
* [LeetCode Cookbook](https://books.halfrost.com/leetcode/)
* [算法小抄](https://labuladong.github.io/algo/)
================================================
FILE: docs/_sidebar.md
================================================
* [第 1 章 Netty 介绍和应用场景](_content/chapter01)
* [第 2 章 Java BIO 编程](_content/chapter02)
* [第 3 章 Java NIO 编程](_content/chapter03)
* [第 4 章 Netty 概述](_content/chapter04)
* [第 5 章 Netty 高性能架构设计](_content/chapter05)
* [第 6 章 Netty 核心模块组件](_content/chapter06)
* [第 7 章 Google Protobuf](_content/chapter07)
* [第 8 章 Netty 编解码器和 Handler 调用机制](_content/chapter08)
* [第 9 章 TCP 粘包和拆包及解决方案](_content/chapter09)
* [第 10 章 Netty 核心源码剖析](_content/chapter10)
* [第 11 章 用 Netty 自己实现 Dubbo RPC](_content/chapter11)
================================================
FILE: docs/guide.md
================================================
# 一级标题0
不会显示在侧边栏
# 一级标题1
显示
## 二级标题1
显示
### 三级标题1
设置的 subMaxLevel: 2 ，故三级标题不显示
# 一级标题2
显示
## 二级标题2{docsify-ignore}
{docsify-ignore} 省略当前标题
# 一级标题3{docsify-ignore-all}
{docsify-ignore-all} 省略其下所有标题
## 二级标题3
================================================
FILE: docs/index.html
================================================
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Netty 学习手册</title>
<link rel="icon" href="_media/netty_icon_16px.ico" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="description" content="Description">
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/lib/themes/vue.css">
<link rel="stylesheet" href="//unpkg.com/gitalk/dist/gitalk.css">
</head>
<body>
<div id="app"></div>
<!-- docsify-edit-on-github -->
<script src="//unpkg.com/docsify-edit-on-github/index.js"></script>
<script>
window.$docsify = {
name: 'Netty 学习手册',
repo: 'https://github.com/dongzl/netty-handbook/',
maxLevel: 5,//最大支持渲染的标题层级
subMaxLevel: 3,
homepage: 'README.md',
coverpage: true, // 封面
//loadSidebar: true, // 侧边栏
loadSidebar: true,
loadNavbar: true,
autoHeader: true,
notFoundPage: true, // 找不到页面时
auto2top: true,//切换页面后是否自动跳转到页面顶部
//全文搜索
search: {
//maxAge: 86400000, // 过期时间，单位毫秒，默认一天
paths: 'auto',
placeholder: '搜索',
noData: '未找到结果',
// 搜索标题的最大程级, 1 - 6
depth: 3,
},
plugins: [
EditOnGithubPlugin.create('https://github.com/dongzl/netty-handbook/edit/master/docs/')
],
pagination: {
previousText: '上一章节',
nextText: '下一章节',
crossChapter: true,
crossChapterText: false,
},
}
</script>
<script src="//unpkg.com/docsify/lib/docsify.min.js"></script>
<!--Java代码高亮-->
<script src="//unpkg.com/prismjs/components/prism-java.js"></script>
<script src="//unpkg.com/prismjs/components/prism-python.js"></script>
<!--全文搜索,直接用官方提供的无法生效-->
<script src="https://cdn.bootcss.com/docsify/4.5.9/plugins/search.min.js"></script>
<!-- 复制到剪贴板 -->
<script src="//unpkg.com/docsify-copy-code"></script>
<!-- emoji -->
<script src="//unpkg.com/docsify/lib/plugins/emoji.js"></script>
<!-- 图片缩放 -->
<script src="//unpkg.com/docsify/lib/plugins/zoom-image.js"></script>
<!-- 字数统计 -->
<script src="//unpkg.com/docsify-count/dist/countable.js"></script>
<!-- 分页 -->
<script src="//cdn.jsdelivr.net/npm/docsify-pagination/dist/docsify-pagination.min.js"></script>
<script src="//unpkg.com/docsify/lib/plugins/gitalk.min.js"></script>
<script src="//unpkg.com/gitalk/dist/gitalk.min.js"></script>
<script>
const gitalk = new Gitalk({
clientID: 'c1e19606899b2541abe8',
clientSecret: 'c0d3f8bbc64f76d65330c241a74dbe99d31dc49f',
repo: 'netty-handbook',
owner: 'dongzl',
admin: ['dongzl'],
id: location.pathname, // Ensure uniqueness and length less than 50
distractionFreeMode: false // Facebook-like distraction free mode
})
</script>
</body>
</html>
================================================
FILE: netty-code-atguigu/pom.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.netty.book</groupId>
<artifactId>netty-handbook</artifactId>
<version>1.0.0-SNAPSHOT</version>
</parent>
<groupId>com.netty.code.self</groupId>
<artifactId>netty-code-atguigu</artifactId>
<version>1.0.0-SNAPSHOT</version>
<name>netty-code-atguigu</name>
<description>《尚硅谷》Netty 课程代码</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>io.netty</groupId>
<artifactId>netty-all</artifactId> <!-- Use 'netty-all' for 4.0 or above -->
<version>4.1.51.Final</version>
<scope>compile</scope>
</dependency>
</dependencies>
<build>
</build>
</project>
================================================
FILE: netty-code-atguigu/src/main/java/atguigu/netty/example/echo2/EchoServer.java
================================================
/*
* Copyright 2012 The Netty Project
*
* The Netty Project licenses this file to you under the Apache License,
* version 2.0 (the "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*/
package atguigu.netty.example.echo2;
import io.netty.bootstrap.ServerBootstrap;
import io.netty.channel.ChannelFuture;
import io.netty.channel.ChannelInitializer;
import io.netty.channel.ChannelOption;
import io.netty.channel.ChannelPipeline;
import io.netty.channel.EventLoopGroup;
import io.netty.channel.nio.NioEventLoopGroup;
import io.netty.channel.socket.SocketChannel;
import io.netty.channel.socket.nio.NioServerSocketChannel;
import io.netty.handler.logging.LogLevel;
import io.netty.handler.logging.LoggingHandler;
import io.netty.handler.ssl.SslContext;
import io.netty.handler.ssl.SslContextBuilder;
import io.netty.handler.ssl.util.SelfSignedCertificate;
/**
* Echoes back any received data from a client.
*/
public final class EchoServer {
static final boolean SSL = System.getProperty("ssl") != null;
static final int PORT = Integer.parseInt(System.getProperty("port", "8007"));
public static void main(String[] args) throws Exception {
// Configure SSL.
final SslContext sslCtx;
if (SSL) {
SelfSignedCertificate ssc = new SelfSignedCertificate();
sslCtx = S
gitextract_i3jsrwsv/ ├── .gitignore ├── .travis.yml ├── LICENSE ├── README.md ├── docs/ │ ├── .nojekyll │ ├── README.md │ ├── _content/ │ │ ├── chapter01.md │ │ ├── chapter02.md │ │ ├── chapter03.md │ │ ├── chapter04.md │ │ ├── chapter05.md │ │ ├── chapter06.md │ │ ├── chapter07.md │ │ ├── chapter08.md │ │ ├── chapter09.md │ │ ├── chapter10.md │ │ ├── chapter11.md │ │ └── chapter_blank.md │ ├── _coverpage.md │ ├── _navbar.md │ ├── _sidebar.md │ ├── guide.md │ └── index.html ├── netty-code-atguigu/ │ ├── pom.xml │ └── src/ │ └── main/ │ └── java/ │ ├── atguigu/ │ │ └── netty/ │ │ └── example/ │ │ └── echo2/ │ │ ├── EchoServer.java │ │ └── EchoServerHandler.java │ └── com/ │ └── atguigu/ │ ├── bio/ │ │ └── BIOServer.java │ ├── netty/ │ │ ├── buf/ │ │ │ ├── NettyByteBuf01.java │ │ │ └── NettyByteBuf02.java │ │ ├── dubborpc/ │ │ │ ├── customer/ │ │ │ │ └── ClientBootstrap.java │ │ │ ├── netty/ │ │ │ │ ├── NettyClient.java │ │ │ │ ├── NettyClientHandler.java │ │ │ │ ├── NettyServer.java │ │ │ │ └── NettyServerHandler.java │ │ │ ├── provider/ │ │ │ │ ├── HelloServiceImpl.java │ │ │ │ └── ServerBootstrap.java │ │ │ └── publicinterface/ │ │ │ └── HelloService.java │ │ ├── groupchat/ │ │ │ ├── GroupChatClient.java │ │ │ ├── GroupChatClientHandler.java │ │ │ ├── GroupChatServer.java │ │ │ ├── GroupChatServerHandler.java │ │ │ └── User.java │ │ ├── heartbeat/ │ │ │ ├── MyServer.java │ │ │ ├── MyServerHandler.java │ │ │ └── Test.java │ │ ├── http/ │ │ │ ├── TestHttpServerHandler.java │ │ │ ├── TestServer.java │ │ │ └── TestServerInitializer.java │ │ ├── inboundhandlerandoutboundhandler/ │ │ │ └── MyByteToLongDecoder2.java │ │ ├── protocoltcp/ │ │ │ ├── MessageProtocol.java │ │ │ ├── MyClient.java │ │ │ ├── MyClientHandler.java │ │ │ ├── MyClientInitializer.java │ │ │ ├── MyMessageDecoder.java │ │ │ ├── MyMessageEncoder.java │ │ │ ├── MyServer.java │ │ │ ├── MyServerHandler.java │ │ │ └── MyServerInitializer.java │ │ ├── simple/ │ │ │ ├── NettyClient.java │ │ │ ├── NettyClientHandler.java │ │ │ ├── NettyServer.java │ │ │ ├── NettyServerHandler.java │ │ │ └── Test.java │ │ ├── tcp/ │ │ │ ├── MyClient.java │ │ │ ├── MyClientHandler.java │ │ │ ├── MyClientInitializer.java │ │ │ ├── MyServer.java │ │ │ ├── MyServerHandler.java │ │ │ └── MyServerInitializer.java │ │ └── websocket/ │ │ ├── MyServer.java │ │ ├── MyTextWebSocketFrameHandler.java │ │ └── hello.html │ └── nio/ │ ├── BasicBuffer.java │ ├── MappedByteBufferTest.java │ ├── NIOByteBufferPutGet.java │ ├── NIOFileChannel01.java │ ├── NIOFileChannel02.java │ ├── NIOFileChannel03.java │ ├── NIOFileChannel04.java │ ├── ReadOnlyBuffer.java │ ├── ScatteringAndGatheringTest.java │ ├── groupchat/ │ │ ├── GroupChatClient.java │ │ └── GroupChatServer.java │ └── zerocopy/ │ ├── NewIOClient.java │ └── NewIOServer.java ├── netty-code-self/ │ ├── pom.xml │ └── src/ │ └── main/ │ └── java/ │ └── com/ │ └── netty/ │ └── code/ │ └── self/ │ └── resp/ │ ├── EchoCommand.java │ ├── PingCommand.java │ ├── RespClientTest.java │ └── RespServerTest.java ├── netty-definitive-guide/ │ ├── pom.xml │ └── src/ │ └── main/ │ └── java/ │ └── com/ │ └── netty/ │ └── definitive/ │ └── guide/ │ ├── chapter2/ │ │ ├── section1/ │ │ │ ├── TimeClient.java │ │ │ ├── TimeServer.java │ │ │ └── TimeServerHandler.java │ │ ├── section2/ │ │ │ ├── TimeClient.java │ │ │ ├── TimeServer.java │ │ │ ├── TimeServerHandler.java │ │ │ └── TimeServerHandlerExecutePool.java │ │ ├── section3/ │ │ │ ├── MultiplexerTimeServer.java │ │ │ ├── TimeClient.java │ │ │ ├── TimeClientHandle.java │ │ │ └── TimeServer.java │ │ └── section4/ │ │ ├── AcceptCompletionHandler.java │ │ ├── AsyncTimeClientHandler.java │ │ ├── AsyncTimeServerHandler.java │ │ ├── ReadCompletionHandler.java │ │ ├── TimeClient.java │ │ └── TimeServer.java │ ├── chapter3/ │ │ ├── TimeClient.java │ │ ├── TimeClientHandler.java │ │ ├── TimeServer.java │ │ ├── TimeServerHandler.java │ │ └── timer/ │ │ ├── TimeServerHandler.java │ │ ├── TimerClient.java │ │ ├── TimerClientHandler.java │ │ └── TimerServer.java │ ├── chapter4/ │ │ ├── section2/ │ │ │ ├── TimeClient.java │ │ │ ├── TimeClientHandler.java │ │ │ ├── TimeServer.java │ │ │ └── TimeServerHandler.java │ │ └── section3/ │ │ ├── TimeClient.java │ │ ├── TimeClientHandler.java │ │ ├── TimeServer.java │ │ └── TimeServerHandler.java │ ├── chapter5/ │ │ ├── section1/ │ │ │ ├── EchoClient.java │ │ │ ├── EchoClientHandler.java │ │ │ ├── EchoServer.java │ │ │ └── EchoServerHandler.java │ │ └── section2/ │ │ ├── EchoClient.java │ │ ├── EchoClientHandler.java │ │ ├── EchoServer.java │ │ └── EchoServerHandler.java │ ├── chapter6/ │ │ ├── PerformTestUserInfo.java │ │ ├── TestUserInfo.java │ │ └── UserInfo.java │ ├── chapter7/ │ │ ├── EchoClient.java │ │ ├── EchoClientHandler.java │ │ ├── EchoServer.java │ │ ├── EchoServerHandler.java │ │ ├── MsgpackDecoder.java │ │ └── MsgpackEncoder.java │ ├── chapter8/ │ │ ├── SubReqClient.java │ │ ├── SubReqClientHandler.java │ │ ├── SubReqServer.java │ │ ├── SubReqServerHandler.java │ │ ├── SubscribeReqProto.java │ │ ├── SubscribeRespProto.java │ │ └── TestSubscribeReqProto.java │ └── chapter9/ │ ├── MarshallingCodeCFactory.java │ ├── SubReqClient.java │ ├── SubReqClientHandler.java │ ├── SubReqServer.java │ └── SubReqServerHandler.java └── pom.xml
SYMBOL INDEX (598 symbols across 126 files)
FILE: netty-code-atguigu/src/main/java/atguigu/netty/example/echo2/EchoServer.java
class EchoServer (line 36) | public final class EchoServer {
method main (line 41) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/atguigu/netty/example/echo2/EchoServerHandler.java
class EchoServerHandler (line 25) | @Sharable
method channelRead (line 28) | @Override
method channelReadComplete (line 33) | @Override
method exceptionCaught (line 38) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/bio/BIOServer.java
class BIOServer (line 14) | public class BIOServer {
method main (line 16) | public static void main(String[] args) throws Exception {
method handler (line 42) | public static void handler(Socket socket) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/buf/NettyByteBuf01.java
class NettyByteBuf01 (line 6) | public class NettyByteBuf01 {
method main (line 8) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/buf/NettyByteBuf02.java
class NettyByteBuf02 (line 8) | public class NettyByteBuf02 {
method main (line 10) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/customer/ClientBootstrap.java
class ClientBootstrap (line 6) | public class ClientBootstrap {
method main (line 11) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyClient.java
class NettyClient (line 19) | public class NettyClient {
method getBean (line 29) | public Object getBean(final Class<?> serivceClass, final String provid...
method initClient (line 51) | private static void initClient() {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyClientHandler.java
class NettyClientHandler (line 8) | public class NettyClientHandler extends ChannelInboundHandlerAdapter imp...
method channelActive (line 15) | @Override
method channelRead (line 23) | @Override
method exceptionCaught (line 30) | @Override
method call (line 36) | @Override
method setPara (line 48) | void setPara(String para) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyServer.java
class NettyServer (line 15) | public class NettyServer {
method startServer (line 18) | public static void startServer(String hostName, int port) {
method startServer0 (line 24) | private static void startServer0(String hostname, int port) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyServerHandler.java
class NettyServerHandler (line 9) | public class NettyServerHandler extends ChannelInboundHandlerAdapter {
method channelRead (line 11) | @Override
method exceptionCaught (line 24) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/provider/HelloServiceImpl.java
class HelloServiceImpl (line 5) | public class HelloServiceImpl implements HelloService {
method hello (line 10) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/provider/ServerBootstrap.java
class ServerBootstrap (line 6) | public class ServerBootstrap {
method main (line 8) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/publicinterface/HelloService.java
type HelloService (line 4) | public interface HelloService {
method hello (line 6) | String hello(String mes);
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatClient.java
class GroupChatClient (line 14) | public class GroupChatClient {
method GroupChatClient (line 20) | public GroupChatClient(String host, int port) {
method run (line 25) | public void run() throws Exception {
method main (line 64) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatClientHandler.java
class GroupChatClientHandler (line 6) | public class GroupChatClientHandler extends SimpleChannelInboundHandler<...
method channelRead0 (line 8) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatServer.java
class GroupChatServer (line 11) | public class GroupChatServer {
method GroupChatServer (line 15) | public GroupChatServer(int port) {
method run (line 20) | public void run() throws Exception {
method main (line 61) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatServerHandler.java
class GroupChatServerHandler (line 16) | public class GroupChatServerHandler extends SimpleChannelInboundHandler<...
method handlerAdded (line 31) | @Override
method handlerRemoved (line 46) | @Override
method channelActive (line 56) | @Override
method channelInactive (line 63) | @Override
method channelRead0 (line 70) | @Override
method exceptionCaught (line 86) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/User.java
class User (line 3) | public class User {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/heartbeat/MyServer.java
class MyServer (line 17) | public class MyServer {
method main (line 19) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/heartbeat/MyServerHandler.java
class MyServerHandler (line 7) | public class MyServerHandler extends ChannelInboundHandlerAdapter {
method userEventTriggered (line 14) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/heartbeat/Test.java
class Test (line 3) | public class Test {
method main (line 4) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/http/TestHttpServerHandler.java
class TestHttpServerHandler (line 17) | public class TestHttpServerHandler extends SimpleChannelInboundHandler<H...
method channelRead0 (line 20) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/http/TestServer.java
class TestServer (line 9) | public class TestServer {
method main (line 11) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/http/TestServerInitializer.java
class TestServerInitializer (line 8) | public class TestServerInitializer extends ChannelInitializer<SocketChan...
method initChannel (line 10) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/inboundhandlerandoutboundhandler/MyByteToLongDecoder2.java
class MyByteToLongDecoder2 (line 9) | public class MyByteToLongDecoder2 extends ReplayingDecoder<Void> {
method decode (line 11) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MessageProtocol.java
class MessageProtocol (line 4) | public class MessageProtocol {
method getLen (line 10) | public int getLen() {
method setLen (line 14) | public void setLen(int len) {
method getContent (line 18) | public byte[] getContent() {
method setContent (line 22) | public void setContent(byte[] content) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyClient.java
class MyClient (line 11) | public class MyClient {
method main (line 12) | public static void main(String[] args) throws Exception{
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyClientHandler.java
class MyClientHandler (line 8) | public class MyClientHandler extends SimpleChannelInboundHandler<Message...
method channelActive (line 12) | @Override
method channelRead0 (line 30) | protected void channelRead0(ChannelHandlerContext ctx, MessageProtocol...
method exceptionCaught (line 42) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyClientInitializer.java
class MyClientInitializer (line 8) | public class MyClientInitializer extends ChannelInitializer<SocketChanne...
method initChannel (line 9) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyMessageDecoder.java
class MyMessageDecoder (line 9) | public class MyMessageDecoder extends ReplayingDecoder<Void> {
method decode (line 11) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyMessageEncoder.java
class MyMessageEncoder (line 7) | public class MyMessageEncoder extends MessageToByteEncoder<MessageProtoc...
method encode (line 9) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyServer.java
class MyServer (line 10) | public class MyServer {
method main (line 11) | public static void main(String[] args) throws Exception{
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyServerHandler.java
class MyServerHandler (line 11) | public class MyServerHandler extends SimpleChannelInboundHandler<Message...
method exceptionCaught (line 15) | @Override
method channelRead0 (line 21) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyServerInitializer.java
class MyServerInitializer (line 10) | public class MyServerInitializer extends ChannelInitializer<SocketChanne...
method initChannel (line 12) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyClient.java
class NettyClient (line 11) | public class NettyClient {
method main (line 13) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyClientHandler.java
class NettyClientHandler (line 9) | public class NettyClientHandler extends ChannelInboundHandlerAdapter {
method channelActive (line 12) | @Override
method channelRead (line 19) | @Override
method exceptionCaught (line 26) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyServer.java
class NettyServer (line 13) | public class NettyServer {
method main (line 15) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyServerHandler.java
class NettyServerHandler (line 15) | public class NettyServerHandler extends ChannelInboundHandlerAdapter {
method channelRead (line 23) | @Override
method channelReadComplete (line 91) | @Override
method exceptionCaught (line 100) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/simple/Test.java
class Test (line 5) | public class Test {
method main (line 7) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyClient.java
class MyClient (line 11) | public class MyClient {
method main (line 12) | public static void main(String[] args) throws Exception{
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyClientHandler.java
class MyClientHandler (line 10) | public class MyClientHandler extends SimpleChannelInboundHandler<ByteBuf> {
method channelActive (line 14) | @Override
method channelRead0 (line 23) | @Override
method exceptionCaught (line 34) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyClientInitializer.java
class MyClientInitializer (line 8) | public class MyClientInitializer extends ChannelInitializer<SocketChanne...
method initChannel (line 9) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyServer.java
class MyServer (line 10) | public class MyServer {
method main (line 11) | public static void main(String[] args) throws Exception{
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyServerHandler.java
class MyServerHandler (line 11) | public class MyServerHandler extends SimpleChannelInboundHandler<ByteBuf> {
method exceptionCaught (line 15) | @Override
method channelRead0 (line 21) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyServerInitializer.java
class MyServerInitializer (line 10) | public class MyServerInitializer extends ChannelInitializer<SocketChanne...
method initChannel (line 12) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/websocket/MyServer.java
class MyServer (line 18) | public class MyServer {
method main (line 20) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/netty/websocket/MyTextWebSocketFrameHandler.java
class MyTextWebSocketFrameHandler (line 10) | public class MyTextWebSocketFrameHandler extends SimpleChannelInboundHan...
method channelRead0 (line 12) | @Override
method handlerAdded (line 22) | @Override
method handlerRemoved (line 30) | @Override
method exceptionCaught (line 36) | @Override
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/BasicBuffer.java
class BasicBuffer (line 10) | public class BasicBuffer {
method main (line 12) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/MappedByteBufferTest.java
class MappedByteBufferTest (line 10) | public class MappedByteBufferTest {
method main (line 12) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/NIOByteBufferPutGet.java
class NIOByteBufferPutGet (line 10) | public class NIOByteBufferPutGet {
method main (line 12) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel01.java
class NIOFileChannel01 (line 12) | public class NIOFileChannel01 {
method main (line 14) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel02.java
class NIOFileChannel02 (line 13) | public class NIOFileChannel02 {
method main (line 15) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel03.java
class NIOFileChannel03 (line 13) | public class NIOFileChannel03 {
method main (line 15) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel04.java
class NIOFileChannel04 (line 12) | public class NIOFileChannel04 {
method main (line 14) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/ReadOnlyBuffer.java
class ReadOnlyBuffer (line 10) | public class ReadOnlyBuffer {
method main (line 12) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/ScatteringAndGatheringTest.java
class ScatteringAndGatheringTest (line 13) | public class ScatteringAndGatheringTest {
method main (line 15) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/groupchat/GroupChatClient.java
class GroupChatClient (line 17) | public class GroupChatClient {
method GroupChatClient (line 27) | public GroupChatClient() throws IOException {
method sendInfo (line 42) | public void sendInfo(String info) {
method readInfo (line 52) | public void readInfo() {
method main (line 80) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/groupchat/GroupChatServer.java
class GroupChatServer (line 18) | public class GroupChatServer {
method GroupChatServer (line 28) | public GroupChatServer() {
method listen (line 45) | public void listen() {
method readData (line 84) | public void readData(SelectionKey key) {
method sendInfoToOtherClients (line 115) | private void sendInfoToOtherClients(String msg, SocketChannel self) th...
method main (line 134) | public static void main(String[] args) {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/zerocopy/NewIOClient.java
class NewIOClient (line 8) | public class NewIOClient {
method main (line 10) | public static void main(String[] args) throws Exception {
FILE: netty-code-atguigu/src/main/java/com/atguigu/nio/zerocopy/NewIOServer.java
class NewIOServer (line 10) | public class NewIOServer {
method main (line 12) | public static void main(String[] args) throws Exception {
FILE: netty-code-self/src/main/java/com/netty/code/self/resp/EchoCommand.java
class EchoCommand (line 13) | @Command("echo")
method execute (line 16) | @Override
FILE: netty-code-self/src/main/java/com/netty/code/self/resp/PingCommand.java
class PingCommand (line 13) | @Command("ping")
method execute (line 16) | @Override
FILE: netty-code-self/src/main/java/com/netty/code/self/resp/RespClientTest.java
class RespClientTest (line 12) | public class RespClientTest {
method main (line 14) | public static void main(String args[]) throws Exception {
FILE: netty-code-self/src/main/java/com/netty/code/self/resp/RespServerTest.java
class RespServerTest (line 11) | public class RespServerTest {
method main (line 13) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section1/TimeClient.java
class TimeClient (line 13) | public class TimeClient {
method main (line 15) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section1/TimeServer.java
class TimeServer (line 11) | public class TimeServer {
method main (line 13) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section1/TimeServerHandler.java
class TimeServerHandler (line 14) | public class TimeServerHandler implements Runnable {
method TimeServerHandler (line 18) | public TimeServerHandler(Socket socket) {
method run (line 22) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeClient.java
class TimeClient (line 13) | public class TimeClient {
method main (line 15) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeServer.java
class TimeServer (line 11) | public class TimeServer {
method main (line 13) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeServerHandler.java
class TimeServerHandler (line 14) | public class TimeServerHandler implements Runnable {
method TimeServerHandler (line 18) | public TimeServerHandler(Socket socket) {
method run (line 22) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeServerHandlerExecutePool.java
class TimeServerHandlerExecutePool (line 13) | public class TimeServerHandlerExecutePool {
method TimeServerHandlerExecutePool (line 17) | public TimeServerHandlerExecutePool(int maxPoolSize, int queueSize) {
method execute (line 21) | public void execute(Runnable task) {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/MultiplexerTimeServer.java
class MultiplexerTimeServer (line 19) | public class MultiplexerTimeServer implements Runnable {
method MultiplexerTimeServer (line 27) | public MultiplexerTimeServer(int port) {
method stop (line 41) | public void stop() {
method run (line 45) | @Override
method handleInput (line 81) | private void handleInput(SelectionKey key) throws Exception {
method doWrite (line 111) | private void doWrite(SocketChannel channel, String response) throws IO...
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/TimeClient.java
class TimeClient (line 8) | public class TimeClient {
method main (line 10) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/TimeClientHandle.java
class TimeClientHandle (line 16) | public class TimeClientHandle implements Runnable {
method TimeClientHandle (line 28) | public TimeClientHandle(String host, Integer port) {
method run (line 41) | @Override
method handleInput (line 83) | private void handleInput(SelectionKey key) throws Exception {
method doConnect (line 113) | private void doConnect() throws Exception {
method doWrite (line 122) | private void doWrite(SocketChannel sc) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/TimeServer.java
class TimeServer (line 8) | public class TimeServer {
method main (line 10) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/AcceptCompletionHandler.java
class AcceptCompletionHandler (line 12) | public class AcceptCompletionHandler implements CompletionHandler<Asynch...
method completed (line 14) | @Override
method failed (line 21) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/AsyncTimeClientHandler.java
class AsyncTimeClientHandler (line 14) | public class AsyncTimeClientHandler implements CompletionHandler<Void, A...
method AsyncTimeClientHandler (line 24) | public AsyncTimeClientHandler(String host, Integer port) {
method run (line 34) | @Override
method completed (line 50) | @Override
method failed (line 104) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/AsyncTimeServerHandler.java
class AsyncTimeServerHandler (line 12) | public class AsyncTimeServerHandler implements Runnable {
method AsyncTimeServerHandler (line 20) | public AsyncTimeServerHandler(int port) {
method run (line 31) | @Override
method doAccept (line 42) | public void doAccept() {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/ReadCompletionHandler.java
class ReadCompletionHandler (line 13) | public class ReadCompletionHandler implements CompletionHandler<Integer,...
method ReadCompletionHandler (line 17) | public ReadCompletionHandler(AsynchronousSocketChannel channel) {
method completed (line 23) | @Override
method doWrite (line 38) | private void doWrite(String currentTime) {
method failed (line 65) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/TimeClient.java
class TimeClient (line 8) | public class TimeClient {
method main (line 10) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/TimeServer.java
class TimeServer (line 8) | public class TimeServer {
method main (line 10) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeClient.java
class TimeClient (line 18) | public class TimeClient {
method main (line 20) | public static void main(String args[]) throws Exception {
method connect (line 32) | public void connect(int port, String host) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeClientHandler.java
class TimeClientHandler (line 13) | public class TimeClientHandler extends ChannelHandlerAdapter {
method TimeClientHandler (line 17) | public TimeClientHandler() {
method exceptionCaught (line 23) | @Override
method channelActive (line 28) | @Override
method channelRead (line 33) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeServer.java
class TimeServer (line 17) | public class TimeServer {
method bind (line 19) | public void bind(int port) throws Exception {
class ChildChannelHandler (line 35) | private class ChildChannelHandler extends ChannelInitializer<SocketCha...
method initChannel (line 36) | @Override
method main (line 42) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeServerHandler.java
class TimeServerHandler (line 15) | public class TimeServerHandler extends ChannelHandlerAdapter {
method channelRead (line 17) | @Override
method channelReadComplete (line 29) | @Override
method exceptionCaught (line 34) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimeServerHandler.java
class TimeServerHandler (line 15) | public class TimeServerHandler extends ChannelInboundHandlerAdapter {
method channelRead (line 16) | @Override
method exceptionCaught (line 33) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimerClient.java
class TimerClient (line 17) | public class TimerClient {
method connect (line 19) | public void connect(int port, String host) throws Exception {
method main (line 39) | public static void main(String[] args) {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimerClientHandler.java
class TimerClientHandler (line 13) | public class TimerClientHandler extends ChannelInboundHandlerAdapter {
method TimerClientHandler (line 16) | public TimerClientHandler() {
method channelActive (line 22) | @Override
method channelRead (line 27) | @Override
method exceptionCaught (line 36) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimerServer.java
class TimerServer (line 17) | public class TimerServer {
method bind (line 19) | public void bind(int port) throws Exception {
class ChildChannelHandler (line 38) | private class ChildChannelHandler extends ChannelInitializer<SocketCha...
method initChannel (line 39) | @Override
method main (line 45) | public static void main(String[] args) {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeClient.java
class TimeClient (line 17) | public class TimeClient {
method main (line 19) | public static void main(String args[]) throws Exception {
method connect (line 31) | public void connect(int port, String host) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeClientHandler.java
class TimeClientHandler (line 15) | public class TimeClientHandler extends ChannelHandlerAdapter {
method TimeClientHandler (line 23) | public TimeClientHandler() {
method exceptionCaught (line 27) | @Override
method channelActive (line 33) | @Override
method channelRead (line 43) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeServer.java
class TimeServer (line 17) | public class TimeServer {
method bind (line 19) | public void bind(int port) throws Exception {
class ChildChannelHandler (line 35) | private class ChildChannelHandler extends ChannelInitializer<SocketCha...
method initChannel (line 36) | @Override
method main (line 42) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeServerHandler.java
class TimeServerHandler (line 15) | public class TimeServerHandler extends ChannelHandlerAdapter {
method channelRead (line 19) | @Override
method channelReadComplete (line 32) | @Override
method exceptionCaught (line 37) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeClient.java
class TimeClient (line 19) | public class TimeClient {
method main (line 21) | public static void main(String args[]) throws Exception {
method connect (line 33) | public void connect(int port, String host) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeClientHandler.java
class TimeClientHandler (line 15) | public class TimeClientHandler extends ChannelHandlerAdapter {
method TimeClientHandler (line 23) | public TimeClientHandler() {
method exceptionCaught (line 27) | @Override
method channelActive (line 33) | @Override
method channelRead (line 43) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeServer.java
class TimeServer (line 19) | public class TimeServer {
method bind (line 21) | public void bind(int port) throws Exception {
class ChildChannelHandler (line 37) | private class ChildChannelHandler extends ChannelInitializer<SocketCha...
method initChannel (line 38) | @Override
method main (line 46) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeServerHandler.java
class TimeServerHandler (line 15) | public class TimeServerHandler extends ChannelHandlerAdapter {
method channelRead (line 19) | @Override
method channelReadComplete (line 29) | @Override
method exceptionCaught (line 34) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoClient.java
class EchoClient (line 23) | public class EchoClient {
method connect (line 25) | public void connect(int port, String host) throws Exception {
method main (line 48) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoClientHandler.java
class EchoClientHandler (line 12) | public class EchoClientHandler extends ChannelHandlerAdapter {
method EchoClientHandler (line 18) | public EchoClientHandler() {
method exceptionCaught (line 21) | @Override
method channelActive (line 27) | @Override
method channelRead (line 34) | @Override
method channelReadComplete (line 39) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoServer.java
class EchoServer (line 23) | public class EchoServer {
method bind (line 25) | public void bind(int port) throws Exception {
method main (line 50) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoServerHandler.java
class EchoServerHandler (line 13) | public class EchoServerHandler extends ChannelHandlerAdapter {
method exceptionCaught (line 17) | @Override
method channelRead (line 23) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoClient.java
class EchoClient (line 23) | public class EchoClient {
method connect (line 25) | public void connect(int port, String host) throws Exception {
method main (line 48) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoClientHandler.java
class EchoClientHandler (line 12) | public class EchoClientHandler extends ChannelHandlerAdapter {
method EchoClientHandler (line 18) | public EchoClientHandler() {
method exceptionCaught (line 21) | @Override
method channelActive (line 27) | @Override
method channelRead (line 34) | @Override
method channelReadComplete (line 39) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoServer.java
class EchoServer (line 24) | public class EchoServer {
method bind (line 26) | public void bind(int port) throws Exception {
method main (line 50) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoServerHandler.java
class EchoServerHandler (line 13) | public class EchoServerHandler extends ChannelHandlerAdapter {
method exceptionCaught (line 17) | @Override
method channelRead (line 23) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter6/PerformTestUserInfo.java
class PerformTestUserInfo (line 12) | public class PerformTestUserInfo {
method main (line 14) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter6/TestUserInfo.java
class TestUserInfo (line 11) | public class TestUserInfo {
method main (line 13) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter6/UserInfo.java
class UserInfo (line 11) | public class UserInfo implements Serializable {
method bindUserID (line 20) | public UserInfo bindUserID(int userID) {
method bindUserName (line 25) | public UserInfo bindUserName(String userName) {
method getUserName (line 30) | public String getUserName() {
method setUserName (line 34) | public void setUserName(String userName) {
method getUserID (line 38) | public int getUserID() {
method setUserID (line 42) | public void setUserID(int userID) {
method codeC (line 46) | public byte[] codeC() {
method codeC (line 59) | public byte[] codeC(ByteBuffer buffer) {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoClient.java
class EchoClient (line 17) | public class EchoClient {
method EchoClient (line 25) | public EchoClient(String host, int port, int sendNumber) {
method run (line 31) | public void run() throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoClientHandler.java
class EchoClientHandler (line 12) | public class EchoClientHandler extends ChannelHandlerAdapter {
method EchoClientHandler (line 16) | public EchoClientHandler(int sendNumber) {
method channelActive (line 20) | @Override
method UserInfo (line 29) | private UserInfo[] UserInfo() {
method channelRead (line 41) | @Override
method channelReadComplete (line 47) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoServer.java
class EchoServer (line 22) | public class EchoServer {
method bind (line 24) | public void bind(int port) throws Exception {
method main (line 48) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoServerHandler.java
class EchoServerHandler (line 11) | public class EchoServerHandler extends ChannelHandlerAdapter {
method exceptionCaught (line 15) | @Override
method channelRead (line 21) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/MsgpackDecoder.java
class MsgpackDecoder (line 15) | public class MsgpackDecoder extends MessageToMessageDecoder<ByteBuf> {
method decode (line 17) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/MsgpackEncoder.java
class MsgpackEncoder (line 13) | public class MsgpackEncoder extends MessageToByteEncoder<Object> {
method encode (line 15) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqClient.java
class SubReqClient (line 24) | public class SubReqClient {
method connect (line 26) | public void connect(int port, String host) throws Exception {
method main (line 50) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqClientHandler.java
class SubReqClientHandler (line 14) | public class SubReqClientHandler extends ChannelHandlerAdapter {
method SubReqClientHandler (line 16) | public SubReqClientHandler() {
method exceptionCaught (line 19) | @Override
method channelActive (line 25) | @Override
method subReq (line 33) | private SubscribeReqProto.SubscribeReq subReq(int i) {
method channelRead (line 46) | @Override
method channelReadComplete (line 51) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqServer.java
class SubReqServer (line 24) | public class SubReqServer {
method bind (line 26) | public void bind(int port) throws Exception {
method main (line 52) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqServerHandler.java
class SubReqServerHandler (line 12) | @ChannelHandler.Sharable
method exceptionCaught (line 15) | @Override
method channelRead (line 21) | @Override
method resp (line 30) | private SubscribeRespProto.SubscribeResp resp(int subReqID) {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubscribeReqProto.java
class SubscribeReqProto (line 6) | public final class SubscribeReqProto {
method SubscribeReqProto (line 7) | private SubscribeReqProto() {}
method registerAllExtensions (line 8) | public static void registerAllExtensions(
method registerAllExtensions (line 12) | public static void registerAllExtensions(
type SubscribeReqOrBuilder (line 17) | public interface SubscribeReqOrBuilder extends
method hasSubReqID (line 24) | boolean hasSubReqID();
method getSubReqID (line 28) | int getSubReqID();
method hasUserName (line 33) | boolean hasUserName();
method getUserName (line 37) | String getUserName();
method getUserNameBytes (line 41) | com.google.protobuf.ByteString
method hasProductName (line 47) | boolean hasProductName();
method getProductName (line 51) | String getProductName();
method getProductNameBytes (line 55) | com.google.protobuf.ByteString
method hasAddress (line 61) | boolean hasAddress();
method getAddress (line 65) | String getAddress();
method getAddressBytes (line 69) | com.google.protobuf.ByteString
class SubscribeReq (line 75) | public static final class SubscribeReq extends
method SubscribeReq (line 81) | private SubscribeReq(com.google.protobuf.GeneratedMessageV3.Builder<...
method SubscribeReq (line 84) | private SubscribeReq() {
method getUnknownFields (line 90) | @Override
method SubscribeReq (line 95) | private SubscribeReq(
method getDescriptor (line 156) | public static final com.google.protobuf.Descriptors.Descriptor
method internalGetFieldAccessorTable (line 161) | @Override
method hasSubReqID (line 175) | public boolean hasSubReqID() {
method getSubReqID (line 181) | public int getSubReqID() {
method hasUserName (line 190) | public boolean hasUserName() {
method getUserName (line 196) | public String getUserName() {
method getUserNameBytes (line 213) | public com.google.protobuf.ByteString
method hasProductName (line 232) | public boolean hasProductName() {
method getProductName (line 238) | public String getProductName() {
method getProductNameBytes (line 255) | public com.google.protobuf.ByteString
method hasAddress (line 274) | public boolean hasAddress() {
method getAddress (line 280) | public String getAddress() {
method getAddressBytes (line 297) | public com.google.protobuf.ByteString
method isInitialized (line 312) | @Override
method writeTo (line 338) | @Override
method getSerializedSize (line 356) | @Override
method equals (line 380) | @Override
method hashCode (line 414) | @Override
method parseFrom (line 442) | public static SubscribeReq parseFrom(
method parseFrom (line 447) | public static SubscribeReq parseFrom(
method parseFrom (line 453) | public static SubscribeReq parseFrom(
method parseFrom (line 458) | public static SubscribeReq parseFrom(
method parseFrom (line 464) | public static SubscribeReq parseFrom(byte[] data)
method parseFrom (line 468) | public static SubscribeReq parseFrom(
method parseFrom (line 474) | public static SubscribeReq parseFrom(java.io.InputStream input)
method parseFrom (line 479) | public static SubscribeReq parseFrom(
method parseDelimitedFrom (line 486) | public static SubscribeReq parseDelimitedFrom(java.io.InputStream in...
method parseDelimitedFrom (line 491) | public static SubscribeReq parseDelimitedFrom(
method parseFrom (line 498) | public static SubscribeReq parseFrom(
method parseFrom (line 504) | public static SubscribeReq parseFrom(
method newBuilderForType (line 512) | @Override
method newBuilder (line 514) | public static Builder newBuilder() {
method newBuilder (line 517) | public static Builder newBuilder(SubscribeReq prototype) {
method toBuilder (line 520) | @Override
method newBuilderForType (line 526) | @Override
class Builder (line 535) | public static final class Builder extends
method getDescriptor (line 539) | public static final com.google.protobuf.Descriptors.Descriptor
method internalGetFieldAccessorTable (line 544) | @Override
method Builder (line 553) | private Builder() {
method Builder (line 557) | private Builder(
method maybeForceBuilderInitialization (line 562) | private void maybeForceBuilderInitialization() {
method clear (line 567) | @Override
method getDescriptorForType (line 581) | @Override
method getDefaultInstanceForType (line 587) | @Override
method build (line 592) | @Override
method buildPartial (line 601) | @Override
method clone (line 627) | @Override
method setField (line 631) | @Override
method clearField (line 637) | @Override
method clearOneof (line 642) | @Override
method setRepeatedField (line 647) | @Override
method addRepeatedField (line 653) | @Override
method mergeFrom (line 659) | @Override
method mergeFrom (line 669) | public Builder mergeFrom(SubscribeReq other) {
method isInitialized (line 694) | @Override
method mergeFrom (line 711) | @Override
method hasSubReqID (line 735) | public boolean hasSubReqID() {
method getSubReqID (line 741) | public int getSubReqID() {
method setSubReqID (line 747) | public Builder setSubReqID(int value) {
method clearSubReqID (line 756) | public Builder clearSubReqID() {
method hasUserName (line 767) | public boolean hasUserName() {
method getUserName (line 773) | public String getUserName() {
method getUserNameBytes (line 790) | public com.google.protobuf.ByteString
method setUserName (line 806) | public Builder setUserName(
method clearUserName (line 819) | public Builder clearUserName() {
method setUserNameBytes (line 828) | public Builder setUserNameBytes(
method hasProductName (line 843) | public boolean hasProductName() {
method getProductName (line 849) | public String getProductName() {
method getProductNameBytes (line 866) | public com.google.protobuf.ByteString
method setProductName (line 882) | public Builder setProductName(
method clearProductName (line 895) | public Builder clearProductName() {
method setProductNameBytes (line 904) | public Builder setProductNameBytes(
method hasAddress (line 919) | public boolean hasAddress() {
method getAddress (line 925) | public String getAddress() {
method getAddressBytes (line 942) | public com.google.protobuf.ByteString
method setAddress (line 958) | public Builder setAddress(
method clearAddress (line 971) | public Builder clearAddress() {
method setAddressBytes (line 980) | public Builder setAddressBytes(
method setUnknownFields (line 990) | @Override
method mergeUnknownFields (line 996) | @Override
method getDefaultInstance (line 1012) | public static SubscribeReq getDefaultInstance() {
method parsePartialFrom (line 1018) | @Override
method parser (line 1027) | public static com.google.protobuf.Parser<SubscribeReq> parser() {
method getParserForType (line 1031) | @Override
method getDefaultInstanceForType (line 1036) | @Override
method getDescriptor (line 1049) | public static com.google.protobuf.Descriptors.FileDescriptor
method assignDescriptors (line 1065) | public com.google.protobuf.ExtensionRegistry assignDescriptors(
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubscribeRespProto.java
class SubscribeRespProto (line 6) | public final class SubscribeRespProto {
method SubscribeRespProto (line 7) | private SubscribeRespProto() {}
method registerAllExtensions (line 8) | public static void registerAllExtensions(
method registerAllExtensions (line 12) | public static void registerAllExtensions(
type SubscribeRespOrBuilder (line 17) | public interface SubscribeRespOrBuilder extends
method hasSubReqID (line 24) | boolean hasSubReqID();
method getSubReqID (line 28) | int getSubReqID();
method hasRespCode (line 33) | boolean hasRespCode();
method getRespCode (line 37) | String getRespCode();
method getRespCodeBytes (line 41) | com.google.protobuf.ByteString
method hasDesc (line 47) | boolean hasDesc();
method getDesc (line 51) | String getDesc();
method getDescBytes (line 55) | com.google.protobuf.ByteString
class SubscribeResp (line 61) | public static final class SubscribeResp extends
method SubscribeResp (line 67) | private SubscribeResp(com.google.protobuf.GeneratedMessageV3.Builder...
method SubscribeResp (line 70) | private SubscribeResp() {
method getUnknownFields (line 75) | @Override
method SubscribeResp (line 80) | private SubscribeResp(
method getDescriptor (line 135) | public static final com.google.protobuf.Descriptors.Descriptor
method internalGetFieldAccessorTable (line 140) | @Override
method hasSubReqID (line 154) | public boolean hasSubReqID() {
method getSubReqID (line 160) | public int getSubReqID() {
method hasRespCode (line 169) | public boolean hasRespCode() {
method getRespCode (line 175) | public String getRespCode() {
method getRespCodeBytes (line 192) | public com.google.protobuf.ByteString
method hasDesc (line 211) | public boolean hasDesc() {
method getDesc (line 217) | public String getDesc() {
method getDescBytes (line 234) | public com.google.protobuf.ByteString
method isInitialized (line 249) | @Override
method writeTo (line 271) | @Override
method getSerializedSize (line 286) | @Override
method equals (line 307) | @Override
method hashCode (line 336) | @Override
method parseFrom (line 360) | public static SubscribeResp parseFrom(
method parseFrom (line 365) | public static SubscribeResp parseFrom(
method parseFrom (line 371) | public static SubscribeResp parseFrom(
method parseFrom (line 376) | public static SubscribeResp parseFrom(
method parseFrom (line 382) | public static SubscribeResp parseFrom(byte[] data)
method parseFrom (line 386) | public static SubscribeResp parseFrom(
method parseFrom (line 392) | public static SubscribeResp parseFrom(java.io.InputStream input)
method parseFrom (line 397) | public static SubscribeResp parseFrom(
method parseDelimitedFrom (line 404) | public static SubscribeResp parseDelimitedFrom(java.io.InputStream i...
method parseDelimitedFrom (line 409) | public static SubscribeResp parseDelimitedFrom(
method parseFrom (line 416) | public static SubscribeResp parseFrom(
method parseFrom (line 422) | public static SubscribeResp parseFrom(
method newBuilderForType (line 430) | @Override
method newBuilder (line 432) | public static Builder newBuilder() {
method newBuilder (line 435) | public static Builder newBuilder(SubscribeResp prototype) {
method toBuilder (line 438) | @Override
method newBuilderForType (line 444) | @Override
class Builder (line 453) | public static final class Builder extends
method getDescriptor (line 457) | public static final com.google.protobuf.Descriptors.Descriptor
method internalGetFieldAccessorTable (line 462) | @Override
method Builder (line 471) | private Builder() {
method Builder (line 475) | private Builder(
method maybeForceBuilderInitialization (line 480) | private void maybeForceBuilderInitialization() {
method clear (line 485) | @Override
method getDescriptorForType (line 497) | @Override
method getDefaultInstanceForType (line 503) | @Override
method build (line 508) | @Override
method buildPartial (line 517) | @Override
method clone (line 539) | @Override
method setField (line 543) | @Override
method clearField (line 549) | @Override
method clearOneof (line 554) | @Override
method setRepeatedField (line 559) | @Override
method addRepeatedField (line 565) | @Override
method mergeFrom (line 571) | @Override
method mergeFrom (line 581) | public Builder mergeFrom(SubscribeResp other) {
method isInitialized (line 601) | @Override
method mergeFrom (line 615) | @Override
method hasSubReqID (line 639) | public boolean hasSubReqID() {
method getSubReqID (line 645) | public int getSubReqID() {
method setSubReqID (line 651) | public Builder setSubReqID(int value) {
method clearSubReqID (line 660) | public Builder clearSubReqID() {
method hasRespCode (line 671) | public boolean hasRespCode() {
method getRespCode (line 677) | public String getRespCode() {
method getRespCodeBytes (line 694) | public com.google.protobuf.ByteString
method setRespCode (line 710) | public Builder setRespCode(
method clearRespCode (line 723) | public Builder clearRespCode() {
method setRespCodeBytes (line 732) | public Builder setRespCodeBytes(
method hasDesc (line 747) | public boolean hasDesc() {
method getDesc (line 753) | public String getDesc() {
method getDescBytes (line 770) | public com.google.protobuf.ByteString
method setDesc (line 786) | public Builder setDesc(
method clearDesc (line 799) | public Builder clearDesc() {
method setDescBytes (line 808) | public Builder setDescBytes(
method setUnknownFields (line 818) | @Override
method mergeUnknownFields (line 824) | @Override
method getDefaultInstance (line 840) | public static SubscribeResp getDefaultInstance() {
method parsePartialFrom (line 846) | @Override
method parser (line 855) | public static com.google.protobuf.Parser<SubscribeResp> parser() {
method getParserForType (line 859) | @Override
method getDefaultInstanceForType (line 864) | @Override
method getDescriptor (line 877) | public static com.google.protobuf.Descriptors.FileDescriptor
method assignDescriptors (line 892) | public com.google.protobuf.ExtensionRegistry assignDescriptors(
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/TestSubscribeReqProto.java
class TestSubscribeReqProto (line 14) | public class TestSubscribeReqProto {
method encode (line 16) | private static byte[] encode(SubscribeReqProto.SubscribeReq req) {
method decode (line 20) | private static SubscribeReqProto.SubscribeReq decode(byte[] body) thro...
method createSubscribeReq (line 24) | private static SubscribeReqProto.SubscribeReq createSubscribeReq() {
method main (line 37) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/MarshallingCodeCFactory.java
class MarshallingCodeCFactory (line 18) | public final class MarshallingCodeCFactory {
method buildMarshallingDecoder (line 20) | public static MarshallingDecoder buildMarshallingDecoder() {
method buildMarshallingEncoder (line 29) | public static MarshallingEncoder buildMarshallingEncoder() {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqClient.java
class SubReqClient (line 19) | public class SubReqClient {
method connect (line 21) | public void connect(int port, String host) throws Exception {
method main (line 43) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqClientHandler.java
class SubReqClientHandler (line 15) | public class SubReqClientHandler extends ChannelHandlerAdapter {
method SubReqClientHandler (line 17) | public SubReqClientHandler() {
method exceptionCaught (line 20) | @Override
method channelActive (line 26) | @Override
method subReq (line 34) | private SubscribeReqProto.SubscribeReq subReq(int i) {
method channelRead (line 47) | @Override
method channelReadComplete (line 52) | @Override
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqServer.java
class SubReqServer (line 19) | public class SubReqServer {
method bind (line 21) | public void bind(int port) throws Exception {
method main (line 45) | public static void main(String args[]) throws Exception {
FILE: netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqServerHandler.java
class SubReqServerHandler (line 14) | @ChannelHandler.Sharable
method exceptionCaught (line 17) | @Override
method channelRead (line 23) | @Override
method resp (line 32) | private SubscribeRespProto.SubscribeResp resp(int subReqID) {
Condensed preview — 154 files, each showing path, character count, and a content snippet. Download the .json file or copy for the full structured content (540K chars).
[
{
"path": ".gitignore",
"chars": 299,
"preview": "# Compiled class file\n*.class\n\n# Log file\n*.log\n\n# BlueJ files\n*.ctxt\n\n# Mobile Tools for Java (J2ME)\n.mtj.tmp/\n\n# Packa"
},
{
"path": ".travis.yml",
"chars": 36,
"preview": "language: java\n\njdk:\n - oraclejdk8\n"
},
{
"path": "LICENSE",
"chars": 11357,
"preview": " Apache License\n Version 2.0, January 2004\n "
},
{
"path": "README.md",
"chars": 1107,
"preview": "\n\n[![stars](https://badgen.net/github/stars/dong"
},
{
"path": "docs/.nojekyll",
"chars": 0,
"preview": ""
},
{
"path": "docs/README.md",
"chars": 602,
"preview": "# 内容介绍\n\n本网站内容是根据**韩顺平**老师在尚硅谷开设的 `Netty` 学习课程《尚硅谷 Netty 视频教程》整理而来，所有内容、图片版权归尚硅谷和韩顺平老师所有，本人只是对其中部分文本、代码进行格式美化工作，对于其中部分图片内"
},
{
"path": "docs/_content/chapter01.md",
"chars": 1705,
"preview": "## 1.1 本课程学习要求\n\n1. 本课程不适用于 `0` 基础的学员。\n2. 要求已经掌握了 `Java` 编程，主要技术构成：`Java OOP` 编程、`Java` 多线程编程、`Java IO` 编程、`Java` 网络编程、常用"
},
{
"path": "docs/_content/chapter02.md",
"chars": 3965,
"preview": "## 2.1 I/O 模型\n\n### 2.1.1 模型基本说明\n\n1. `I/O` 模型简单的理解：就是用什么样的通道进行数据的发送和接收，很大程度上决定了程序通信的性能。\n2. `Java` 共支持 `3` 种网络编程模型 `I/O` 模"
},
{
"path": "docs/_content/chapter03.md",
"chars": 28979,
"preview": "## 3.1 Java NIO 基本介绍\n\n1. `Java NIO` 全称 **`Java non-blocking IO`** ，是指 `JDK` 提供的新 `API`。从 `JDK1.4` 开始，`Java` 提供了一系列改进的输入/"
},
{
"path": "docs/_content/chapter04.md",
"chars": 1273,
"preview": "## 4.1 原生 NIO 存在的问题\n\n1. `NIO` 的类库和 `API` 繁杂，使用麻烦：需要熟练掌握 `Selector`、`ServerSocketChannel`、`SocketChannel`、`ByteBuffer`等。\n"
},
{
"path": "docs/_content/chapter05.md",
"chars": 23774,
"preview": "## 5.1 线程模型基本介绍\n\n1. 不同的线程模式，对程序的性能有很大影响，为了搞清 `Netty` 线程模式，我们来系统的讲解下各个线程模式，最后看看 `Netty` 线程模型有什么优越性。\n2. 目前存在的线程模型有：传统阻塞 `I"
},
{
"path": "docs/_content/chapter06.md",
"chars": 25379,
"preview": "## 6.1 Bootstrap、ServerBootstrap\n\n1. `Bootstrap` 意思是引导，一个 `Netty` 应用通常由一个 `Bootstrap` 开始，主要作用是配置整个 `Netty` 程序，串联各个组件，`Ne"
},
{
"path": "docs/_content/chapter07.md",
"chars": 2782,
"preview": "## 7.1 编码和解码的基本介绍\n\n1. 编写网络应用程序时，因为数据在网络中传输的都是二进制字节码数据，在发送数据时就需要编码，接收数据时就需要解码[示意图]\n2. `codec`（编解码器）的组成部分有两个：`decoder`（解码器"
},
{
"path": "docs/_content/chapter08.md",
"chars": 3929,
"preview": "## 8.1 基本说明\n\n1. `Netty` 的组件设计：`Netty` 的主要组件有 `Channel`、`EventLoop`、`ChannelFuture`、`ChannelHandler`、`ChannelPipe` 等\n2. `"
},
{
"path": "docs/_content/chapter09.md",
"chars": 8260,
"preview": "## 9.1 TCP 粘包和拆包基本介绍\n\n1. `TCP` 是面向连接的，面向流的，提供高可靠性服务。收发两端（客户端和服务器端）都要有一一成对的 `socket`，因此，发送端为了将多个发给接收端的包，更有效的发给对方，使用了优化方法（"
},
{
"path": "docs/_content/chapter10.md",
"chars": 65525,
"preview": "## 10.1 基本说明\n\n1. 只有看过 `Netty` 源码，才能说是真的掌握了 `Netty` 框架。\n2. 在 `io.netty.example` 包下，有很多 `Netty` 源码案例，可以用来分析。\n3. 源码分析章节是针对有"
},
{
"path": "docs/_content/chapter11.md",
"chars": 10373,
"preview": "## 11.1 RPC 基本介绍\n\n1. `RPC（Remote Procedure Call）`—远程过程调用，是一个计算机通信协议。该协议允许运行于一台计算机的程序调用另一台计算机的子程序，而程序员无需额外地为这个交互作用编程\n2. 两"
},
{
"path": "docs/_content/chapter_blank.md",
"chars": 0,
"preview": ""
},
{
"path": "docs/_coverpage.md",
"chars": 645,
"preview": "\n\n> 《尚硅谷 Netty 核心技术及源码剖析》课程学习手册\n\n* 本课程不适合零基础的学员，需要掌握常用的设计模式和数据结构\n* 掌握 Java 的面向对象编程、多"
},
{
"path": "docs/_navbar.md",
"chars": 291,
"preview": "<!-- * [En](/)\n* [中文](/zh-cn/)-->\n\n<!--\n- Translations\n - [:uk: English](/)\n - [:cn: 中文](/zh-cn/)\n - [:de: Deutsch](/"
},
{
"path": "docs/_sidebar.md",
"chars": 498,
"preview": "* [第 1 章 Netty 介绍和应用场景](_content/chapter01)\n* [第 2 章 Java BIO 编程](_content/chapter02)\n* [第 3 章 Java NIO 编程](_content/cha"
},
{
"path": "docs/guide.md",
"chars": 219,
"preview": "# 一级标题0\n\n不会显示在侧边栏\n\n# 一级标题1\n\n显示\n\n## 二级标题1\n\n显示\n\n### 三级标题1\n\n设置的 subMaxLevel: 2 ，故三级标题不显示\n\n# 一级标题2\n\n显示\n\n## 二级标题2{docsify-ign"
},
{
"path": "docs/index.html",
"chars": 2925,
"preview": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <title>Netty 学习手册</title>\n <link rel=\"icon\" href=\"_m"
},
{
"path": "netty-code-atguigu/pom.xml",
"chars": 1070,
"preview": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http://maven.apache.org/POM/4.0.0\" xmlns:xsi=\"http://www.w3.org/2"
},
{
"path": "netty-code-atguigu/src/main/java/atguigu/netty/example/echo2/EchoServer.java",
"chars": 3338,
"preview": "/*\n * Copyright 2012 The Netty Project\n *\n * The Netty Project licenses this file to you under the Apache License,\n * ve"
},
{
"path": "netty-code-atguigu/src/main/java/atguigu/netty/example/echo2/EchoServerHandler.java",
"chars": 1396,
"preview": "/*\n * Copyright 2012 The Netty Project\n *\n * The Netty Project licenses this file to you under the Apache License,\n * ve"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/bio/BIOServer.java",
"chars": 2334,
"preview": "package com.atguigu.bio;\n\nimport java.io.InputStream;\nimport java.net.ServerSocket;\nimport java.net.Socket;\nimport java."
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/buf/NettyByteBuf01.java",
"chars": 1030,
"preview": "package com.atguigu.netty.buf;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n\npublic class NettyByte"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/buf/NettyByteBuf02.java",
"chars": 1429,
"preview": "package com.atguigu.netty.buf;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n\nimport java.nio.charse"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/customer/ClientBootstrap.java",
"chars": 748,
"preview": "package com.atguigu.netty.dubborpc.customer;\n\nimport com.atguigu.netty.dubborpc.netty.NettyClient;\nimport com.atguigu.ne"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyClient.java",
"chars": 2738,
"preview": "package com.atguigu.netty.dubborpc.netty;\n\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.ChannelInitiali"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyClientHandler.java",
"chars": 1527,
"preview": "package com.atguigu.netty.dubborpc.netty;\n\nimport io.netty.channel.ChannelHandlerContext;\nimport io.netty.channel.Channe"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyServer.java",
"chars": 2131,
"preview": "package com.atguigu.netty.dubborpc.netty;\n\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFu"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/netty/NettyServerHandler.java",
"chars": 1009,
"preview": "package com.atguigu.netty.dubborpc.netty;\n\nimport com.atguigu.netty.dubborpc.customer.ClientBootstrap;\nimport com.atguig"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/provider/HelloServiceImpl.java",
"chars": 528,
"preview": "package com.atguigu.netty.dubborpc.provider;\n\nimport com.atguigu.netty.dubborpc.publicinterface.HelloService;\n\npublic cl"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/provider/ServerBootstrap.java",
"chars": 303,
"preview": "package com.atguigu.netty.dubborpc.provider;\n\nimport com.atguigu.netty.dubborpc.netty.NettyServer;\n\n//ServerBootstrap 会启"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/dubborpc/publicinterface/HelloService.java",
"chars": 143,
"preview": "package com.atguigu.netty.dubborpc.publicinterface;\n\n//这个是接口，是服务提供方和 服务消费方都需要\npublic interface HelloService {\n\n Strin"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatClient.java",
"chars": 2257,
"preview": "package com.atguigu.netty.groupchat;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.*;\nimport io.netty.ch"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatClientHandler.java",
"chars": 378,
"preview": "package com.atguigu.netty.groupchat;\n\nimport io.netty.channel.ChannelHandlerContext;\nimport io.netty.channel.SimpleChann"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatServer.java",
"chars": 2182,
"preview": "package com.atguigu.netty.groupchat;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.*;\nimport io.ne"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/GroupChatServerHandler.java",
"chars": 2889,
"preview": "package com.atguigu.netty.groupchat;\n\nimport io.netty.channel.Channel;\nimport io.netty.channel.ChannelHandlerContext;\nim"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/groupchat/User.java",
"chars": 104,
"preview": "package com.atguigu.netty.groupchat;\n\npublic class User {\n private int id;\n private String pwd;\n}\n"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/heartbeat/MyServer.java",
"chars": 2633,
"preview": "package com.atguigu.netty.heartbeat;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFuture;\n"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/heartbeat/MyServerHandler.java",
"chars": 1198,
"preview": "package com.atguigu.netty.heartbeat;\n\nimport io.netty.channel.ChannelHandlerContext;\nimport io.netty.channel.ChannelInbo"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/heartbeat/Test.java",
"chars": 265,
"preview": "package com.atguigu.netty.heartbeat;\n\npublic class Test {\n public static void main(String[] args) throws Exception {\n"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/http/TestHttpServerHandler.java",
"chars": 2132,
"preview": "package com.atguigu.netty.http;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimport io.netty.channe"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/http/TestServer.java",
"chars": 969,
"preview": "package com.atguigu.netty.http;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFuture;\nimpor"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/http/TestServerInitializer.java",
"chars": 841,
"preview": "package com.atguigu.netty.http;\n\nimport io.netty.channel.ChannelInitializer;\nimport io.netty.channel.ChannelPipeline;\nim"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/inboundhandlerandoutboundhandler/MyByteToLongDecoder2.java",
"chars": 550,
"preview": "package com.atguigu.netty.inboundhandlerandoutboundhandler;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.channel.Cha"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MessageProtocol.java",
"chars": 409,
"preview": "package com.atguigu.netty.protocoltcp;\n\n//协议包\npublic class MessageProtocol {\n \n private int len; //关键\n \n pri"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyClient.java",
"chars": 831,
"preview": "package com.atguigu.netty.protocoltcp;\n\n\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.ChannelFuture;\nim"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyClientHandler.java",
"chars": 1505,
"preview": "package com.atguigu.netty.protocoltcp;\n\nimport io.netty.channel.ChannelHandlerContext;\nimport io.netty.channel.SimpleCha"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyClientInitializer.java",
"chars": 556,
"preview": "package com.atguigu.netty.protocoltcp;\n\nimport io.netty.channel.ChannelInitializer;\nimport io.netty.channel.ChannelPipel"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyMessageDecoder.java",
"chars": 844,
"preview": "package com.atguigu.netty.protocoltcp;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.channel.ChannelHandlerContext;\ni"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyMessageEncoder.java",
"chars": 522,
"preview": "package com.atguigu.netty.protocoltcp;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.channel.ChannelHandlerContext;\ni"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyServer.java",
"chars": 978,
"preview": "package com.atguigu.netty.protocoltcp;\n\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFutur"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyServerHandler.java",
"chars": 1477,
"preview": "package com.atguigu.netty.protocoltcp;\n\nimport io.netty.channel.ChannelHandlerContext;\nimport io.netty.channel.SimpleCha"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/protocoltcp/MyServerInitializer.java",
"chars": 553,
"preview": "package com.atguigu.netty.protocoltcp;\n\n\n\nimport io.netty.channel.ChannelInitializer;\nimport io.netty.channel.ChannelPip"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyClient.java",
"chars": 1519,
"preview": "package com.atguigu.netty.simple;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.ChannelFuture;\nimport io"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyClientHandler.java",
"chars": 1051,
"preview": "package com.atguigu.netty.simple;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimport io.netty.chan"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyServer.java",
"chars": 2954,
"preview": "package com.atguigu.netty.simple;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFuture;\nimp"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/simple/NettyServerHandler.java",
"chars": 3574,
"preview": "package com.atguigu.netty.simple;\n\nimport io.netty.buffer.Unpooled;\nimport io.netty.channel.ChannelHandlerContext;\nimpor"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/simple/Test.java",
"chars": 213,
"preview": "package com.atguigu.netty.simple;\n\nimport io.netty.util.NettyRuntime;\n\npublic class Test {\n \n public static void m"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyClient.java",
"chars": 823,
"preview": "package com.atguigu.netty.tcp;\n\n\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.ChannelFuture;\nimport io."
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyClientHandler.java",
"chars": 1208,
"preview": "package com.atguigu.netty.tcp;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimport io.netty.channel"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyClientInitializer.java",
"chars": 432,
"preview": "package com.atguigu.netty.tcp;\n\nimport io.netty.channel.ChannelInitializer;\nimport io.netty.channel.ChannelPipeline;\nimp"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyServer.java",
"chars": 970,
"preview": "package com.atguigu.netty.tcp;\n\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFuture;\nimpor"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyServerHandler.java",
"chars": 1137,
"preview": "package com.atguigu.netty.tcp;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimport io.netty.channel"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/tcp/MyServerInitializer.java",
"chars": 435,
"preview": "package com.atguigu.netty.tcp;\n\n\n\nimport io.netty.channel.ChannelInitializer;\nimport io.netty.channel.ChannelPipeline;\ni"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/websocket/MyServer.java",
"chars": 2893,
"preview": "package com.atguigu.netty.websocket;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.ChannelFuture;\n"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/websocket/MyTextWebSocketFrameHandler.java",
"chars": 1404,
"preview": "package com.atguigu.netty.websocket;\n\nimport io.netty.channel.ChannelHandlerContext;\nimport io.netty.channel.SimpleChann"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/netty/websocket/hello.html",
"chars": 1607,
"preview": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <title>Title</title>\n</head>\n<body>\n<script>\n "
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/BasicBuffer.java",
"chars": 791,
"preview": "package com.atguigu.nio;\n\nimport java.nio.IntBuffer;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2020/8/14 上午9:"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/MappedByteBufferTest.java",
"chars": 1022,
"preview": "package com.atguigu.nio;\n\nimport java.io.RandomAccessFile;\nimport java.nio.MappedByteBuffer;\nimport java.nio.channels.Fi"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/NIOByteBufferPutGet.java",
"chars": 710,
"preview": "package com.atguigu.nio;\n\nimport java.nio.ByteBuffer;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2020/8/14 下午5"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel01.java",
"chars": 1023,
"preview": "package com.atguigu.nio;\n\nimport java.io.FileOutputStream;\nimport java.nio.ByteBuffer;\nimport java.nio.channels.FileChan"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel02.java",
"chars": 967,
"preview": "package com.atguigu.nio;\n\nimport java.io.File;\nimport java.io.FileInputStream;\nimport java.nio.ByteBuffer;\nimport java.n"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel03.java",
"chars": 1399,
"preview": "package com.atguigu.nio;\n\nimport java.io.FileInputStream;\nimport java.io.FileOutputStream;\nimport java.nio.ByteBuffer;\ni"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/NIOFileChannel04.java",
"chars": 868,
"preview": "package com.atguigu.nio;\n\nimport java.io.FileInputStream;\nimport java.io.FileOutputStream;\nimport java.nio.channels.File"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/ReadOnlyBuffer.java",
"chars": 746,
"preview": "package com.atguigu.nio;\n\nimport java.nio.ByteBuffer;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2020/8/14 下午5"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/ScatteringAndGatheringTest.java",
"chars": 2187,
"preview": "package com.atguigu.nio;\n\nimport java.net.InetSocketAddress;\nimport java.nio.ByteBuffer;\nimport java.nio.channels.Server"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/groupchat/GroupChatClient.java",
"chars": 3278,
"preview": "package com.atguigu.nio.groupchat;\n\nimport java.io.IOException;\nimport java.net.InetSocketAddress;\nimport java.nio.ByteB"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/groupchat/GroupChatServer.java",
"chars": 4546,
"preview": "package com.atguigu.nio.groupchat;\n\nimport java.io.IOException;\nimport java.net.InetSocketAddress;\nimport java.nio.ByteB"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/zerocopy/NewIOClient.java",
"chars": 1041,
"preview": "package com.atguigu.nio.zerocopy;\n\nimport java.io.FileInputStream;\nimport java.net.InetSocketAddress;\nimport java.nio.ch"
},
{
"path": "netty-code-atguigu/src/main/java/com/atguigu/nio/zerocopy/NewIOServer.java",
"chars": 1131,
"preview": "package com.atguigu.nio.zerocopy;\n\nimport java.net.InetSocketAddress;\nimport java.net.ServerSocket;\nimport java.nio.Byte"
},
{
"path": "netty-code-self/pom.xml",
"chars": 990,
"preview": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http://maven.apache.org/POM/4.0.0\" xmlns:xsi=\"http://www.w3.org/2"
},
{
"path": "netty-code-self/src/main/java/com/netty/code/self/resp/EchoCommand.java",
"chars": 510,
"preview": "package com.netty.code.self.resp;\n\nimport com.github.tonivade.resp.annotation.Command;\nimport com.github.tonivade.resp.c"
},
{
"path": "netty-code-self/src/main/java/com/netty/code/self/resp/PingCommand.java",
"chars": 497,
"preview": "package com.netty.code.self.resp;\n\nimport com.github.tonivade.resp.annotation.Command;\nimport com.github.tonivade.resp.c"
},
{
"path": "netty-code-self/src/main/java/com/netty/code/self/resp/RespClientTest.java",
"chars": 941,
"preview": "package com.netty.code.self.resp;\n\nimport com.github.tonivade.resp.RespCallback;\nimport com.github.tonivade.resp.RespCli"
},
{
"path": "netty-code-self/src/main/java/com/netty/code/self/resp/RespServerTest.java",
"chars": 456,
"preview": "package com.netty.code.self.resp;\n\nimport com.github.tonivade.resp.RespServer;\nimport com.github.tonivade.resp.command.C"
},
{
"path": "netty-definitive-guide/pom.xml",
"chars": 1817,
"preview": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http://maven.apache.org/POM/4.0.0\" xmlns:xsi=\"http://www.w3.org/2"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section1/TimeClient.java",
"chars": 1750,
"preview": "package com.netty.definitive.guide.chapter2.section1;\n\nimport java.io.BufferedReader;\nimport java.io.InputStreamReader;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section1/TimeServer.java",
"chars": 1038,
"preview": "package com.netty.definitive.guide.chapter2.section1;\n\nimport java.net.ServerSocket;\nimport java.net.Socket;\n\n/**\n * @au"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section1/TimeServerHandler.java",
"chars": 1805,
"preview": "package com.netty.definitive.guide.chapter2.section1;\n\nimport java.io.BufferedReader;\nimport java.io.InputStreamReader;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeClient.java",
"chars": 1750,
"preview": "package com.netty.definitive.guide.chapter2.section2;\n\nimport java.io.BufferedReader;\nimport java.io.InputStreamReader;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeServer.java",
"chars": 1145,
"preview": "package com.netty.definitive.guide.chapter2.section2;\n\nimport java.net.ServerSocket;\nimport java.net.Socket;\n\n/**\n * @au"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeServerHandler.java",
"chars": 1805,
"preview": "package com.netty.definitive.guide.chapter2.section2;\n\nimport java.io.BufferedReader;\nimport java.io.InputStreamReader;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section2/TimeServerHandlerExecutePool.java",
"chars": 715,
"preview": "package com.netty.definitive.guide.chapter2.section2;\n\nimport java.util.concurrent.ArrayBlockingQueue;\nimport java.util."
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/MultiplexerTimeServer.java",
"chars": 4155,
"preview": "package com.netty.definitive.guide.chapter2.section3;\n\nimport java.io.IOException;\nimport java.net.InetSocketAddress;\nim"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/TimeClient.java",
"chars": 530,
"preview": "package com.netty.definitive.guide.chapter2.section3;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2019-04-14 21"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/TimeClientHandle.java",
"chars": 4052,
"preview": "package com.netty.definitive.guide.chapter2.section3;\n\nimport java.net.InetSocketAddress;\nimport java.nio.ByteBuffer;\nim"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section3/TimeServer.java",
"chars": 574,
"preview": "package com.netty.definitive.guide.chapter2.section3;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2019-04-14 21"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/AcceptCompletionHandler.java",
"chars": 873,
"preview": "package com.netty.definitive.guide.chapter2.section4;\n\nimport java.nio.ByteBuffer;\nimport java.nio.channels.Asynchronous"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/AsyncTimeClientHandler.java",
"chars": 3720,
"preview": "package com.netty.definitive.guide.chapter2.section4;\n\nimport java.net.InetSocketAddress;\nimport java.nio.ByteBuffer;\nim"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/AsyncTimeServerHandler.java",
"chars": 1193,
"preview": "package com.netty.definitive.guide.chapter2.section4;\n\nimport java.net.InetSocketAddress;\nimport java.nio.channels.Async"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/ReadCompletionHandler.java",
"chars": 2370,
"preview": "package com.netty.definitive.guide.chapter2.section4;\n\nimport java.nio.ByteBuffer;\nimport java.nio.channels.Asynchronous"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/TimeClient.java",
"chars": 570,
"preview": "package com.netty.definitive.guide.chapter2.section4;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2019-04-14 21"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter2/section4/TimeServer.java",
"chars": 577,
"preview": "package com.netty.definitive.guide.chapter2.section4;\n\n/**\n * @author dongzonglei\n * @description\n * @date 2019-04-14 21"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeClient.java",
"chars": 1728,
"preview": "package com.netty.definitive.guide.chapter3;\n\nimport com.netty.definitive.guide.chapter2.section4.AsyncTimeClientHandler"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeClientHandler.java",
"chars": 1162,
"preview": "package com.netty.definitive.guide.chapter3;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimport io"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeServer.java",
"chars": 1729,
"preview": "package com.netty.definitive.guide.chapter3;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.Channel"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/TimeServerHandler.java",
"chars": 1203,
"preview": "package com.netty.definitive.guide.chapter3;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimport io"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimeServerHandler.java",
"chars": 1270,
"preview": "package com.netty.definitive.guide.chapter3.timer;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimp"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimerClient.java",
"chars": 1571,
"preview": "package com.netty.definitive.guide.chapter3.timer;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.Channel"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimerClientHandler.java",
"chars": 1211,
"preview": "package com.netty.definitive.guide.chapter3.timer;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\nimp"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter3/timer/TimerServer.java",
"chars": 1704,
"preview": "package com.netty.definitive.guide.chapter3.timer;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.C"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeClient.java",
"chars": 1661,
"preview": "package com.netty.definitive.guide.chapter4.section2;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.Chan"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeClientHandler.java",
"chars": 1544,
"preview": "package com.netty.definitive.guide.chapter4.section2;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeServer.java",
"chars": 1738,
"preview": "package com.netty.definitive.guide.chapter4.section2;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channe"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section2/TimeServerHandler.java",
"chars": 1419,
"preview": "package com.netty.definitive.guide.chapter4.section2;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeClient.java",
"chars": 1922,
"preview": "package com.netty.definitive.guide.chapter4.section3;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.Chan"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeClientHandler.java",
"chars": 1415,
"preview": "package com.netty.definitive.guide.chapter4.section3;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeServer.java",
"chars": 1967,
"preview": "package com.netty.definitive.guide.chapter4.section3;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channe"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter4/section3/TimeServerHandler.java",
"chars": 1217,
"preview": "package com.netty.definitive.guide.chapter4.section3;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoClient.java",
"chars": 2214,
"preview": "package com.netty.definitive.guide.chapter5.section1;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.buffer.ByteB"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoClientHandler.java",
"chars": 1176,
"preview": "package com.netty.definitive.guide.chapter5.section1;\n\nimport io.netty.buffer.Unpooled;\nimport io.netty.channel.ChannelH"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoServer.java",
"chars": 2339,
"preview": "package com.netty.definitive.guide.chapter5.section1;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.buffer"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section1/EchoServerHandler.java",
"chars": 900,
"preview": "package com.netty.definitive.guide.chapter5.section1;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoClient.java",
"chars": 2223,
"preview": "package com.netty.definitive.guide.chapter5.section2;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.buffer.ByteB"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoClientHandler.java",
"chars": 1176,
"preview": "package com.netty.definitive.guide.chapter5.section2;\n\nimport io.netty.buffer.Unpooled;\nimport io.netty.channel.ChannelH"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoServer.java",
"chars": 2290,
"preview": "package com.netty.definitive.guide.chapter5.section2;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.buffer"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter5/section2/EchoServerHandler.java",
"chars": 714,
"preview": "package com.netty.definitive.guide.chapter5.section2;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.buffer.Unpooled;\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter6/PerformTestUserInfo.java",
"chars": 1465,
"preview": "package com.netty.definitive.guide.chapter6;\n\nimport java.io.ByteArrayOutputStream;\nimport java.io.ObjectOutputStream;\ni"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter6/TestUserInfo.java",
"chars": 907,
"preview": "package com.netty.definitive.guide.chapter6;\n\nimport java.io.ByteArrayOutputStream;\nimport java.io.ObjectOutputStream;\n\n"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter6/UserInfo.java",
"chars": 1634,
"preview": "package com.netty.definitive.guide.chapter6;\n\nimport java.io.Serializable;\nimport java.nio.ByteBuffer;\n\n/**\n * @author d"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoClient.java",
"chars": 1791,
"preview": "package com.netty.definitive.guide.chapter7;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.ChannelFuture"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoClientHandler.java",
"chars": 1414,
"preview": "package com.netty.definitive.guide.chapter7;\n\nimport com.netty.definitive.guide.chapter6.UserInfo;\nimport io.netty.chann"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoServer.java",
"chars": 2229,
"preview": "package com.netty.definitive.guide.chapter7;\n\nimport com.netty.definitive.guide.chapter5.section2.EchoServerHandler;\nimp"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/EchoServerHandler.java",
"chars": 640,
"preview": "package com.netty.definitive.guide.chapter7;\n\nimport io.netty.channel.ChannelHandlerAdapter;\nimport io.netty.channel.Cha"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/MsgpackDecoder.java",
"chars": 763,
"preview": "package com.netty.definitive.guide.chapter7;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.channel.ChannelHandlerCont"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter7/MsgpackEncoder.java",
"chars": 589,
"preview": "package com.netty.definitive.guide.chapter7;\n\nimport io.netty.buffer.ByteBuf;\nimport io.netty.channel.ChannelHandlerCont"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqClient.java",
"chars": 2481,
"preview": "package com.netty.definitive.guide.chapter8;\n\nimport com.netty.definitive.guide.chapter5.section2.EchoClient;\nimport io."
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqClientHandler.java",
"chars": 1607,
"preview": "package com.netty.definitive.guide.chapter8;\n\nimport io.netty.channel.ChannelHandlerAdapter;\nimport io.netty.channel.Cha"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqServer.java",
"chars": 2595,
"preview": "package com.netty.definitive.guide.chapter8;\n\nimport com.netty.definitive.guide.chapter7.EchoServer;\nimport io.netty.boo"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubReqServerHandler.java",
"chars": 1318,
"preview": "package com.netty.definitive.guide.chapter8;\n\nimport io.netty.channel.ChannelHandler;\nimport io.netty.channel.ChannelHan"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubscribeReqProto.java",
"chars": 33408,
"preview": "// Generated by the protocol buffer compiler. DO NOT EDIT!\n// source: netty/SubscribeReq.proto\n\npackage com.netty.defin"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/SubscribeRespProto.java",
"chars": 28027,
"preview": "// Generated by the protocol buffer compiler. DO NOT EDIT!\n// source: netty/SubscribeResp.proto\n\npackage com.netty.defi"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter8/TestSubscribeReqProto.java",
"chars": 1574,
"preview": "package com.netty.definitive.guide.chapter8;\n\nimport com.google.protobuf.InvalidProtocolBufferException;\n\nimport java.ut"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/MarshallingCodeCFactory.java",
"chars": 1708,
"preview": "package com.netty.definitive.guide.chapter9;\n\nimport io.netty.handler.codec.marshalling.DefaultMarshallerProvider;\nimpor"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqClient.java",
"chars": 1980,
"preview": "package com.netty.definitive.guide.chapter9;\n\nimport io.netty.bootstrap.Bootstrap;\nimport io.netty.channel.ChannelFuture"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqClientHandler.java",
"chars": 1672,
"preview": "package com.netty.definitive.guide.chapter9;\n\nimport com.netty.definitive.guide.chapter8.SubscribeReqProto;\nimport io.ne"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqServer.java",
"chars": 2105,
"preview": "package com.netty.definitive.guide.chapter9;\n\nimport io.netty.bootstrap.ServerBootstrap;\nimport io.netty.channel.Channel"
},
{
"path": "netty-definitive-guide/src/main/java/com/netty/definitive/guide/chapter9/SubReqServerHandler.java",
"chars": 1443,
"preview": "package com.netty.definitive.guide.chapter9;\n\nimport com.netty.definitive.guide.chapter8.SubscribeReqProto;\nimport com.n"
},
{
"path": "pom.xml",
"chars": 1156,
"preview": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<project xmlns=\"http://maven.apache.org/POM/4.0.0\" xmlns:xsi=\"http://www.w3.org/2"
}
]
About this extraction
This page contains the full source code of the dongzl/netty-handbook GitHub repository, extracted and formatted as plain text for AI agents and large language models (LLMs). The extraction includes 154 files (431.1 KB), approximately 121.6k tokens, and a symbol index with 598 extracted functions, classes, methods, constants, and types. Use this with OpenClaw, Claude, ChatGPT, Cursor, Windsurf, or any other AI tool that accepts text input. You can copy the full output to your clipboard or download it as a .txt file.
Extracted by GitExtract — free GitHub repo to text converter for AI. Built by Nikandr Surkov.