Netty构建服务基本步骤

一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

基于netty构建服务的基本步骤

我们通过netty实现一个Http服务器的功能,来说明通过netty构建的Server基本步骤。
学习一个新的知识点,都是通过Hello world开始的,对于netty的学习写一个Hello world程序不像写其他程序那么简单,这里涉及很多非常重要的组件,比如ChannelHandler、EeventLoopGroup、ChannelPipeline等,这些组件随着后续不断学习再一一分析其实现原理。

基于netty构建Http服务器基本步骤实践

  1. 首先我们定义两个线程组 也叫做事件循环组
EevetLoopGroup bossGroup =  new NioEevetLoopGroup();
EevetLoopGroup workerGroup =  new NioEevetLoopGroup();

为什么定义两个线程组,实际上一个线程组也能完成所需的功能,不过netty建议我们使用两个线程组,分别具有不同的职责。bossGroup目的是获取客户端连接,连接接收到之后再将连接转发给workerGroup去处理。

  1. 定义一个轻量级的启动服务类
    ServerBootstrap serverBootstrap = new ServerBootstrap(); 
    serverBootstrap.group(bossGroup, wokrerGroup).channel(NioServerSocketChannel.class).childHandler(null);
    // 服务启动后通过绑定到8899端口上,返回ChannelFuture。
    ChannelFuture channelFuture = serverBootstrap.bind(8899).sync();
    channelFuture.channel().closeFuture().sync();
    
    ![类图](http://upload-images.jianshu.io/upload_images/3609866-5e0eaca91e925ef4.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
 
3. 通过ChannelPipeline初始化处理器,类似于拦截器Chain,当客户端首次连接后即调用initChannel方法完成初始化动作。
[示例代码]

public class TestServerInitializer extends ChannelInitializer<SocketChannel>{

// 初始化器,服务端启动后会自动调用这个方法,它是一个回调方法。
@Override protected void initChannel(SocketChannel ch) throws Exception {
    System.out.println("initChannel invoked... "); // 有客户端连接就会执行.
    ChannelPipeline channelPipeline = ch.pipeline(); // pipeline一个管道里面可以有很多的ChannelHandler,相当于包含很多个拦截器。
    // 添加处理器,可以添加多个,并且可以将处理器放到pipeline管道的不同位置上。
    channelPipeline.addLast("httpServerCodec", new HttpServerCodec()); //HttpServerCodec也是一个很重要的组件.
    channelPipeline.addLast("httpServerHandler", new TestHttpServerHandler()); // 自定义处理器
}

}

4. 创建自定义处理器,通常继承SimpleChannelInboundHandler<T>,  该处理器覆写channelRead0方法,该方法负责请求接入,读取客户端请求,发送响应给客户端。
[示例代码]

public class TestHttpServerHandler extends SimpleChannelInboundHandler<HttpObject> {

private final String FAVICON_ICO = "/favicon.ico";

// 读取客户端请求,向客户端响应的方法,所以这里要构造响应返回给客户端。
// 注意:这里面跟Servlet没有任何关系,也符合Servlet规范,所以不会涉及到HttpServerltRequest和HttpServeletResponse对象。
@Override protected void channelRead0(ChannelHandlerContext ctx, HttpObject msg) throws Exception {
    System.out.println("--------------httpserverHandler, remote_address " + ctx.channel().remoteAddress() + ", msg_class:" + msg.getClass());

// Thread.sleep(3000); // 休眠5秒钟,lsof -i:8899 查看TCP连接状态

    if (msg instanceof HttpRequest) {
        HttpRequest httpRequest = (HttpRequest) msg;
        URI uri = new URI(httpRequest.uri());
        System.out.println("请求方法: " + httpRequest.method() + ", 请求path: " + uri.getPath());

        if (FAVICON_ICO.equals(uri.getPath())) {
            System.out.println("请求/favicon.ico");
            return;
        }
        // BytBuf:构造给客户端的响应内容, 制定好编码
        ByteBuf byteBuf = Unpooled.copiedBuffer("Hello World", CharsetUtil.UTF_8);

        // 接下构造响应对象
        FullHttpResponse response = new DefaultFullHttpResponse(HttpVersion.HTTP_1_1, HttpResponseStatus.OK, byteBuf);
        response.headers().set(HttpHeaderNames.CONTENT_LENGTH, byteBuf.readableBytes());
        response.headers().set(HttpHeaderNames.CONTENT_TYPE, "text/plain");

        // 调用flush才会将内容真正返回给客户端
        System.out.println("响应给客户端对象: " + response);
        ctx.writeAndFlush(response);
        ctx.channel().closeFuture();
    }

}

//------以下重写了ChannelInboundHandlerAdapter父类的方法,分析不同事件方法的调用时机------
@Override public void channelRegistered(ChannelHandlerContext ctx) throws Exception {
    System.out.println("channel register invoked");
    super.channelRegistered(ctx);
}

@Override public void channelUnregistered(ChannelHandlerContext ctx) throws Exception {
    System.out.println("channel unregister invoked");
    super.channelUnregistered(ctx);
}

@Override public void channelActive(ChannelHandlerContext ctx) throws Exception {
    System.out.println("channel active invoked");
    super.channelActive(ctx);
}

@Override public void channelInactive(ChannelHandlerContext ctx) throws Exception {
    System.out.println("channel inactive invoked");
    super.channelInactive(ctx);
}

@Override public void channelReadComplete(ChannelHandlerContext ctx) throws Exception {
    System.out.println("channel read complete");
    super.channelReadComplete(ctx);
}

@Override public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
    System.out.println("exception caught invoked");
    super.exceptionCaught(ctx, cause);
}

@Override public void handlerAdded(ChannelHandlerContext ctx) throws Exception {
    System.out.println("handler add invoked");
    super.handlerAdded(ctx);
}

}

