netty的 LengthFieldBasedFrameDecoder 和LengthFieldPrepender |
您所在的位置：网站首页 › netty和redis › netty的 LengthFieldBasedFrameDecoder 和LengthFieldPrepender |
|
LengthFieldBasedFrameDecoder
public LengthFieldBasedFrameDecoder(
int maxFrameLength, int lengthFieldOffset, int lengthFieldLength,
int lengthAdjustment, int initialBytesToStrip, boolean failFast)
maxFrameLength: 帧的最大长度。如果帧的长度大于此值，则会抛出 TooLongFrameException。 lengthFieldOffset:长度字段的偏移量 lengthFieldLength: 长度字段的长度 lengthAdjustment: 要添加到长度字段值的补偿值 initialBytesToStrip: 要从解码的帧中剥离的第一个字节数 failFast: 如果为 true，则一旦解码器注意到帧的长度将超过 maxFrameLength，无论是否已读取整个帧，都会引发 TooLongFrameException。如果为 false，则在读取超过 maxFrameLength 的整个帧后抛出 TooLongFrameException #偏移量为 0 处的 2 字节长度字段，不剥离标头 lengthFieldOffset = 0 lengthFieldLength = 2 lengthAdjustment = 0 initialBytesToStrip = 0 (= do not strip header) 此示例中长度字段的值为 12 （0x0C），表示“HELLO， WORLD”的长度。默认情况下，解码器假定长度字段表示长度字段后面的字节数。因此，可以使用简单的参数组合进行解码 BEFORE DECODE (14 bytes) AFTER DECODE (14 bytes) +--------+----------------+ +--------+----------------+ | Length | Actual Content |----->| Length | Actual Content | | 0x000C | "HELLO, WORLD" | | 0x000C | "HELLO, WORLD" | +--------+----------------+ +--------+----------------+注意: 解码器假定长度字段(lengthFieldLength)表示长度字段后面的字节(在这里可以理解为内容的长度) 由于没有跳过处理，所以前后数据看起来一样 #偏移量为 0 处的 2 字节长度字段，条带标头 lengthFieldOffset = 0 lengthFieldLength = 2 lengthAdjustment = 0 initialBytesToStrip = 2 (= 长度字段的长度) 因为我们可以通过调用 ByteBuf.readableBytes（） 来获取内容的长度，所以你可能希望通过指定 initialBytesToStrip 来去除长度字段。在此示例中，我们指定了 2，与长度字段的长度相同，以去除前两个字节。 BEFORE DECODE (14 bytes) AFTER DECODE (12 bytes) +--------+----------------+ +----------------+ | Length | Actual Content |----->| Actual Content | | 0x000C | "HELLO, WORLD" | | "HELLO, WORLD" | +--------+----------------+ +----------------+注意: 这里的长度字段(lengthFieldLength)表示内容的长度+长度字段的长度 由于有跳过处理（initialBytesToStrip），去除前两个字节，所以处理后的数据是内容 #偏移量为 0 处的 2 字节长度字段，不要剥离标头，长度字段表示整个消息的长度 在大多数情况下，长度字段仅表示邮件正文的长度，如前面的示例所示。 但是，在某些协议中，长度字段表示整个消息的长度，包括消息标头。 在这种情况下，我们指定一个非零长度调整。由于此示例消息中的长度值始终大于正文长度 2，因此我们将 -2 指定为 lengthAdjust 以进行补偿。 lengthFieldOffset = 0 lengthFieldLength = 2 lengthAdjustment = -2 (= 长度字段的长度) initialBytesToStrip = 0 BEFORE DECODE (14 bytes) AFTER DECODE (14 bytes) +--------+----------------+ +--------+----------------+ | Length | Actual Content |----->| Length | Actual Content | | 0x000E | "HELLO, WORLD" | | 0x000E | "HELLO, WORLD" | +--------+----------------+ +--------+----------------+注意: 这里的长度字段(lengthFieldLength)表示整个消息的长度，包括消息标头 lengthAdjustment：对消息进行补偿，例如总长度是14字节，长度字段是2字节，内容长度为14+（-2） 特殊例子，很简单 #5 字节标头末尾的 3 字节长度字段，不要去除标头 以下消息是第一个示例的简单变体。消息前面附加了一个额外的标头值。lengthAdjustment 再次为零，因为解码器在计算帧长度时始终考虑预置数据的长度 lengthFieldOffset = 2 (= the length of Header 1) lengthFieldLength = 3 lengthAdjustment = 0 initialBytesToStrip = 0 BEFORE DECODE (17 bytes) AFTER DECODE (17 bytes) +----------+----------+----------------+ +----------+----------+----------------+ | Header 1 | Length | Actual Content |----->| Header 1 | Length | Actual Content | | 0xCAFE | 0x00000C | "HELLO, WORLD" | | 0xCAFE | 0x00000C | "HELLO, WORLD" | +----------+----------+----------------+ +----------+----------+----------------+ #5 字节标头开头的 3 字节长度字段，不要去除标头 这是一个高级示例，显示了长度字段和邮件正文之间有一个额外标头的情况。您必须指定正 lengthAdjustment，以便解码器将额外的标头计入帧长度计算中。 lengthFieldOffset = 0 lengthFieldLength = 3 lengthAdjustment = 2 (= the length of Header 1) initialBytesToStrip = 0 BEFORE DECODE (17 bytes) AFTER DECODE (17 bytes) +----------+----------+----------------+ +----------+----------+----------------+ | Length | Header 1 | Actual Content |----->| Length | Header 1 | Actual Content | | 0x00000C | 0xCAFE | "HELLO, WORLD" | | 0x00000C | 0xCAFE | "HELLO, WORLD" | +----------+----------+----------------+ +----------+----------+----------------+ #2 字节长度字段位于 4 字节标头中间的偏移量 1，去除第一个标头字段和长度字段 这是上述所有示例的组合。长度字段之前有前缀标头，长度字段之后有额外的标头。 前面的标头会影响 lengthFieldOffset，而额外的标头会影响 lengthAdjustment。 我们还指定了一个非零的 initialBytesToStrip 来从帧中去除长度字段和前置标头。 如果不想去除前面的标头，可以为 initialBytesToSkip 指定 0。 lengthFieldOffset = 1 (= the length of HDR1) #长度字段的起始偏移量 lengthFieldLength = 2 #长度字段的占用字节数 lengthAdjustment = 1 (= the length of HDR2) #内容长度的字节数补偿字节数（HDR2的字节数） 注意是正数 initialBytesToStrip = 3 (= the length of HDR1 + LEN) #跳过的长度 ((HDR1的字节数)+长度字段的字节) BEFORE DECODE (16 bytes) AFTER DECODE (13 bytes) +------+--------+------+----------------+ +------+----------------+ | HDR1 | Length | HDR2 | Actual Content |----->| HDR2 | Actual Content | | 0xCA | 0x000C | 0xFE | "HELLO, WORLD" | | 0xFE | "HELLO, WORLD" | +------+--------+------+----------------+ +------+----------------+ #2字节长度字段在偏移量1处4字节头的中间，去掉第一个头字段和长度字段，长度字段代表整个消息的长度 让我们对前面的例子再做一个转折。与前面的示例的唯一区别是，长度字段表示整个消息的长度，而不是消息正文， 就像第三个示例一样。我们必须将 HDR1 和长度的长度计算成长度调整。请注意，我们不需要考虑 HDR2 的长度，因为长度字段已经包含整个标头长度。 lengthFieldOffset = 1 #长度字段的起始偏移量 lengthFieldLength = 2 #长度字段的占用字节数 lengthAdjustment = -3 (= the length of HDR1 + LEN, negative) #内容长度的字节数补偿字节数（HDR2的字节数） 注意是负数 initialBytesToStrip = 3 #跳过的长度 ((HDR1的字节数)+长度字段的字节) BEFORE DECODE (16 bytes) AFTER DECODE (13 bytes) +------+--------+------+----------------+ +------+----------------+ | HDR1 | Length | HDR2 | Actual Content |----->| HDR2 | Actual Content | | 0xCA | 0x0010 | 0xFE | "HELLO, WORLD" | | 0xFE | "HELLO, WORLD" | +------+--------+------+----------------+ +------+----------------+长度字段代表整个消息的长度 LengthFieldPrepender public LengthFieldPrepender( ByteOrder byteOrder, int lengthFieldLength, int lengthAdjustment, boolean lengthIncludesLengthFieldLength)byteOrder – 长度字段的ByteOrder lengthFieldLength –预先结束的长度字段的长度。只允许使用1、2、3、4和8。 lengthAdjustment – 要添加到长度字段值的补偿值 lengthIncludesLengthFieldLength – 如果为true，则将前缀长度字段的长度添加到前缀长度字段值中。 一种编码器，用于预先设置消息的长度。长度值的前缀为二进制形式。 例如，LengthFieldPrepender（2）将对以下12字节的字符串进行编码： +----------------+ | "HELLO, WORLD" | +----------------+ 转换后结构: +--------+----------------+ + 0x000C | "HELLO, WORLD" | +--------+----------------+ 如果在构造函数中启用lengthIncludesLengthFieldLength标志，则编码数据将如下所示（12（原始数据）+2（预处理数据）=14（0xE））： +--------+----------------+ + 0x000E | "HELLO, WORLD" | +--------+----------------+LengthFieldPrepender是Netty中的一个编码器，用于在消息前面添加一个表示消息长度的字段。它可以将消息转换为字节数组，并在消息前面添加一个表示消息长度的字段，通常是4个字节。这个字段的值表示消息的长度，使得接收方可以根据这个长度来正确地解析消息。 LengthFieldPrepender通常与LengthFieldBasedFrameDecoder一起使用，后者是一个解码器，用于从字节数组中解析出消息。LengthFieldPrepender和LengthFieldBasedFrameDecoder一起使用可以实现TCP粘包和拆包的处理，确保接收方可以正确地解析出发送方发送的消息。 |
| CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |