Netty5.x中新增和值得注意的點
阿新 • • 發佈:2018-12-23
最近事情多,OneCoder折騰了好幾天,總算翻譯完成了。
該文件會列出在Netty新版本中值得注意變化和新特性列表。幫助你的應用更好的適應新的版本。
不像Netty3.x和4.x之間的變化,5.x沒有那麼大的變化,不過也取得了其簡化設計中的一些突破性進展.。我們力求儘可能平滑的從4.x版本過度到5.x版本,如果你在遷移過程中遇到任何問題,請告知我們。
核心變化
支援Android
提供了:
我知道。這是一個愚蠢的錯誤。如果你使用了SimpleChannelInboundHandler,你需要把channelRead0()重新命名為messageReceived()。
廢棄中移除的
Channel.deregister()已被移除。不再生效和被使用。取而代之的,我們將允許Channel被充註冊到不同的事件迴圈。
ChannelHandlerContext.attr(..) == Channel.attr(..)
Channel和ChannelHandlerContext類都實現了AttributeMap介面,使使用者可以在其上關聯一個或多個屬性。有時會讓使用者感到困惑的是Channel和ChannelHandlerContext都有其自己的儲存使用者定義屬性的容器。例如,即使你通過Channel.attr(KEY_X).set(valueX)給屬性'KEY_X’賦值,你卻無法通過ChannelHandlerContext.attr(KEY_X).get()方法獲取到值。反之亦是如此。這種行為不僅僅令人不解而且還浪費記憶體。
為了解決這個問題,我們決定每個Channel內部僅保留一個map。AttributeMap總是用AttributeKey作為它的key。AttributeKey確保鍵的唯一性,因此每個Channel中如果存在一個以上的屬性容易是多餘的。只要使用者把他自己的AttributeKey定義成ChannelHandler的private static final變數,就不會有出現重複key的風險。
更簡單更精確的緩衝區洩漏追蹤
之前,查詢緩衝區洩漏是很困難的,並且洩漏的警告資訊也不是很有幫助。現在我們有了增強的洩漏報告機制,該機制會在增長超過上限時觸發。
更多的資訊可檢視:http://netty.io/wiki/reference-counted-objects.html 。由於該特性十分重要,所以也移植入了4..0.14.Final版中。
PooledByteBufAllocator成為預設的allocator
在4.x版本中,UnpooledByteBufAllocator是預設的allocator,儘管其存在某些限制。現在PooledByteBufAllocator已經廣泛使用一段時間,並且我們有了增強的緩衝區洩漏追蹤機制,所以是時候讓PooledByteBufAllocator成為默認了。
全域性唯一的Channel ID
每個Channel現在有了全域性唯一的ID,其生成的依據是:
* MAC地址(EUI-48或是EUI-64),最好是全域性唯一的,
* 當前程序的ID
* System#currentTimeMillis()
* System#nanoTime()
* 隨機的32位整數,以及
* 系列遞增的32位整數
可通過Channel.id()方法獲取Channel的ID。
更靈活的執行緒模型
增加了新的ChannelHandlerInvoker介面,用於使使用者可以選擇使用哪個執行緒呼叫事件處理方法。替代之前的在向ChannelPipeline新增 ChannelHandler時指定一個EventExecutor的方式,使用該特性需要指定一個使用者自定義的 ChannelHandlerInvoker實現。
EmbeddedChannel的易用性
EmbeddedChannel中的readInbound()和readOutbound()方法返回專門型別的引數,因此你不必在轉換他們的返回值。這可以簡化你的測試用例程式碼。
- 移動裝置變成更加強大
- 通過Ice Cream Sandwich解決了在ADK中最著名的與NIO和SSLEngine相關的問題,且
- 使用者顯然想要重用他們應用中的的編解碼和處理器程式碼。
EmbeddedChannel ch = ...; // BEFORE: FullHttpRequest req = (FullHttpRequest) ch.readInbound(); // AFTER: FullHttpRequest req = ch.readInbound();使用Executor代替ThreadFactory 有些應用要求使用者使用Executor執行他們的任務。4.x版本要求使用者在建立事件迴圈(event loop)時指定ThreadFacotry,現在不再是這樣了。 關於該變化的更多資訊,可參考:https://github.com/netty/netty/pull/1762 Class loader友好化 一些型別,如AttributeKey對於在容器環境下執行的應用是不友好的,現在不是了。 編解碼和處理器(handlers) * XmlFrameDecoder支援流式的XML文件 * 二進位制的memcache協議編解碼 * 支援SPDY/3.1 (也移植到了4.x版本) * 重構了HTTP多部分的編解碼