这里注意,我使用的netty4.x版本,方法名叫做channelRead0,如果在其他文章中看到是messageReceived方法,则使用的是netty5.x,另外,因netty5.x已被废弃,故建议都使用netty4.x稳定版。
5. 将步骤1和2整合,写Main方法启动服务
[示例代码]

public class TestNettyServer {
public static void main(String[] args) throws InterruptedException {
// 服务器端可以理解为while(true){}死循环,去不断的接受请求连接。 EventLoopGroup bossGroup = new NioEventLoopGroup();
EventLoopGroup workerGroup = new NioEventLoopGroup();
try {
ServerBootstrap serverBootstrap = new ServerBootstrap(); // 启动服务端,这里的处理器都要是多实例的. serverBootstrap.group(bossGroup, workerGroup).channel(NioServerSocketChannel.class).childHandler(new TestServerInitializer());
System.out.println("服务端已启动..");
ChannelFuture channelFuture = serverBootstrap.bind(8899).sync();
channelFuture.channel().closeFuture().sync();
} finally {
System.out.println("服务端shutdown");
bossGroup.shutdownGracefully();
workerGroup.shutdownGracefully();
}
}
}

6. 通过浏览器或者curl方式访问8899端口。
最后,通过 curl ‘localhost:8899’访问成功返回Hello World字符串,
如果TestHttpServerHandler的channelRead0中不加msg instanceof HttpRequest的判断,则运行时会抛出如下异常:

java.io.IOException: Connection reset by peer
at sun.nio.ch.FileDispatcherImpl.read0(Native Method)
at sun.nio.ch.SocketDispatcher.read(SocketDispatcher.java:39)
at sun.nio.ch.IOUtil.readIntoNativeBuffer(IOUtil.java:223)
at sun.nio.ch.IOUtil.read(IOUtil.java:192)
at sun.nio.ch.SocketChannelImpl.read(SocketChannelImpl.java:380)
at io.netty.buffer.PooledUnsafeDirectByteBuf.setBytes(PooledUnsafeDirectByteBuf.java:288)
at io.netty.buffer.AbstractByteBuf.writeBytes(AbstractByteBuf.java:1100)
at io.netty.channel.socket.nio.NioSocketChannel.doReadBytes(NioSocketChannel.java:372)
at io.netty.channel.nio.AbstractNioByteChannelNioByteUnsafe.read(AbstractNioByteChannel.java:123) at io.netty.channel.nio.NioEventLoop.processSelectedKey(NioEventLoop.java:644) at io.netty.channel.nio.NioEventLoop.processSelectedKeysOptimized(NioEventLoop.java:579) at io.netty.channel.nio.NioEventLoop.processSelectedKeys(NioEventLoop.java:496) at io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:458) at io.netty.util.concurrent.SingleThreadEventExecutor5.run(SingleThreadEventExecutor.java:858)
at io.netty.util.concurrent.DefaultThreadFactory$DefaultRunnableDecorator.run(DefaultThreadFactory.java:138)
at java.lang.Thread.run(Thread.java:745)

