MessageToMessageDecoder (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.channel.ChannelHandlerAdapter
- - io.netty.channel.ChannelInboundHandlerAdapter
  - - io.netty.handler.codec.MessageToMessageDecoder<I>

All Implemented Interfaces:

ChannelHandler ， ChannelInboundHandler

已知直接子类：

Base64Decoder ， ByteArrayDecoder ， DatagramDnsQueryDecoder ， DatagramDnsResponseDecoder ， DatagramPacketDecoder ， HttpContentDecoder ， MessageAggregator ， ProtobufDecoder ， ProtobufDecoderNano ， RedisArrayAggregator ， SctpInboundByteStreamHandler ， SctpMessageCompletionHandler ， SctpMessageToMessageDecoder ， SpdyHttpDecoder ， StringDecoder ， WebSocketClientProtocolHandler ， WebSocketExtensionDecoder ， WebSocketServerProtocolHandler
```
public abstract class MessageToMessageDecoder<I>
extends ChannelInboundHandlerAdapter
```
ChannelInboundHandlerAdapter从一个消息解码到另一个消息。例如，这里是将String解码为代表Integer长度的String 。
```
  public class StringToIntegerDecoder extends
             MessageToMessageDecoder<String> {

          @Override
         public void decode(ChannelHandlerContext ctx, String message,
                            List<Object> out) throws 异常 {
             out.add(message.length());
         }
     } 
```
要知道，你需要调用ReferenceCounted.retain()对刚刚通过，如果他们是类型传递的消息ReferenceCounted 。这是需要的，因为MessageToMessageDecoder将在解码的消息上调用ReferenceCounted.release() 。

Nested Class Summary
- Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler
  ChannelHandler.Sharable

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`MessageToMessageDecoder()` 创建一个新实例，它将尝试检测类型以匹配该类的类型参数。
`protected`	`MessageToMessageDecoder(java.lang.Class<? extends I> inboundMessageType)` 创建一个新的实例

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`boolean`	`acceptInboundMessage(java.lang.Object msg)` 如果应该处理给定的消息，则返回 `true` 。
`void`	`channelRead(ChannelHandlerContext ctx, java.lang.Object msg)` 致电`ChannelHandlerContext.fireChannelRead(Object)`转发到`ChannelPipeline`中的下一个`ChannelInboundHandler` 。
`protected abstract void`	`decode(ChannelHandlerContext ctx, I msg, java.util.List<java.lang.Object> out)` 从一条消息解码到另一条消息。

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter
channelActive, channelInactive, channelReadComplete, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught, userEventTriggered

Methods inherited from class io.netty.channel.ChannelHandlerAdapter
ensureNotSharable, handlerAdded, handlerRemoved, isSharable

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.netty.channel.ChannelHandler
handlerAdded, handlerRemoved

- 构造方法详细信息
  - MessageToMessageDecoder
```
protected MessageToMessageDecoder()
```
    创建一个新实例，它将尝试检测类型以匹配该类的类型参数。
  - MessageToMessageDecoder
```
protected MessageToMessageDecoder(java.lang.Class<? extends I> inboundMessageType)
```
    创建一个新的实例
    
    参数
    
    inboundMessageType - 要匹配并解码的消息类型
- 方法详细信息
  - acceptInboundMessage
```
public boolean acceptInboundMessage(java.lang.Object msg)
                             throws java.lang.Exception
```
    如果应该处理给定的消息，则返回true 。如果false它将被传递到ChannelPipeline中的下一个ChannelInboundHandler 。
    
    异常
    
    java.lang.Exception
  - channelRead
```
public void channelRead(ChannelHandlerContext ctx,
                        java.lang.Object msg)
                 throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    请致电ChannelHandlerContext.fireChannelRead(Object)转发至ChannelPipeline中的下一个ChannelInboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    channelRead在界面 ChannelInboundHandler
    
    重写：
    
    channelRead在课堂上 ChannelInboundHandlerAdapter
    
    异常
    
    java.lang.Exception
  - decode
```
protected abstract void decode(ChannelHandlerContext ctx,
                               I msg,
                               java.util.List<java.lang.Object> out)
                        throws java.lang.Exception
```
    从一条消息解码到另一条消息。这个方法将被编码器处理的每个书面信息调用。
    
    参数
    
    ctx - MessageToMessageDecoder所属的ChannelHandlerContext
    
    msg - 解码到另一个的消息
    
    out - 应该添加解码消息的 List
    
    异常
    
    java.lang.Exception - 发生错误时抛出

Class MessageToMessageDecoder<I>

Nested Class Summary

Nested classes/interfaces inherited from interface io.netty.channel.ChannelHandler

构造方法摘要

方法摘要

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

Methods inherited from class java.lang.Object

Methods inherited from interface io.netty.channel.ChannelHandler

构造方法详细信息

MessageToMessageDecoder

MessageToMessageDecoder

方法详细信息

acceptInboundMessage

channelRead

decode