1. 程式人生 > >Netty5.x中新增和值得注意的點

Netty5.x中新增和值得注意的點

最近事情多,OneCoder折騰了好幾天,總算翻譯完成了。 該文件會列出在Netty新版本中值得注意變化和新特性列表。幫助你的應用更好的適應新的版本。 不像Netty3.x和4.x之間的變化,5.x沒有那麼大的變化,不過也取得了其簡化設計中的一些突破性進展.。我們力求儘可能平滑的從4.x版本過度到5.x版本,如果你在遷移過程中遇到任何問題,請告知我們。 核心變化 支援Android 提供了:
  •  移動裝置變成更加強大
  • 通過Ice Cream Sandwich解決了在ADK中最著名的與NIO和SSLEngine相關的問題,且
  • 使用者顯然想要重用他們應用中的的編解碼和處理器程式碼。
我們決定官方支援Android(4.0及以上版本) 簡化處理器層次 ChannelInboundHandler和ChannelOutboundHandler整合為ChannelHandler。ChannelHandler現在包含輸入和輸出的處理方法。 ChannelInboundHandlerAdapter,ChannelOutboundHandlerAdapter和ChannelDuplexHandlerAdapter已被廢棄,由 ChannelHandlerAdapter代替。 由於現在無法區分處理器(handler) 是輸入還是輸出的處理器,CombinedChannelDuplexHandler現在由 ChannelHandlerAppender代替。 channelRead0() → messageReceived()
我知道。這是一個愚蠢的錯誤。如果你使用了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()方法返回專門型別的引數,因此你不必在轉換他們的返回值。這可以簡化你的測試用例程式碼。
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多部分的編解碼