Class ProtobufDecoderNano

  • All Implemented Interfaces:
    io.netty.channel.ChannelHandler, io.netty.channel.ChannelInboundHandler

    @Sharable
    public class ProtobufDecoderNano
    extends io.netty.handler.codec.MessageToMessageDecoder<io.netty.buffer.ByteBuf>
    Decodes a received ByteBuf into a Google Protocol Buffers MessageNano. Please note that this decoder must be used with a proper ByteToMessageDecoder such as LengthFieldBasedFrameDecoder if you are using a stream-based transport such as TCP/IP. A typical setup for TCP/IP would be:
     ChannelPipeline pipeline = ...;
    
     // Decoders
     pipeline.addLast("frameDecoder",
                      new LengthFieldBasedFrameDecoder(1048576, 0, 4, 0, 4));
     pipeline.addLast("protobufDecoder",
                      new ProtobufDecoderNano(MyMessage.getDefaultInstance()));
    
     // Encoder
     pipeline.addLast("frameEncoder", new LengthFieldPrepender(4));
     pipeline.addLast("protobufEncoder", new ProtobufEncoderNano());
     
    and then you can use a MyMessage instead of a ByteBuf as a message:
     void channelRead(ChannelHandlerContext ctx, Object msg) {
         MyMessage req = (MyMessage) msg;
         MyMessage res = MyMessage.newBuilder().setText(
                                   "Did you say '" + req.getText() + "'?").build();
         ch.write(res);
     }
     
    • Nested Class Summary

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

        io.netty.channel.ChannelHandler.Sharable
    • Constructor Summary

      Constructors 
      Constructor Description
      ProtobufDecoderNano​(Class<? extends com.google.protobuf.nano.MessageNano> clazz)
      Creates a new instance.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      protected void decode​(io.netty.channel.ChannelHandlerContext ctx, io.netty.buffer.ByteBuf msg, List<Object> out)  
      • Methods inherited from class io.netty.handler.codec.MessageToMessageDecoder

        acceptInboundMessage, channelRead, channelReadComplete
      • Methods inherited from class io.netty.channel.ChannelInboundHandlerAdapter

        channelActive, channelInactive, channelRegistered, channelUnregistered, channelWritabilityChanged, exceptionCaught, userEventTriggered
      • Methods inherited from class io.netty.channel.ChannelHandlerAdapter

        ensureNotSharable, handlerAdded, handlerRemoved, isSharable
      • Methods inherited from interface io.netty.channel.ChannelHandler

        handlerAdded, handlerRemoved
    • Constructor Detail

      • ProtobufDecoderNano

        public ProtobufDecoderNano​(Class<? extends com.google.protobuf.nano.MessageNano> clazz)
        Creates a new instance.
    • Method Detail

      • decode

        protected void decode​(io.netty.channel.ChannelHandlerContext ctx,
                              io.netty.buffer.ByteBuf msg,
                              List<Object> out)
                       throws Exception
        Specified by:
        decode in class io.netty.handler.codec.MessageToMessageDecoder<io.netty.buffer.ByteBuf>
        Throws:
        Exception