Home / Class/ CompatibleMarshallingDecoder Class — netty Architecture

CompatibleMarshallingDecoder Class — netty Architecture

Architecture documentation for the CompatibleMarshallingDecoder class in CompatibleMarshallingDecoder.java from the netty codebase.

Entity Profile

Dependency Diagram

graph TD
  f85a4b1a_55ed_4666_acfd_439f0c3341dc["CompatibleMarshallingDecoder"]
  2ab508db_13a7_70fe_42c3_7e7758a49531["CompatibleMarshallingDecoder.java"]
  f85a4b1a_55ed_4666_acfd_439f0c3341dc -->|defined in| 2ab508db_13a7_70fe_42c3_7e7758a49531
  2c272e31_181b_d7c9_686b_8dab612f3dd8["CompatibleMarshallingDecoder()"]
  f85a4b1a_55ed_4666_acfd_439f0c3341dc -->|method| 2c272e31_181b_d7c9_686b_8dab612f3dd8
  812c447b_612a_54b1_3bc3_a2cdae4c07e3["decode()"]
  f85a4b1a_55ed_4666_acfd_439f0c3341dc -->|method| 812c447b_612a_54b1_3bc3_a2cdae4c07e3
  bf44fa6d_9245_ee8d_993c_5f965110bb10["decodeLast()"]
  f85a4b1a_55ed_4666_acfd_439f0c3341dc -->|method| bf44fa6d_9245_ee8d_993c_5f965110bb10
  a6ddd10f_2df2_9471_2a86_9083887a9ee6["exceptionCaught()"]
  f85a4b1a_55ed_4666_acfd_439f0c3341dc -->|method| a6ddd10f_2df2_9471_2a86_9083887a9ee6

Relationship Graph

Source Code

codec-marshalling/src/main/java/io/netty/handler/codec/marshalling/CompatibleMarshallingDecoder.java lines 34–109

public class CompatibleMarshallingDecoder extends ReplayingDecoder<Void> {
    protected final UnmarshallerProvider provider;
    protected final int maxObjectSize;
    private boolean discardingTooLongFrame;

    /**
     * Create a new instance of {@link CompatibleMarshallingDecoder}.
     *
     * @param provider
     *        the {@link UnmarshallerProvider} which is used to obtain the {@link Unmarshaller}
     *        for the {@link Channel}
     * @param maxObjectSize
     *        the maximal size (in bytes) of the {@link Object} to unmarshal. Once the size is
     *        exceeded the {@link Channel} will get closed. Use a maxObjectSize of
     *        {@link Integer#MAX_VALUE} to disable this.  You should only do this if you are sure
     *        that the received Objects will never be big and the sending side are trusted, as this
     *        opens the possibility for a DOS-Attack due an {@link OutOfMemoryError}.
     */
    public CompatibleMarshallingDecoder(UnmarshallerProvider provider, int maxObjectSize) {
        this.provider = provider;
        this.maxObjectSize = maxObjectSize;
    }

    @Override
    protected void decode(ChannelHandlerContext ctx, ByteBuf buffer, List<Object> out) throws Exception {
        if (discardingTooLongFrame) {
            buffer.skipBytes(actualReadableBytes());
            checkpoint();
            return;
        }

        Unmarshaller unmarshaller = provider.getUnmarshaller(ctx);
        ByteInput input = new ChannelBufferByteInput(buffer);
        if (maxObjectSize != Integer.MAX_VALUE) {
            input = new LimitingByteInput(input, maxObjectSize);
        }
        try {
            unmarshaller.start(input);
            Object obj = unmarshaller.readObject();
            unmarshaller.finish();
            out.add(obj);
        } catch (LimitingByteInput.TooBigObjectException ignored) {
            discardingTooLongFrame = true;
            throw new TooLongFrameException();
        } finally {
            // Call close in a finally block as the ReplayingDecoder will throw an Error if not enough bytes are
            // readable. This helps to be sure that we do not leak resource
            unmarshaller.close();
        }
    }

    @Override
    protected void decodeLast(ChannelHandlerContext ctx, ByteBuf buffer, List<Object> out) throws Exception {
        switch (buffer.readableBytes()) {
        case 0:
            return;
        case 1:
            // Ignore the last TC_RESET
            if (buffer.getByte(buffer.readerIndex()) == ObjectStreamConstants.TC_RESET) {
                buffer.skipBytes(1);
                return;
            }
        }

        decode(ctx, buffer, out);
    }

    @Override
    public void exceptionCaught(ChannelHandlerContext ctx, Throwable cause) throws Exception {
        if (cause instanceof TooLongFrameException) {
            ctx.close();
        } else {
            super.exceptionCaught(ctx, cause);
        }
    }
}

Frequently Asked Questions

What is the CompatibleMarshallingDecoder class?
CompatibleMarshallingDecoder is a class in the netty codebase, defined in codec-marshalling/src/main/java/io/netty/handler/codec/marshalling/CompatibleMarshallingDecoder.java.
Where is CompatibleMarshallingDecoder defined?
CompatibleMarshallingDecoder is defined in codec-marshalling/src/main/java/io/netty/handler/codec/marshalling/CompatibleMarshallingDecoder.java at line 34.

Analyze Your Own Codebase

Get architecture documentation, dependency graphs, and domain analysis for your codebase in minutes.

Try Supermodel Free