debug代码时会发现有2个请求执行了channelRead0方法,两个msg分别是
--------------httpserverHandler msg:class io.netty.handler.codec.http.DefaultHttpRequest
--------------httpserverHandler msg:class io.netty.handler.codec.http.LastHttpContent$1
我们看到第二次请求并不是HttpRequest对象,所以此处理器无法处理,通过浏览器访问时,浏览器会自动的发起favion.cio图片的请求,所以可以增加个判断如果path是favion.cio则不往下执行。
![自定义处理器实现类图](http://upload-images.jianshu.io/upload_images/3609866-d5f324f513f98fd3.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
TestHttpServerHandler是自己实现的处理器,继承了SimpleChannelInboundHandler,SimpleChannelInboundHandler继承了ChannelInboundHandlerAdapter类。
**子类可重写的方法及其含义**:
`channelActive() `           >在到服务器的连接已经建立之后将被调用(成为活跃状态)
` channelRead0()`           > 当从服务器接受到一条消息时被调用
` exceptionCaught()`        >在处理过程中引发异常时调用
` channelReigster() `        >注册到EventLoop上
` handlerAdd() `                >Channel被添加方法
` handlerRemoved()`        >Channel被删除方法
` channelInActive() `         > Channel离开活跃状态,不再连接到某一远端时被调用
` channelUnRegistered()` >Channel从EventLoop上解除注册
` channelReadComplete()` >当Channel上的某个读操作完成时被调用
在步骤4中有打印输出,通过curl ‘http://localhost:8899'访问,执行结果顺序:

服务端已启动..
initChannel invoked...
handler add invoked
channel register invoked
channel active invoked
--------------httpserverHandler, remote_address /127.0.0.1:50061, msg_class:class io.netty.handler.codec.http.DefaultHttpRequest
请求方法: GET, 请求path: /
响应给客户端对象: DefaultFullHttpResponse(decodeResult: success, version: HTTP/1.1, content: UnpooledByteBufAllocatorInstrumentedUnpooledUnsafeHeapByteBuf(ridx: 0, widx: 11, cap: 33)) HTTP/1.1 200 OK content-length: 11 content-type: text/plain --------------httpserverHandler, remote_address /127.0.0.1:50061, msg_class:class io.netty.handler.codec.http.LastHttpContent1
channel read complete // 第一次channelRead0请求
channel read complete // 第二次channelRead0请求
channel inactive invoked
channel unregister invoked

基本的hellworld程序已经运行起来,并且自行实现的处理器调用过程通过重写方法打印也能够有所了解了。
这里要注意的是,对于Netty来说,上层应用获取客户端请求之后,当请求是基于Http1.1协议的话会有个keepalive时间,比如30秒钟时间,如果在这段时间内没有接受到新的请求则由[服务端]主动关闭连接。当请求是基于Http1.0短连接协议,请求发过来之后,服务器就将这个连接关闭掉,上述示例中可以根据判断调用ctx .channel().close()来关闭连接。

**基于netty构建服务基本流程总结:**
1. 创建EventLoopGroup实例
2. 通过ServerBootstrap启动服务,bind到一个端口. 如果是客户端,则使用Bootstrap,连接主机和端口. 
3. 创建ChannelInitializer实例,通过ChannelPipieline初始化处理器链.
4. 创建ChannelServerHandler实例,继承SimpleChannelInboundHandler,重写channelRead0方法(netty4.x).
5. 将ChannelServerHandler实例addLast到ChannelPipeline上.
6. 将ChannelInitializer实例childHandler到bootstrap上.
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,240评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,328评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,182评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,121评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,135评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,093评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,013评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,854评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,295评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,513评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,678评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,398评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,989评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,636评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,801评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,657评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,558评论 2 352

推荐阅读更多精彩内容