ChunkedWriteHandler (Netty API Reference (4.1.22.Final))

java.lang.Object
- io.netty.channel.ChannelHandlerAdapter
- - io.netty.channel.ChannelInboundHandlerAdapter
  - - io.netty.channel.ChannelDuplexHandler
    - - io.netty.handler.stream.ChunkedWriteHandler

All Implemented Interfaces:

ChannelHandler ， ChannelInboundHandler ， ChannelOutboundHandler
```
public class ChunkedWriteHandler
extends ChannelDuplexHandler
```
A ChannelHandler增加了对异步写入大数据流的支持，既不花费大量内存也不获取OutOfMemoryError 。大数据流如文件传输需要在ChannelHandler实现中进行复杂的状态管理。 ChunkedWriteHandler管理这样复杂的状态，以便您可以毫无困难地发送大型数据流。
要在您的应用程序中使用ChunkedWriteHandler ，您必须插入一个新的ChunkedWriteHandler实例：
```
  ChannelPipeline p = ...;
 p.addLast("streamer", new ChunkedWriteHandler());
 p.addLast("handler", new MyHandler()); 
```
一旦插入，您可以编写一个ChunkedInput，以便ChunkedWriteHandler可以将其拾取并按块读取流块的内容，并向下游写入获取的块：
```
  Channel ch = ...;
 ch.write(new ChunkedFile(new File("video.mkv")); 
```
发送间歇性生成块的流
一些ChunkedInput在某个事件或时间上生成一个块。这样ChunkedInput实施经常返回null上ChunkedInput.readChunk(ChannelHandlerContext) ，导致无限期暂停传输。要在新块可用时恢复转移，您必须致电resumeTransfer() 。

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

构造方法摘要

构造方法
Constructor and Description
`ChunkedWriteHandler()`
`ChunkedWriteHandler(int maxPendingWrites)` 已过时。使用`ChunkedWriteHandler()`

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`channelInactive(ChannelHandlerContext ctx)` 致电`ChannelHandlerContext.fireChannelInactive()`转发到`ChannelPipeline`中的下一个`ChannelInboundHandler` 。
`void`	`channelWritabilityChanged(ChannelHandlerContext ctx)` 致电`ChannelHandlerContext.fireChannelWritabilityChanged()`转发到`ChannelPipeline`中的下一个`ChannelInboundHandler` 。
`void`	`flush(ChannelHandlerContext ctx)` 致电`ChannelHandlerContext.flush()`转发到`ChannelPipeline`中的下一个`ChannelOutboundHandler` 。
`void`	`handlerAdded(ChannelHandlerContext ctx)` 子类可以忽略这个方法。
`void`	`resumeTransfer()` 继续从输入中获取块。
`void`	`write(ChannelHandlerContext ctx, java.lang.Object msg, ChannelPromise promise)` 致电`ChannelOutboundInvoker.write(Object, ChannelPromise)`转发到`ChannelPipeline`中的下一个`ChannelOutboundHandler` 。

Methods inherited from class io.netty.channel.ChannelDuplexHandler
bind, close, connect, deregister, disconnect, read

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

Methods inherited from class io.netty.channel.ChannelHandlerAdapter
ensureNotSharable, 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
exceptionCaught, handlerRemoved

- 构造方法详细信息
  - ChunkedWriteHandler
```
public ChunkedWriteHandler()
```
  - ChunkedWriteHandler
```
@Deprecated
public ChunkedWriteHandler(int maxPendingWrites)
```
    已过时。使用ChunkedWriteHandler()
- 方法详细信息
  - handlerAdded
```
public void handlerAdded(ChannelHandlerContext ctx)
                  throws java.lang.Exception
```
    从类复制的描述： ChannelHandlerAdapter
    
    子类可以忽略这个方法。
    
    Specified by:
    
    handlerAdded在界面 ChannelHandler
    
    重写：
    
    handlerAdded在课堂上 ChannelHandlerAdapter
    
    异常
    
    java.lang.Exception
  - resumeTransfer
```
public void resumeTransfer()
```
    继续从输入中获取块。
  - write
```
public void write(ChannelHandlerContext ctx,
                  java.lang.Object msg,
                  ChannelPromise promise)
           throws java.lang.Exception
```
    从类复制的描述： ChannelDuplexHandler
    
    致电ChannelOutboundInvoker.write(Object, ChannelPromise)转发到ChannelPipeline中的下一个ChannelOutboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    write在界面 ChannelOutboundHandler
    
    重写：
    
    write在课堂上 ChannelDuplexHandler
    
    参数
    
    ctx - 为其写入操作的ChannelHandlerContext
    
    msg - 要写的消息
    
    promise - 在操作完成后通知ChannelPromise
    
    异常
    
    java.lang.Exception - 发生错误时抛出
  - flush
```
public void flush(ChannelHandlerContext ctx)
           throws java.lang.Exception
```
    从类复制的描述： ChannelDuplexHandler
    
    致电ChannelHandlerContext.flush()转发到ChannelPipeline中的下一个ChannelOutboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    flush在界面 ChannelOutboundHandler
    
    重写：
    
    flush在课堂上 ChannelDuplexHandler
    
    参数
    
    ctx - 进行冲洗操作的ChannelHandlerContext
    
    异常
    
    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
  - channelWritabilityChanged
```
public void channelWritabilityChanged(ChannelHandlerContext ctx)
                               throws java.lang.Exception
```
    从类复制的描述： ChannelInboundHandlerAdapter
    
    致电ChannelHandlerContext.fireChannelWritabilityChanged()转发到ChannelPipeline中的下一个ChannelInboundHandler 。子类可以重写此方法来更改行为。
    
    Specified by:
    
    channelWritabilityChanged ，界面 ChannelInboundHandler
    
    重写：
    
    channelWritabilityChanged在课堂上 ChannelInboundHandlerAdapter
    
    异常
    
    java.lang.Exception

Class ChunkedWriteHandler

发送间歇性生成块的流

Nested Class Summary

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

构造方法摘要

方法摘要

Methods inherited from class io.netty.channel.ChannelDuplexHandler

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

构造方法详细信息

ChunkedWriteHandler

ChunkedWriteHandler

方法详细信息

handlerAdded

resumeTransfer

write

flush

channelInactive

channelWritabilityChanged