Netty4.x中文教程系列(一)Hello World !
在中國程式界。我們都是學著Hello World !慢慢成長起來的。逐漸從一無所知到熟悉精通的。
第二章就從Hello World 開始講述Netty的中文教程。
首先建立一個Java專案。引入一個Netty 框架的包。這個步驟我在本系列教程的後面就不在重複了。
先上一張我示例的專案工程圖給大家看一下:
1.下載併為專案新增Netty框架
如圖所示: Netty提供了三個主要版本的框架包給大家下載。
3.9版本Final 說明這個版本是3.x版本中最新的版本。final意味著功能不再繼續新增更新。僅為修改bug等提供繼續的更新。
5.x版本由於是開始。不能排除是否穩定執行等問題。加上5.x在4.x的版本上略微修改的。在5.x穩定之前。不推薦大家學習使用。
本教程是基於Netty4.x版本的。
筆者也是從3.6版本,經過了相當痛苦的一段時間才算是真正的過度到4.x版本。
下載之後解壓縮。大家可以看到這樣一個目錄結構。非常的清晰。
第一個資料夾jar是jar包的資料夾。第二個javadoc是API文件。第三個license資料夾是開源的授權檔案(可以直接無視)。
javadoc資料夾下面是一個jar包。可以直接解壓縮出來。解壓縮之後的資料夾就是api文件(以網頁的形勢展現)。
jar資料夾裡面有很多的jar包和一個all-in-one資料夾。都是Netty框架的組成部分。all-in-one裡面有兩個檔案一個是jar包,另一個是對應的source原始碼包。這樣做的目的是為了給程式設計師有選擇的新增自己所需要的包。
假如讀者是初學者的話。推薦直接套用all-in-one裡面的jar包。假如你熟悉Netty的話可以根據自己的專案需求新增不同的jar包。
2.建立Server 服務端
Netty建立全部都是實現自AbstractBootstrap。客戶端的是Bootstrap,服務端的則是ServerBootstrap。
2.1建立一個 HelloServer
package org.example.hello; import io.netty.bootstrap.ServerBootstrap; import io.netty.channel.ChannelFuture; importio.netty.channel.EventLoopGroup; import io.netty.channel.nio.NioEventLoopGroup; import io.netty.channel.socket.nio.NioServerSocketChannel; public class HelloServer { /** * 服務端監聽的埠地址 */ private static final int portNumber = 7878; public static void main(String[] args) throws InterruptedException { EventLoopGroup bossGroup = new NioEventLoopGroup(); EventLoopGroup workerGroup = new NioEventLoopGroup(); try { ServerBootstrap b = new ServerBootstrap(); b.group(bossGroup, workerGroup); b.channel(NioServerSocketChannel.class); b.childHandler(new HelloServerInitializer()); // 伺服器繫結埠監聽 ChannelFuture f = b.bind(portNumber).sync(); // 監聽伺服器關閉監聽 f.channel().closeFuture().sync(); // 可以簡寫為 /* b.bind(portNumber).sync().channel().closeFuture().sync(); */ } finally { bossGroup.shutdownGracefully(); workerGroup.shutdownGracefully(); } } }
EventLoopGroup 是在4.x版本中提出來的一個新概念。用於channel的管理。服務端需要兩個。和3.x版本一樣,一個是boss執行緒一個是worker執行緒。
b.childHandler(new HelloServerInitializer()); //用於新增相關的Handler
服務端簡單的程式碼,真的沒有辦法在精簡了感覺。就是一個繫結埠操作。
2.2建立和實現HelloServerInitializer
在HelloServer中的HelloServerInitializer在這裡實現。
首先我們需要明確我們到底是要做什麼的。很簡單。HelloWorld!。我們希望實現一個能夠像服務端傳送文字的功能。服務端假如可以最好還能返回點訊息給客戶端,然客戶端去顯示。
需求簡單。那我們下面就準備開始實現。
DelimiterBasedFrameDecoder Netty在官方網站上提供的示例顯示 有這麼一個解碼器可以簡單的訊息分割。
其次 在decoder裡面我們找到了String解碼編碼器。著都是官網提供給我們的。
1 package org.example.hello; 2 3 import io.netty.channel.ChannelInitializer; 4 import io.netty.channel.ChannelPipeline; 5 import io.netty.channel.socket.SocketChannel; 6 import io.netty.handler.codec.DelimiterBasedFrameDecoder; 7 import io.netty.handler.codec.Delimiters; 8 import io.netty.handler.codec.string.StringDecoder; 9 import io.netty.handler.codec.string.StringEncoder; 10 11 public class HelloServerInitializer extends ChannelInitializer<SocketChannel> { 12 13 @Override 14 protected void initChannel(SocketChannel ch) throws Exception { 15 ChannelPipeline pipeline = ch.pipeline(); 16 17 // 以("\n")為結尾分割的 解碼器 18 pipeline.addLast("framer", new DelimiterBasedFrameDecoder(8192, Delimiters.lineDelimiter())); 19 20 // 字串解碼 和 編碼 21 pipeline.addLast("decoder", new StringDecoder()); 22 pipeline.addLast("encoder", new StringEncoder()); 23 24 // 自己的邏輯Handler 25 pipeline.addLast("handler", new HelloServerHandler()); 26 } 27 }
上面的三個解碼和編碼都是系統。
另外我們自己的Handler怎麼辦呢。在最後我們新增一個自己的Handler用於寫自己的處理邏輯。
2.3 增加自己的邏輯HelloServerHandler
自己的Handler我們這裡先去繼承extends官網推薦的SimpleChannelInboundHandler<C> 。在這裡C,由於我們需求裡面傳送的是字串。這裡的C改寫為String。
1 package org.example.hello; 2 3 import java.net.InetAddress; 4 5 import io.netty.channel.ChannelHandlerContext; 6 import io.netty.channel.SimpleChannelInboundHandler; 7 8 public class HelloServerHandler extends SimpleChannelInboundHandler<String> { 9 10 @Override 11 protected void channelRead0(ChannelHandlerContext ctx, String msg) throws Exception { 12 // 收到訊息直接列印輸出 13 System.out.println(ctx.channel().remoteAddress() + " Say : " + msg); 14 15 // 返回客戶端訊息 - 我已經接收到了你的訊息 16 ctx.writeAndFlush("Received your message !\n"); 17 } 18 19 /* 20 * 21 * 覆蓋 channelActive 方法 在channel被啟用的時候觸發 (在建立連線的時候) 22 * 23 * channelActive 和 channelInActive 在後面的內容中講述,這裡先不做詳細的描述 24 * */ 25 @Override 26 public void channelActive(ChannelHandlerContext ctx) throws Exception { 27 28 System.out.println("RamoteAddress : " + ctx.channel().remoteAddress() + " active !"); 29 30 ctx.writeAndFlush( "Welcome to " + InetAddress.getLocalHost().getHostName() + " service!\n"); 31 32 super.channelActive(ctx); 33 } 34 }
在channelHandlerContent自帶一個writeAndFlush方法。方法的作用是寫入Buffer並刷入。
注意:在3.x版本中此處有很大區別。在3.x版本中write()方法是自動flush的。在4.x版本的前面幾個版本也是一樣的。但是在4.0.9之後修改為WriteAndFlush。普通的write方法將不會發送訊息。需要手動在write之後flush()一次
這裡channeActive的意思是當連線活躍(建立)的時候觸發.輸出訊息源的遠端地址。並返回歡迎訊息。
channelRead0 在這裡的作用是類似於3.x版本的messageReceived()。可以當做是每一次收到訊息是觸發。
我們在這裡的程式碼是返回客戶端一個字串"Received your message !".
注意:字串最後面的"\n"是必須的。因為我們在前面的解碼器DelimiterBasedFrameDecoder是一個根據字串結尾為“\n”來結尾的。假如沒有這個字元的話。解碼會出現問題。
2.Client客戶端
類似於服務端的程式碼。我們不做特別詳細的解釋。
直接上示例程式碼:
1 package org.example.hello; 2 3 import io.netty.bootstrap.Bootstrap; 4 import io.netty.channel.Channel; 5 import io.netty.channel.EventLoopGroup; 6 import io.netty.channel.nio.NioEventLoopGroup; 7 import io.netty.channel.socket.nio.NioSocketChannel; 8 9 import java.io.BufferedReader; 10 import java.io.IOException; 11 import java.io.InputStreamReader; 12 13 public class HelloClient { 14 15 public static String host = "127.0.0.1"; 16 public static int port = 7878; 17 18 /** 19 * @param args 20 * @throws InterruptedException 21 * @throws IOException 22 */ 23 public static void main(String[] args) throws InterruptedException, IOException { 24 EventLoopGroup group = new NioEventLoopGroup(); 25 try { 26 Bootstrap b = new Bootstrap(); 27 b.group(group) 28 .channel(NioSocketChannel.class) 29 .handler(new HelloClientInitializer()); 30 31 // 連線服務端 32 Channel ch = b.connect(host, port).sync().channel(); 33 34 // 控制檯輸入 35 BufferedReader in = new BufferedReader(new InputStreamReader(System.in)); 36 for (;;) { 37 String line = in.readLine(); 38 if (line == null) { 39 continue; 40 } 41 /* 42 * 向服務端傳送在控制檯輸入的文字 並用"\r\n"結尾 43 * 之所以用\r\n結尾 是因為我們在handler中添加了 DelimiterBasedFrameDecoder 幀解碼。 44 * 這個解碼器是一個根據\n符號位分隔符的解碼器。所以每條訊息的最後必須加上\n否則無法識別和解碼 45 * */ 46 ch.writeAndFlush(line + "\r\n"); 47 } 48 } finally { 49 // The connection is closed automatically on shutdown. 50 group.shutdownGracefully(); 51 } 52 } 53 }
下面的是HelloClientInitializer程式碼貌似是和服務端的完全一樣。我沒注意看。其實編碼和解碼是相對的。多以服務端和客戶端都是解碼和編碼。才能通訊。
1 package org.example.hello; 2 3 import io.netty.channel.ChannelInitializer; 4 import io.netty.channel.ChannelPipeline; 5 import io.netty.channel.socket.SocketChannel; 6 import io.netty.handler.codec.DelimiterBasedFrameDecoder; 7 import io.netty.handler.codec.Delimiters; 8 import io.netty.handler.codec.string.StringDecoder; 9 import io.netty.handler.codec.string.StringEncoder; 10 11 public class HelloClientInitializer extends ChannelInitializer<SocketChannel> { 12 13 @Override 14 protected void initChannel(SocketChannel ch) throws Exception { 15 ChannelPipeline pipeline = ch.pipeline(); 16 17 /* 18 * 這個地方的 必須和服務端對應上。否則無法正常解碼和編碼 19 * 20 * 解碼和編碼 我將會在下一張為大家詳細的講解。再次暫時不做詳細的描述 21 * 22 * */ 23 pipeline.addLast("framer", new DelimiterBasedFrameDecoder(8192, Delimiters.lineDelimiter())); 24 pipeline.addLast("decoder", new StringDecoder()); 25 pipeline.addLast("encoder", new StringEncoder()); 26 27 // 客戶端的邏輯 28 pipeline.addLast("handler", new HelloClientHandler()); 29 } 30 }
HellClientHandler:
1 package org.example.hello; 2 3 import io.netty.channel.ChannelHandlerContext; 4 import io.netty.channel.SimpleChannelInboundHandler; 5 6 public class HelloClientHandler extends SimpleChannelInboundHandler<String> { 7 8 @Override 9 protected void channelRead0(ChannelHandlerContext ctx, String msg) throws Exception { 10 11 System.out.println("Server say : " + msg); 12 } 13 14 @Override 15 public void channelActive(ChannelHandlerContext ctx) throws Exception { 16 System.out.println("Client active "); 17 super.channelActive(ctx); 18 } 19 20 @Override 21 public void channelInactive(ChannelHandlerContext ctx) throws Exception { 22 System.out.println("Client close "); 23 super.channelInactive(ctx); 24 } 25 }
大家可以再我的百度雲盤裡面找到。
下面上幾張成果圖:
客戶端在連線建立是輸出了Client active 資訊,並收到服務端返回的Welcome訊息。
輸入Hello World ! 回車傳送訊息。服務端響應返回訊息已接受。
1.客戶端控制檯截圖
2.服務端控制檯截圖
作者:TinyZ
出處:http://www.cnblogs.com/zou90512/
關於作者:努力學習,天天向上。不斷探索學習,提升自身價值。記錄經驗分享。
本文版權歸作者和部落格園共有,歡迎轉載,但未經作者同意必須保留此段宣告,且在文章頁面明顯位置給出原文連結
如有問題,可以通過 [email protected] 聯絡我,非常感謝。
筆者網店: http://aoleitaisen.taobao.com. 歡迎廣大讀者圍觀
相關推薦
Netty4.x中文教程系列(一)Hello World !
在中國程式界。我們都是學著Hello World !慢慢成長起來的。逐漸從一無所知到熟悉精通的。 第二章就從Hello World 開始講述Netty的中文教程。 首先建立一個Java專案。引入一個Netty 框架的包。這個步驟我在本系列教程的後面就不在重
Netty4.x中文教程系列(五)編解碼器Codec
原文:http://www.cnblogs.com/zou90512/p/3654163.html 上一篇文章詳細解釋了ChannelHandler的相關構架設計,版本和設計邏輯變更等等。 這篇文章主要在於講述Handler裡面的Codec,也就是相關的編解碼
Golang初級系列教程-手把手編寫 Hello World
手把手編寫 Hello World 建立檔案 program1.go,不寫入任何內容。按照如下的命令嘗試進行編譯 cmd-prompt> go run program1.go 將會打印出如下錯誤: package : program1.go:1:1
django celery的分布式異步之路(一) hello world
settings csrf trac 選擇 load 你在 函數 1.2 密碼 設想你遇到如下場景: 1)高並發 2)請求的執行相當消耗機器資源,流量峰值的時候可能超出單機界限 3)請求返回慢,客戶長時間等在頁面等待任務返回 4)存在耗時的定時任務 這時你就需要一個分布
.Net Core 系列之一 hello world
按鈕 16px bin release 重新 get 完成 community 可能 OS: win10 企業版 中文環境 .Net Core: 切記不要裝64版本,否則可能會出現vs2017無法生成.net core 2.0的項目 dotnet-sdk
微信小程序開發系列之Hello World
平臺 固定 文件夾 變量 AC 平時 str atp 表示 第一步:註冊 在微信公眾平臺官網首頁,點擊註冊。(相關文檔可以找到,這裏不再累述,望見諒。) 微信小程序註冊成功後界面 第二步:編輯器、開發工具 我們假定你已經申請註冊好微信小程序了,我們選定一個代碼開發的編輯器
[譯]RabbitMQ教程C#版 - “Hello World”
stat class mes 主機 tle 消息代理 方式 事件 二進制 先決條件本教程假定RabbitMQ已經安裝,並運行在localhost標準端口(5672)。如果你使用不同的主機、端口或證書,則需要調整連接設置。 從哪裏獲得幫助如果您在閱讀本教程時遇到困
SpringMVC 學習筆記(一) Hello World
pragma pan 自己掃描 framework print 一個 頁面 poj OS springMVC概述: Spring MVC 是目前最主流的MVC 框架之一 Spring MVC 通過一套 MVC 註解,讓 POJO 成為處理請 求的控制器,而無須實現任何接
MySQL入門教程系列一----表的匯出與匯入
1.表的匯出 有時需要將MySQL資料庫的資料匯出到外部儲存檔案中,MySQL資料庫中的資料可以匯出成sql文字檔案,xml檔案或者html檔案,同樣這些匯出的檔案也可以匯入MySQL資料庫中, 1.1用SELECT…INTO OUTFILE匯出檔案 MySQL資料庫在匯出資料時
Swift學習筆記一 hello world
學習任何語言都是從hello world開始的,哈哈哈 開始我的swift學習之旅 //這個好像就是類似於OC的懶載入 (個人觀點--菜雞觀點) fileprivate var helloB
GO語言學習一 Hello World!
文章目錄 環境準備 GOROOT環境變數 第一個程式 程式結構 包 匯入 GOPATH環境變數 環境準備 Go語言當前支援Windows、Mac
Seaborn中文教程(一):視覺化變數間的關係
眾所周知,Seaborn“可能”是Python下最友好、易用的視覺化工具了,視覺化效果也非常好。但是截止目前,並沒有一份中文教程供廣大國內Python使用者查閱學習。怎麼能因為語言的問題,讓大家錯過這麼好用的一個視覺化工具呢? 思考再三,我決定花一些時間將官方的英文文件整理出來,為大
Swift官方入門教程系列--一--使用Swift建立UI【翻譯版,原始碼】
本課程讓您熟悉Xcode,這是您用來編寫應用程式的工具。您將熟悉Xcode中專案的結構,並學習如何在基本專案元件之間導航和使用。在課程中,您將開始製作一個簡單的FoodTracker
【scala系列】hello world小程式
說明 今天看了下scala,然後搭建了scala的開發環境。並嘗試了下簡單的程式開發。接下來記錄下hello world小程式的開發。初次寫scala程式,真是有點不習慣。 相關網址 開發環境
Ruby學習之語言特性&安裝環境&中文輸出&輸出Hello World
Ruby呢,它是一款開源的面向物件程式設計的伺服器指令碼語言,它可以執行在不同的平臺上,並且呢,它的特性和python、Perl比較相似,我們來具體看下: Ruby 是開源的,在 Web 上免費提供,但需要一個許可證。 Ruby 是一種通用的、解釋的程式語言。 Ruby 是
使用C#開發HTTP伺服器系列之Hello World
各位朋友大家好,我是秦元培,歡迎大家關注我的部落格。從今天起,我將開始撰寫一組關於HTTP伺服器開發的系列文章。我為什麼會有這樣的想法呢?因為人們對Web技術存在誤解,認為網站開發是Web技術的全部。其實在今天這樣一個時代,Web技術可謂是無處不在,無論是傳
[Gradle中文教程系列]-跟我學Gradle-5.5:依賴-構件的上傳與釋出
藉助maven-publish外掛可以輕鬆地將jar包釋出到倉庫中。這個過程沒啥么蛾子直接上程式碼吧。瞭解更多配置可以檢視 Maven plugin外掛章節 apply plugin: '
Netty4.x 原始碼實戰系列(四):深入淺出學Pipeline
在netty中,每一個channel都有一個pipeline物件,並且其內部本質上就是一個雙向連結串列 本篇我們將深入Pipeline原始碼內部,對其一探究竟,給大家一個全方位解析。 Pipeline初始化過程分析 在上一篇中,我們得知ch
RxJava2.x 學習教程(一)基本概念
RxJava是什麼、優點 RxJava (本文所有RxJava全都代指RxJava2)在 GitHub 主頁上的自我介紹是:RxJava – Reactive Extensions for the JVM – a library for composing asynch
Netty4.x 原始碼實戰系列(三):NioServerSocketChannel全剖析
根據上一篇《Netty4.x 原始碼實戰系列(二):服務端bind流程詳解》所述,在進行服務端開發時,必須通過ServerBootstrap引導類的channel方法來指定channel型別, channel方法的呼叫其實就是例項化了一個用於生成此channel