Enum MqttCodec

pub enum MqttCodec {
    V3(Codec),
    V5(Codec),
    Version(VersionCodec),
}

Main MQTT protocol codec implementation

Handles version negotiation and provides unified interface for:

• MQTT v3.1.1
• MQTT v5.0
• Protocol version detection

Variants

V3(Codec)

MQTT v3.1.1 codec

V5(Codec)

MQTT v5.0 codec

Version(VersionCodec)

Protocol version detection codec (used during initial handshake)

Trait Implementations

impl Debug for MqttCodec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Decoder for MqttCodec

fn decode( &mut self, src: &mut BytesMut, ) -> Result<Option<Self::Item>, Self::Error>

Decodes network bytes into MQTT packets

Returns tuple containing:

• Decoded packet
• Number of bytes consumed from input buffer

Example

use bytes::{BytesMut, BufMut};
use rmqtt_codec::{MqttCodec, v3};
use tokio_util::codec::Decoder;

let mut codec = MqttCodec::V3(v3::Codec::new(1024*1024));
let mut buffer = BytesMut::new();
buffer.put_slice(b"\x30\x00"); // Publish packet
let packet = codec.decode(&mut buffer);

type Item = (MqttPacket, u32)

The type of decoded frames.

type Error = DecodeError

The type of unrecoverable frame decoding errors.

fn decode_eof( &mut self, buf: &mut BytesMut, ) -> Result<Option<Self::Item>, Self::Error>

A default method available to be called when there are no more bytes available to be read from the underlying I/O.

fn framed<T>(self, io: T) -> Framed<T, Self>

where T: AsyncRead + AsyncWrite, Self: Sized,

Provides a Stream and Sink interface for reading and writing to this Io object, using Decode and Encode to read and write the raw data.

impl Encoder<MqttPacket> for MqttCodec

fn encode( &mut self, item: MqttPacket, dst: &mut BytesMut, ) -> Result<(), Self::Error>

Encodes MQTT packets according to active protocol version

Example

use bytes::BytesMut;
use rmqtt_codec::{MqttCodec, MqttPacket, v3};
use tokio_util::codec::Encoder;

let mut codec = MqttCodec::V3(v3::Codec::new(1024*1024));
let mut buffer = BytesMut::new();
let packet = MqttPacket::V3(v3::Packet::PingRequest);
codec.encode(packet, &mut buffer).unwrap();

type Error = EncodeError

The type of encoding errors.