org.jboss.netty.handler.stream

类 ChunkedWriteHandler

java.lang.Object

org.jboss.netty.handler.stream.ChunkedWriteHandler

所有已实现的接口:

ChannelDownstreamHandler, ChannelHandler, ChannelUpstreamHandler, LifeCycleAwareChannelHandler

public class ChunkedWriteHandler
extends java.lang.Object
implements ChannelUpstreamHandler, ChannelDownstreamHandler, LifeCycleAwareChannelHandler

A ChannelHandler that adds support for writing a large data stream asynchronously neither spending a lot of memory nor getting OutOfMemoryError. Large data streaming such as file transfer requires complicated state management in a ChannelHandler implementation. ChunkedWriteHandler manages such complicated states so that you can send a large data stream without difficulties.

To use ChunkedWriteHandler in your application, you have to insert a new ChunkedWriteHandler instance:

 ChannelPipeline p = ...;
 p.addLast("streamer", new ChunkedWriteHandler());
 p.addLast("handler", new MyHandler());
 

Once inserted, you can write a ChunkedInput so that the ChunkedWriteHandler can pick it up and fetch the content of the stream chunk by chunk and write the fetched chunk downstream:

 Channel ch = ...;
 ch.write(new ChunkedFile(new File("video.mkv"));
 

Sending a stream which generates a chunk intermittently

Some ChunkedInput generates a chunk on a certain event or timing. Such ChunkedInput implementation often returns null on ChunkedInput.nextChunk(), resulting in the indefinitely suspended transfer. To resume the transfer when a new chunk is available, you have to call resumeTransfer().

嵌套类概要

从接口继承的嵌套类/接口 org.jboss.netty.channel.ChannelHandler

ChannelHandler.Sharable

构造器概要

构造器

构造器和说明
ChunkedWriteHandler()

方法概要

方法

限定符和类型	方法和说明
void	afterAdd(ChannelHandlerContext ctx)
void	afterRemove(ChannelHandlerContext ctx)
void	beforeAdd(ChannelHandlerContext ctx)
void	beforeRemove(ChannelHandlerContext ctx)
void	handleDownstream(ChannelHandlerContext ctx, ChannelEvent e) Handles the specified downstream event.
void	handleUpstream(ChannelHandlerContext ctx, ChannelEvent e) Handles the specified upstream event.
void	resumeTransfer() Continues to fetch the chunks from the input.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ChunkedWriteHandler

public ChunkedWriteHandler()

方法详细资料

resumeTransfer

public void resumeTransfer()

Continues to fetch the chunks from the input.

handleDownstream

public void handleDownstream(ChannelHandlerContext ctx,
                    ChannelEvent e)
                      throws java.lang.Exception

从接口复制的说明: ChannelDownstreamHandler

Handles the specified downstream event.

指定者:

handleDownstream 在接口中 ChannelDownstreamHandler

参数:

ctx - the context object for this handler

e - the downstream event to process or intercept

抛出:

java.lang.Exception

handleUpstream

public void handleUpstream(ChannelHandlerContext ctx,
                  ChannelEvent e)
                    throws java.lang.Exception

从接口复制的说明: ChannelUpstreamHandler

Handles the specified upstream event.

指定者:

handleUpstream 在接口中 ChannelUpstreamHandler

参数:

ctx - the context object for this handler

e - the upstream event to process or intercept

抛出:

java.lang.Exception

beforeAdd

public void beforeAdd(ChannelHandlerContext ctx)
               throws java.lang.Exception

指定者:

beforeAdd 在接口中 LifeCycleAwareChannelHandler

抛出:

java.lang.Exception

afterAdd

public void afterAdd(ChannelHandlerContext ctx)
              throws java.lang.Exception

指定者:

afterAdd 在接口中 LifeCycleAwareChannelHandler

抛出:

java.lang.Exception

beforeRemove

public void beforeRemove(ChannelHandlerContext ctx)
                  throws java.lang.Exception

指定者:

beforeRemove 在接口中 LifeCycleAwareChannelHandler

抛出:

java.lang.Exception

afterRemove

public void afterRemove(ChannelHandlerContext ctx)
                 throws java.lang.Exception

指定者:

afterRemove 在接口中 LifeCycleAwareChannelHandler

抛出:

java.lang.Exception