02 你的第一个Netty应用

点击查看 《Netty in Action》笔记目录

本文是对《Netty in Action》第2章内容的笔记和翻译,主要内容包括:

  • 建立开发环境
  • 写一个回写应用的服务器和客户端
  • 构建和测试程序

搭建开发环境

  1. 下载和安装 JDK
  2. 下载和安装 IDE
  3. 下载和安装 Apache Maven
  4. 配置工具集

Netty 客户端和服务器概览

图2.1在一个较高的层次展示了将要写的回写客户端和服务端程序。


图2.1 回写程序的客户端和服务端

Echo 程序服务端

所有的 Netty 应用服务端都需要以下要素:

  • 至少一个 ChannelHandler:这个组件实现了服务端对接收到的客户端数据的处理,是业务的处理逻辑。
  • Bootstrapping :这是配置服务端的启动的代码。它至少会绑定服务端的某个端口,从而监听连接的请求。

ChannelHandlers 和业务逻辑

你需要实现 ChannelInboundHandler 接口。这个接口定义了输入事件的响应行为方法。这个简单的应用程序只需要实现这个接口的较少方法,所以继承 ChannelInboundHandlerAdapter 就足够了,这个类可以提供 ChannelInboundHandler 的一个默认实现。

我们将会对以下这些方法感兴趣:

  • channelRead() :每个数据输入的时候都会调用。
  • channelReadComplete() :通知 handler 最近一次 channelRead() 调用处理的是最后一条数据。
  • exceptionCaught() :在读数据过程如果抛出异常,则会调用这个方法。

当捕获异常时会发生什么?
每个 Channel 都会有一个关联的 ChannelPipeline(它持有了一个链式的 ChannelHandler 实例)。默认情况下, 一个 handler 会将方法调用传递给链中的下一个 hander。因此,如果 exceptionCaught() 在链中没有被实现,那么捕捉的异常会传递到 ChannelPipeline 的末端,并会被日志记录下来。基于这个原因,你的应用至少要提供一个实现了 exceptionCaught()ChannelHandler

启动服务端

服务的启动包括以下几个方面:

  • 绑定服务端将要监听的端口,并且接受将要到来的连接请求。
  • 配置 Channels 来通知 EchoServerHandler 实例即将到来的输入数据。

代码的主要组成部分包括:

  • EchoServerHandler 实现了基本的业务逻辑。
  • main() 函数负责启动服务器。

在启动过程中需要经历以下步骤:

  • 创建一个 ServerBootstrap 实例来启动和绑定服务。
  • 创建一个 NioEventLoopGroup 实例来进行事件处理,这些事件包括:接受新的连接、读写数据等。
  • 确定本地需要绑定的 InetSocketAddress
  • 为每个新的 Channel 分配一个 EchoServerHandler 实例。
  • 调用 ServerBootstrap.bind() 来绑定服务。

Echo 程序客户端

Echo 客户端将会做以下这些事情:

  1. 连接服务端。
  2. 发送一条或多条消息。
  3. 对于每条消息,等待服务器端发回同样的消息。
  4. 关闭连接。

通过 ChannelHandlers 实现客户端逻辑

和服务端相同,客户端将会有 ChannelInboundHandler 来处理数据。在这个类中,你将要扩展 SimpleChannelInboundHandler 来处理所有需要的任务,具体如清单2.3所示。这需要覆盖以下的这些方法:

  • channelActive():当与服务端的连接建立后会被调用。
  • channelRead0():当从服务端收到数据后会被调用。
  • exceptionCaught():当处理过程中发生异常时会被调用。

需要注意的是,服务器端发送过来的数据可能被分成多个小块。也就是说,如果服务端发送5个字节,那么并不能保证所有的5个字节都被一次收到。

SimpleChannelInboundHandler 对比 ChannelInboundHandler
两个方面的考量:业务逻辑是怎么样的、Netty 是如何管理资源的。

在客户端,当 channelRead0() 完成的时候, 你将接收并处理完毕输入的数据。当这个方法返回的时候,SimpleChannelInboundHandler 帮助我们释放用于存储消息的 ByteBuf 内存引用。

EchoServerHandler 中,你还需要将接收到的数据回显给发送端, 并且异步的 write()channelRead() 返回的时候还不一定可以完成(如列表 2.1 所示)。因此,EchoServerHandler 扩展了 ChannelInboundHandlerAdapter, 后者并没有在方法返回的时候释放消息所占用的资源。

当 EchoServerHandler 类的 channelReadComplete() 方法中的 writeAndFlush() 被调用后,消息将会被释放(如列表2.1所示)。

启动客户端

你可以在客户端和服务端之间使用不同的传输传输协议。例如,在服务端使用 NIO,在客户端使用 OIO。

客户端和服务端创建的要点总结如下:

  • 创建 Bootstrap 实例来初始化客户端。
  • 创建 NioEventLoopGroup 实例来进行事件处理,这些事件包括:接受新的连接、读写数据等。
  • 创建 InetSocketAddress 来帮助服务端建立来连接。
  • 当连接建立的时候,在流水线中安装 EchoClientHandler
  • 在所有的事情建立完毕后,将会调用 Bootstrap.connect() 来连接远端。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,393评论 5 467
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,790评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,391评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,703评论 1 270
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,613评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,003评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,507评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,158评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,300评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,256评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,274评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,984评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,569评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,662评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,899评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,268评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,840评论 2 339

推荐阅读更多精彩内容