Netty 框架学习 —— 第一个 Netty 应用
概述
在本文,我们将编写一个基于 Netty 实现的客户端和服务端应用程序,相信通过学习该示例,一定能更全面的理解 Netty API
该图展示的是多个客户端同时连接到一台服务器。客户端建立一个连接后,会向服务器发送一个或多个消息,反过来,服务器又会将每个消息回送给客户端
编写 Echo 服务器
所有 Netty 服务器都需要以下两部分:
至少一个 CHannelHandler
该组件实现了服务器对从客户端接收的数据的处理,即它的业务逻辑
引导
配置服务器的启动代码,将服务器绑定到它要监听连接请求的端口上
1. ChannelHandler 和业务逻辑
ChannelHandler 是一个接口族的父接口,它的实现负责接收并响应事件通知,即要包含数据的处理逻辑。我们的 Echo 服务器需要响应传入的消息,所以需要实现 ChannelHandler 接口,用来定义响应入站事件的方法,又因为只需要用到少量的方法,所以继承 ChannelHandlerAdapter 类就足够了,它提供了 ChannelHandler 的默认实现
我们感兴趣的方法有:
channelRead()
对于每个传入的消息都要调用
channelReadComplete()
通知 ChannelHandler 最后一次对 channelRead() 的调用是当前批量读取的最后一条消息
exceptionCaught
在读取操作期间,有异常抛出时会调用
Echo 服务器的 ChannelHandler 实现 EchoServerHandler 如下
@ChannelHandler.Sharable // 标识一个 ChannelHandler 可以被多个 Channel 安全的共享
public class EchoServerHandler extends ChannelHandlerAdapter {
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) {
ByteBuf in = (ByteBuf) msg;
System.out.println("Server receiver: " + in.toString(CharsetUtil.UTF_8));
// 将接收到的消息写给发送者
ctx.write(in);
}
@Override
public void channelReadComplete(ChannelHandlerContext ctx) {
// 将剩余的消息全部冲刷到远程结点,并关闭 CHannel
ctx.writeAndFlush(Unpooled.EMPTY_BUFFER)
.addListener(ChannelFutureListener.CLOSE);
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
cause.printStackTrace();
ctx.close();
}
}
应用程序通过实现或者扩展 ChannelHandler 来挂钩到事件的生命周期,并且提供自定义的应用程序逻辑。ChannelHandler 有助于保持业务逻辑与网络处理代码的分离,简化了开发过程
2. 引导服务器
编写完 EchoServerHandler 实现的核心业务逻辑之后,我们现在探讨引导服务器的过程,具体涉及内容如下:
- 绑定服务器将在其上监听并接收传入连接请求的接口
- 配置 Channel,将入站消息交给 EchoServerHandler 实例
EchoServer 类完整代码如下
public class EchoServer {
private final int port;
public EchoServer(int port) {
this.port = port;
}
public static void main(String[] args) throws Exception {
if (args.length != 1) {
System.err.println("Usage: " + EchoServer.class.getSimpleName() + " <port>");
return;
}
int port = Integer.parseInt(args[0]);
new EchoServer(port).start();
}
public void start() throws Exception {
final EchoServerHandler serverHandler = new EchoServerHandler();
EventLoopGroup group = new NioEventLoopGroup();
try {
ServerBootstrap b = new ServerBootstrap();
b.group(group)
// 指定所使用的 NIO 传输 Channel
.channel(NioServerSocketChannel.class)
// 使用指定的端口设置套接字地址
.localAddress(new InetSocketAddress(port))
// 添加一个 EchoServerHandler 到子 Handler 的 ChannelPipeline
.childHandler(new ChannelInitializer<>() {
@Override
protected void initChannel(Channel ch) {
ch.pipeline().addLast(serverHandler);
}
});
// 异步地绑定服务器,调用 sync() 方法阻塞等待直到绑定完成
ChannelFuture f = b.bind().sync();
// 获取 Channel 的 CloseFuture,并且阻塞当前线程直到它完成
f.channel().closeFuture().sync();
} finally {
// 关闭 EventLoopGroup 释放所有资源
group.shutdownGracefully().sync();
}
}
}
到此为止,我们回顾一下服务器实现中的几个重要步骤:
- EchoServerHandler 实现业务逻辑
- main() 方法引导服务器
引导服务器过程的重要步骤如下:
- 创建一个 ServerBootstrap 的实例以引导和绑定服务器
- 创建并分配一个 NioEventLoopGroup 实例以进行事件的处理,如接受新连接以及读写数据
- 指定服务器绑定的本地的 InetSocketAddress
- 使用一个 EchoServerHandler 实例初始化每一个新的 Channel
- 调用 ServerBootstrap.bind() 方法以绑定服务器
编写 Echo 客户端
Echo 客户端的作用:
- 连接到服务器
- 发送一个或多个消息
- 对于每个消息,等待并接收从服务器返回的响应
- 关闭连接
和服务器一样,编写客户端所涉及的主要代码部分也是业务逻辑和引导
1. ChannelHandler 和客户端逻辑
客户端也要有一个用来处理数据的 ChannelHandler,这里选择 SimpleChannelInboundHandler 类处理所有必需的任务,要求重写下面的方法:
channelActive()
当与服务器的连接建立之后被调用
messageReceived()
当从服务器接收到一条消息时被调用
exceptionCaught()
在处理过程中引发异常时被调用
@ChannelHandler.Sharable
public class EchoClientHandler extends SimpleChannelInboundHandler<ByteBuf> {
@Override
public void channelActive(ChannelHandlerContext ctx) {
// 当一个连接建立时被调用,发送一条消息
ctx.writeAndFlush(Unpooled.copiedBuffer("Netty rocks!", CharsetUtil.UTF_8));
}
@Override
protected void messageReceived(ChannelHandlerContext ctx, ByteBuf msg) {
// 记录已接收消息的转储
System.out.println("Client received: " + msg.toString(CharsetUtil.UTF_8));
}
@Override
public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) {
// 发生异常时,记录错误并关闭 Channel
cause.printStackTrace();
ctx.close();
}
}
2. 引导客户端
引导客户端类似于服务器,不同的是,客户端是使用主机和端口参数来连接远程地址
public class EchoClient {
private final String host;
private final int port;
public EchoClient(String host, int port) {
this.host = host;
this.port = port;
}
public static void main(String[] args) throws Exception {
if (args.length != 1) {
System.err.println("Usage: " + EchoClient.class.getSimpleName() + "<host> <port>");
return;
}
String host = args[0];
int port = Integer.parseInt(args[1]);
new EchoClient(host, port).start();
}
public void start() throws Exception {
EventLoopGroup group = new NioEventLoopGroup();
try {
// 创建 Bootstrap
Bootstrap bootstrap = new Bootstrap();
bootstrap.group(group)
.channel(NioSocketChannel.class)
.remoteAddress(new InetSocketAddress(host, port))
.handler(new ChannelInitializer<SocketChannel>() {
@Override
protected void initChannel(SocketChannel ch) throws Exception {
ch.pipeline().addLast(new EchoClientHandler());
}
});
// 连接到远程节点,阻塞等待直到连接完成
ChannelFuture future = bootstrap.connect().sync();
// 阻塞,直到 Channel 关闭
future.channel().closeFuture().sync();
} finally {
group.shutdownGracefully().sync();
}
}
}
到此为止,我们回顾一下客户端实现中的几个重要步骤:
- 创建一个 Bootstrap 实例
- 创建并分配一个 NioEventLoopGroup 实例以进行事件的处理,其中事件处理包括创建新的连接以及处理入站和出站数据
- 为服务器连接创建一个 InetSocketAddress 实例
- 当连接建立时,一个 EchoClientHandler 实例会被安装到该 Channel 的 ChannelPipeline 中
- 调用 Bootstrap.connect() 方法连接远程节点
运行客户端和服务端
本文的项目使用 maven 构建,先启动服务端并准备好接受连接。然后启动客户端,一旦客户端建立连接,就会发送消息。服务器接收消息,控制台会打印如下信息:
Server receiver: Netty rocks!
同时将其回送给客户端,客户端的控制台也会打印如下消息,随后退出:
Client received: Netty rocks!
Netty 框架学习 —— 第一个 Netty 应用的更多相关文章
- DotNetty网络通信框架学习之初识Netty
p{ text-align:center; } blockquote > p > span{ text-align:center; font-size: 18px; color: #ff0 ...
- Netty 框架学习 —— 编解码器框架
编解码器 每个网络应用程序都必须定义如何解析在两个节点之间来回传输的原始字节,以及如何将其和目标应用程序的数据格式做相互转换.这种转换逻辑由编解码器处理,编解码器由编码器和解码器组成,它们每种都可以将 ...
- Netty 框架学习 —— Netty 组件与设计
Channel.EventLoop 和 ChannelFuture 这一节将对 Channel.EventLoop 和 ChannelFuture 类进行讨论,它们组合在一起,可以被认为是 Netty ...
- Netty 框架学习 —— ChannelHandler 与 ChannelPipeline
ChannelHandler 1. Channel 生命周期 Channel 的生命周期状态如下: 状态 描述 ChannelUnregistered Channel 已经被创建,但还未注册到 Eve ...
- Netty 框架学习 —— UDP 广播
UDP 广播 面向连接的传输(如 TCP)管理两个网络端点之间的连接的建立,在连接的生命周期的有序和可靠的消息传输,以及最后,连接的有序终止.相比之下,类似 UDP 的无连接协议中则没有持久化连接的概 ...
- Netty 框架学习 —— 引导
概述 前面我们学习了 ChannelPipeline.ChannelHandler 和 EventLoop 之后,接下来的问题是:如何将它们组织起来,成为一个可实际运行的应用程序呢?答案是使用引导(B ...
- Netty 框架学习 —— EventLoop 和线程模型
EventLoop 接口 Netty 是基于 Java NIO 的,因此 Channel 也有其生命周期,处理一个连接在其生命周期内发生的事件是所有网络框架的基本功能.通常来说,我们使用一个线程来处理 ...
- Netty 框架学习 —— 预置的 ChannelHandler 和编解码器
Netty 为许多提供了许多预置的编解码器和处理器,几乎可以开箱即用,减少了在烦琐事务上话费的时间和精力 空闲的连接和超时 检测空闲连接以及超时对于释放资源来说至关重要,Netty 特地为它提供了几个 ...
- Netty 框架学习 —— 传输
概述 流经网络的数据总是具有相同的类型:字节,这些字节如何传输主要取决于我们所说的网络传输.用户并不关心传输的细节,只在乎字节是否被可靠地发送和接收 如果使用 Java 网络编程,你会发现,某些时候当 ...
随机推荐
- HDOJ-3746(KMP+最小循环结)
Cyclic Nacklace HDOJ-3746 本题还是使用KMP算法,需要使用到前缀数组 利用前缀数组计算最小循环节:即t=n-pi[n-1]. 最后输出还需要的珠子,当然还有判断什么时候输出为 ...
- 盘点Excel中的那些有趣的“bug”
本文由葡萄城技术团队原创并首发 转载请注明出处:葡萄城官网,葡萄城为开发者提供专业的开发工具.解决方案和服务,赋能开发者. Excel 1.0早在1985年正式进入市场,距今已经有36年了,虽然在推出 ...
- 2020年HTML5考试模拟题整理(二)
1.以下是HTML5新增的标签是: AA.<aside>B.<isindex> C. <samp>D.<s>2.以下不是HTML5的新增的标签是: BA ...
- Linux速通01 操作系统安装及简介
操作系统 # a)操作系统的定义:操作系统是一个用来协调.管理和控制计算机硬件和软件资源的系统程序,它位于硬件和应用程序之间. # 操作系统分为 系统调用接口 和 系统内核 # b)操作系统内核的定义 ...
- ubuntu18.04+gunicorn+nginx+supervisor+mysql+redis安装django项目
Ubuntu18.04 install Django project 项目准备: ECS 实例 (云服务器) 此安装部署方案适合本地ubuntu18.04系统安装和虚拟机中ubuntu18.04系统安 ...
- 一款免费的在线 Markdown 笔记,类似 typora 编辑体验
为什么要开发一款新的编辑器 自从我开始使用 Markdown,就爱上了这种标记语法,轻量.纯文本兼容是最大的优点,哪里都可以编辑,一开始是在 IDE 上直接编辑,后来笔记越来越多,需要上传图片,有云同 ...
- Java流程控制:用户交互Scanner
java.util.Scanner工具类获取用户输入语法:Scanner scanner = new Scanner(System.in);通过Scanner类的next()与nextLine()方法 ...
- android分析之mutex
Android的锁是对Linux锁的一种包装: // ------------------------------------------------------------------------- ...
- Git Fetch failed解决办法
Git 下拉过程中,电脑死机了,重启后出现问题 找到的解决办法 https://blog.csdn.net/qq_33330887/article/details/80242206
- python常见错误和异常
1.BaseExeception 所有异常的基类 2.SystemEixt 解释器请求退出 3.KeyboardInterrupt 用户中断执行 4.Exception 常规错误的基类 5.StopI ...