io.netty.handler.codec

类 MessageToByteEncoder<I>

java.lang.Object

io.netty.channel.ChannelHandlerAdapter

io.netty.channel.ChannelOutboundHandlerAdapter

io.netty.handler.codec.MessageToByteEncoder<I>

所有已实现的接口:

ChannelHandler, ChannelOutboundHandler

直接已知子类:

BrotliEncoder, Bzip2Encoder, CompatibleMarshallingEncoder, CompatibleObjectEncoder, FastLzFrameEncoder, HAProxyMessageEncoder, Lz4FrameEncoder, LzfEncoder, LzmaFrameEncoder, MarshallingEncoder, NumberEncoder, ObjectEncoder, ProtobufVarint32LengthFieldPrepender, SnappyFrameEncoder, Socks4ClientEncoder, Socks4ServerEncoder, Socks5ClientEncoder, Socks5ServerEncoder, SocksMessageEncoder, TcpDnsQueryEncoder, ZlibEncoder, ZstdEncoder

public abstract class MessageToByteEncoder<I>
extends ChannelOutboundHandlerAdapter

ChannelOutboundHandlerAdapter which encodes message in a stream-like fashion from one message to an ByteBuf. Example implementation which encodes Integers to a ByteBuf.

     public class IntegerEncoder extends MessageToByteEncoder<Integer> {
          @Override
         public void encode(ChannelHandlerContext ctx, Integer msg, ByteBuf out)
                 throws Exception {
             out.writeInt(msg);
         }
     }
 

嵌套类概要

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

ChannelHandler.Sharable

构造器概要

构造器

限定符	构造器和说明
protected	MessageToByteEncoder() see MessageToByteEncoder(boolean) with true as boolean parameter.
protected	MessageToByteEncoder(boolean preferDirect) Create a new instance which will try to detect the types to match out of the type parameter of the class.
protected	MessageToByteEncoder(java.lang.Class<? extends I> outboundMessageType) see MessageToByteEncoder(Class, boolean) with true as boolean value.
protected	MessageToByteEncoder(java.lang.Class<? extends I> outboundMessageType, boolean preferDirect) Create a new instance

方法概要

限定符和类型	方法和说明
boolean	acceptOutboundMessage(java.lang.Object msg) Returns true if the given message should be handled.
protected ByteBuf	allocateBuffer(ChannelHandlerContext ctx, I msg, boolean preferDirect) Allocate a ByteBuf which will be used as argument of #encode(ChannelHandlerContext, I, ByteBuf).
protected abstract void	encode(ChannelHandlerContext ctx, I msg, ByteBuf out) Encode a message into a ByteBuf.
protected boolean	isPreferDirect()
void	write(ChannelHandlerContext ctx, java.lang.Object msg, ChannelPromise promise) Calls ChannelOutboundInvoker.write(Object, ChannelPromise) to forward to the next ChannelOutboundHandler in the ChannelPipeline.

从类继承的方法 io.netty.channel.ChannelOutboundHandlerAdapter

bind, close, connect, deregister, disconnect, flush, read

从类继承的方法 io.netty.channel.ChannelHandlerAdapter

ensureNotSharable, exceptionCaught, handlerAdded, handlerRemoved, isSharable

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

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

从接口继承的方法 io.netty.channel.ChannelHandler

exceptionCaught, handlerAdded, handlerRemoved

构造器详细资料

MessageToByteEncoder

protected MessageToByteEncoder()

see MessageToByteEncoder(boolean) with true as boolean parameter.

MessageToByteEncoder

protected MessageToByteEncoder(java.lang.Class<? extends I> outboundMessageType)

see MessageToByteEncoder(Class, boolean) with true as boolean value.

MessageToByteEncoder

protected MessageToByteEncoder(boolean preferDirect)

Create a new instance which will try to detect the types to match out of the type parameter of the class.

参数:

preferDirect - true if a direct ByteBuf should be tried to be used as target for the encoded messages. If false is used it will allocate a heap ByteBuf, which is backed by an byte array.

MessageToByteEncoder

protected MessageToByteEncoder(java.lang.Class<? extends I> outboundMessageType,
                               boolean preferDirect)

Create a new instance

参数:

outboundMessageType - The type of messages to match

preferDirect - true if a direct ByteBuf should be tried to be used as target for the encoded messages. If false is used it will allocate a heap ByteBuf, which is backed by an byte array.

方法详细资料

acceptOutboundMessage

public boolean acceptOutboundMessage(java.lang.Object msg)
                              throws java.lang.Exception

Returns true if the given message should be handled. If false it will be passed to the next ChannelOutboundHandler in the ChannelPipeline.

抛出:

java.lang.Exception

write

public void write(ChannelHandlerContext ctx,
                  java.lang.Object msg,
                  ChannelPromise promise)
           throws java.lang.Exception

从类复制的说明: ChannelOutboundHandlerAdapter

Calls ChannelOutboundInvoker.write(Object, ChannelPromise) to forward to the next ChannelOutboundHandler in the ChannelPipeline. Sub-classes may override this method to change behavior.

指定者:

write 在接口中 ChannelOutboundHandler

覆盖:

write 在类中 ChannelOutboundHandlerAdapter

参数:

ctx - the ChannelHandlerContext for which the write operation is made

msg - the message to write

promise - the ChannelPromise to notify once the operation completes

抛出:

java.lang.Exception - thrown if an error occurs

allocateBuffer

protected ByteBuf allocateBuffer(ChannelHandlerContext ctx,
                                 I msg,
                                 boolean preferDirect)
                          throws java.lang.Exception

Allocate a ByteBuf which will be used as argument of #encode(ChannelHandlerContext, I, ByteBuf). Sub-classes may override this method to return ByteBuf with a perfect matching initialCapacity.

抛出:

java.lang.Exception

encode

protected abstract void encode(ChannelHandlerContext ctx,
                               I msg,
                               ByteBuf out)
                        throws java.lang.Exception

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

参数:

ctx - the ChannelHandlerContext which this MessageToByteEncoder belongs to

msg - the message to encode

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

抛出:

java.lang.Exception - is thrown if an error occurs

isPreferDirect

protected boolean isPreferDirect()