io.netty.handler.codec.compression

Class Bzip2Encoder

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelOutboundHandlerAdapter

io.netty.handler.codec.MessageToByteEncoder<io.netty.buffer.ByteBuf>

io.netty.handler.codec.compression.Bzip2Encoder

All Implemented Interfaces:

io.netty.channel.ChannelHandler, io.netty.channel.ChannelOutboundHandler

public class Bzip2Encoder
extends MessageToByteEncoder<io.netty.buffer.ByteBuf>

Compresses a ByteBuf using the Bzip2 algorithm. See Bzip2.

Nested Class Summary

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

io.netty.channel.ChannelHandler.Sharable

Constructor Summary

Constructors

Constructor and Description
Bzip2Encoder() Creates a new bzip2 encoder with the maximum (900,000 byte) block size.
Bzip2Encoder(int blockSizeMultiplier) Creates a new bzip2 encoder with the specified blockSizeMultiplier.

Method Summary

Modifier and Type	Method and Description
io.netty.channel.ChannelFuture	close() Close this Bzip2Encoder and so finish the encoding.
void	close(io.netty.channel.ChannelHandlerContext ctx, io.netty.channel.ChannelPromise promise)
io.netty.channel.ChannelFuture	close(io.netty.channel.ChannelPromise promise) Close this Bzip2Encoder and so finish the encoding.
protected void	encode(io.netty.channel.ChannelHandlerContext ctx, io.netty.buffer.ByteBuf in, io.netty.buffer.ByteBuf out) Encode a message into a ByteBuf.
void	handlerAdded(io.netty.channel.ChannelHandlerContext ctx)
boolean	isClosed() Returns true if and only if the end of the compressed stream has been reached.

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

acceptOutboundMessage, allocateBuffer, isPreferDirect, write

Methods inherited from class io.netty.channel.ChannelOutboundHandlerAdapter

bind, connect, deregister, disconnect, flush, read

Methods inherited from class io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, exceptionCaught, 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

Constructor Detail

Bzip2Encoder

public Bzip2Encoder()

Creates a new bzip2 encoder with the maximum (900,000 byte) block size.

Bzip2Encoder

public Bzip2Encoder(int blockSizeMultiplier)

Creates a new bzip2 encoder with the specified blockSizeMultiplier.

Parameters:

blockSizeMultiplier - The Bzip2 block size as a multiple of 100,000 bytes (minimum 1, maximum 9). Larger block sizes require more memory for both compression and decompression, but give better compression ratios. 9 will usually be the best value to use.

Method Detail

encode

protected void encode(io.netty.channel.ChannelHandlerContext ctx,
                      io.netty.buffer.ByteBuf in,
                      io.netty.buffer.ByteBuf out)
               throws Exception

Description copied from class: MessageToByteEncoder

Encode a message into a ByteBuf. This method will be called for each written message that can be handled by this encoder.

Specified by:

encode in class MessageToByteEncoder<io.netty.buffer.ByteBuf>

Parameters:

ctx - the ChannelHandlerContext which this MessageToByteEncoder belongs to

in - the message to encode

out - the ByteBuf into which the encoded message will be written

Throws:

Exception - is thrown if an error occurs

isClosed

public boolean isClosed()

Returns true if and only if the end of the compressed stream has been reached.

close

public io.netty.channel.ChannelFuture close()

Close this Bzip2Encoder and so finish the encoding. The returned ChannelFuture will be notified once the operation completes.

close

public io.netty.channel.ChannelFuture close(io.netty.channel.ChannelPromise promise)

Close this Bzip2Encoder and so finish the encoding. The given ChannelFuture will be notified once the operation completes and will also be returned.

close

public void close(io.netty.channel.ChannelHandlerContext ctx,
                  io.netty.channel.ChannelPromise promise)
           throws Exception

Specified by:

close in interface io.netty.channel.ChannelOutboundHandler

Overrides:

close in class io.netty.channel.ChannelOutboundHandlerAdapter

Throws:

Exception

handlerAdded

public void handlerAdded(io.netty.channel.ChannelHandlerContext ctx)
                  throws Exception

Specified by:

handlerAdded in interface io.netty.channel.ChannelHandler

Overrides:

handlerAdded in class io.netty.channel.ChannelHandlerAdapter

Throws:

Exception