HttpContentDecoder (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.channel.ChannelHandlerAdapter
- - io.netty.channel.ChannelInboundHandlerAdapter
  - - io.netty.handler.codec.MessageToMessageDecoder<HttpObject>
    - - io.netty.handler.codec.http.HttpContentDecoder

All Implemented Interfaces:

ChannelHandler ， ChannelInboundHandler

已知直接子类：

HttpContentDecompressor
```
public abstract class HttpContentDecoder
extends MessageToMessageDecoder<HttpObject>
```
解码收到的HttpRequest和HttpContent的内容。原来的内容被替换为解码后的新内容EmbeddedChannel ，这是由创建newContentDecoder(String) 。解码完成后， 'Content-Encoding'标头的值被设置为目标内容编码，由getTargetContentEncoding(String)返回。此外， 'Content-Length'标题更新为解码内容的长度。如果解码器不支持原始内容编码， newContentDecoder(String)应该返回null以便不发生解码（即直通）。
请注意，这是一个抽象类。您必须扩展此类并正确实施newContentDecoder(String)以使此类功能正常。例如，请参阅HttpContentDecompressor的源代码。

该处理程序必须放置在管道HttpObjectDecoder之后，以便此处理程序可以在HttpObjectDecoder将ByteBuf转换为HTTP请求之后拦截HTTP请求。

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

Field Summary

Fields
Modifier and Type	Field and Description
`protected ChannelHandlerContext`	`ctx`

构造方法摘要

构造方法
Constructor and Description
`HttpContentDecoder()`

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`void`	`channelInactive(ChannelHandlerContext ctx)` 致电`ChannelHandlerContext.fireChannelInactive()`转发到`ChannelPipeline`中的下一个`ChannelInboundHandler` 。
`protected void`	`decode(ChannelHandlerContext ctx, HttpObject msg, java.util.List<java.lang.Object> out)` 从一条消息解码到另一条消息。
`protected java.lang.String`	`getTargetContentEncoding(java.lang.String contentEncoding)` 返回解码内容的预期内容编码。
`void`	`handlerAdded(ChannelHandlerContext ctx)` 子类可以忽略这个方法。
`void`	`handlerRemoved(ChannelHandlerContext ctx)` 子类可以忽略这个方法。
`protected abstract EmbeddedChannel`	`newContentDecoder(java.lang.String contentEncoding)` 返回一个新的`EmbeddedChannel` ，它解码在指定的`contentEncoding中`编码的HTTP消息内容。

Methods inherited from class io.netty.handler.codec.MessageToMessageDecoder
acceptInboundMessage, channelRead

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

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

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

- 字段详细信息
  - ctx
```
protected ChannelHandlerContext ctx
```
- 构造方法详细信息
  - HttpContentDecoder
```
public HttpContentDecoder()
```
- 方法详细信息
  - decode
```
protected void decode(ChannelHandlerContext ctx,
                      HttpObject msg,
                      java.util.List<java.lang.Object> out)
               throws java.lang.Exception
```
    从类复制的描述： MessageToMessageDecoder
    
    从一条消息解码到另一条消息。这个方法将被编码器处理的每个书面信息调用。
    
    Specified by:
    
    decode在课堂 MessageToMessageDecoder<HttpObject>
    
    参数
    
    ctx - 此MessageToMessageDecoder所属的ChannelHandlerContext
    
    msg - 解码到另一个的消息
    
    out - 应该添加解码消息的 List
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - newContentDecoder
```
protected abstract EmbeddedChannel newContentDecoder(java.lang.String contentEncoding)
                                              throws java.lang.Exception
```
    返回一个新的EmbeddedChannel ，它解码在指定的contentEncoding中编码的HTTP消息内容。
    
    参数
    
    contentEncoding - "Content-Encoding"标题的值
    
    结果
    
    如果支持指定的编码，则新的EmbeddedChannel 。 null否则（或者，您可以抛出异常来阻止未知编码）。
    
    异常
    
    java.lang.Exception
  - getTargetContentEncoding
```
protected java.lang.String getTargetContentEncoding(java.lang.String contentEncoding)
                                             throws java.lang.Exception
```
    返回解码内容的预期内容编码。这个getMethod默认返回"identity" ，大多数解码器都是这种情况。
    
    参数
    
    contentEncoding - "Content-Encoding"标题的值
    
    结果
    
    新内容的预期内容编码
    
    异常
    
    java.lang.Exception
  - handlerRemoved
```
public void handlerRemoved(ChannelHandlerContext ctx)
                    throws java.lang.Exception
```
    从类复制的描述： ChannelHandlerAdapter
    
    子类可以忽略这个方法。
    
    Specified by:
    
    handlerRemoved在界面 ChannelHandler
    
    重写：
    
    handlerRemoved在课堂上 ChannelHandlerAdapter
    
    异常
    
    java.lang.Exception
  - channelInactive
```
public void channelInactive(ChannelHandlerContext ctx)
                     throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    致电ChannelHandlerContext.fireChannelInactive()转发到ChannelPipeline中的下一个ChannelInboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    channelInactive接口 ChannelInboundHandler
    
    重写：
    
    channelInactive ChannelInboundHandlerAdapter
    
    异常
    
    java.lang.Exception
  - handlerAdded
```
public void handlerAdded(ChannelHandlerContext ctx)
                  throws java.lang.Exception
```
    从类复制的描述： ChannelHandlerAdapter
    
    子类可以忽略这个方法。
    
    Specified by:
    
    handlerAdded接口 ChannelHandler
    
    重写：
    
    handlerAdded在课堂上 ChannelHandlerAdapter
    
    异常
    
    java.lang.Exception

Class HttpContentDecoder

Nested Class Summary

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

Field Summary

构造方法摘要

方法摘要

Methods inherited from class io.netty.handler.codec.MessageToMessageDecoder

Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

Methods inherited from class java.lang.Object

字段详细信息

ctx

构造方法详细信息

HttpContentDecoder

方法详细信息

decode

newContentDecoder

getTargetContentEncoding

handlerRemoved

channelInactive

handlerAdded