use super::*;
use alloc::string::String;
use alloc::vec::Vec;
use bytes::{Buf, Bytes};
use core::fmt;
#[derive(Clone, PartialEq)]
pub struct Subscribe {
pub pkid: u16,
pub filters: Vec<SubscribeFilter>,
pub properties: Option<SubscribeProperties>,
}
impl Subscribe {
pub fn new<S: Into<String>>(path: S, qos: QoS) -> Subscribe {
let filter = SubscribeFilter {
path: path.into(),
qos,
nolocal: false,
preserve_retain: false,
retain_forward_rule: RetainForwardRule::OnEverySubscribe,
};
let mut filters = Vec::new();
filters.push(filter);
Subscribe {
pkid: 0,
filters,
properties: None,
}
}
pub fn new_many<T>(topics: T) -> Subscribe
where
T: IntoIterator<Item = SubscribeFilter>,
{
Subscribe {
pkid: 0,
filters: topics.into_iter().collect(),
properties: None,
}
}
pub fn empty_subscribe() -> Subscribe {
Subscribe {
pkid: 0,
filters: Vec::new(),
properties: None,
}
}
pub fn add(&mut self, path: String, qos: QoS) -> &mut Self {
let filter = SubscribeFilter {
path,
qos,
nolocal: false,
preserve_retain: false,
retain_forward_rule: RetainForwardRule::OnEverySubscribe,
};
self.filters.push(filter);
self
}
pub fn len(&self) -> usize {
let mut len = 2 + self.filters.iter().fold(0, |s, t| s + t.len());
if let Some(properties) = &self.properties {
let properties_len = properties.len();
let properties_len_len = len_len(properties_len);
len += properties_len_len + properties_len;
} else {
len += 1;
}
len
}
pub fn read(fixed_header: FixedHeader, mut bytes: Bytes) -> Result<Self, Error> {
let variable_header_index = fixed_header.fixed_header_len;
bytes.advance(variable_header_index);
let pkid = read_u16(&mut bytes)?;
let properties = SubscribeProperties::extract(&mut bytes)?;
let mut filters = Vec::new();
while bytes.has_remaining() {
let path = read_mqtt_string(&mut bytes)?;
let options = read_u8(&mut bytes)?;
let requested_qos = options & 0b0000_0011;
let nolocal = options >> 2 & 0b0000_0001;
let nolocal = if nolocal == 0 { false } else { true };
let preserve_retain = options >> 3 & 0b0000_0001;
let preserve_retain = if preserve_retain == 0 { false } else { true };
let retain_forward_rule = (options >> 4) & 0b0000_0011;
let retain_forward_rule = match retain_forward_rule {
0 => RetainForwardRule::OnEverySubscribe,
1 => RetainForwardRule::OnNewSubscribe,
2 => RetainForwardRule::Never,
r => return Err(Error::InvalidRetainForwardRule(r)),
};
filters.push(SubscribeFilter {
path,
qos: qos(requested_qos)?,
nolocal,
preserve_retain,
retain_forward_rule,
});
}
let subscribe = Subscribe {
pkid,
filters,
properties,
};
Ok(subscribe)
}
pub fn write(&self, buffer: &mut BytesMut) -> Result<usize, Error> {
buffer.put_u8(0x82);
let remaining_len = self.len();
let remaining_len_bytes = write_remaining_length(buffer, remaining_len)?;
buffer.put_u16(self.pkid);
match &self.properties {
Some(properties) => properties.write(buffer)?,
None => {
write_remaining_length(buffer, 0)?;
}
};
for filter in self.filters.iter() {
filter.write(buffer);
}
Ok(1 + remaining_len_bytes + remaining_len)
}
}
#[derive(Debug, Clone, PartialEq)]
pub struct SubscribeProperties {
pub id: Option<usize>,
pub user_properties: Vec<(String, String)>,
}
impl SubscribeProperties {
pub fn len(&self) -> usize {
let mut len = 0;
if let Some(id) = &self.id {
len += 1 + len_len(*id);
}
for (key, value) in self.user_properties.iter() {
len += 1 + 2 + key.len() + 2 + value.len();
}
len
}
pub fn extract(mut bytes: &mut Bytes) -> Result<Option<SubscribeProperties>, Error> {
let mut id = None;
let mut user_properties = Vec::new();
let (properties_len_len, properties_len) = length(bytes.iter())?;
bytes.advance(properties_len_len);
if properties_len == 0 {
return Ok(None);
}
let mut cursor = 0;
while cursor < properties_len {
let prop = read_u8(&mut bytes)?;
cursor += 1;
match property(prop)? {
PropertyType::SubscriptionIdentifier => {
let (id_len, sub_id) = length(bytes.iter())?;
cursor += 1 + id_len;
bytes.advance(id_len);
id = Some(sub_id)
}
PropertyType::UserProperty => {
let key = read_mqtt_string(&mut bytes)?;
let value = read_mqtt_string(&mut bytes)?;
cursor += 2 + key.len() + 2 + value.len();
user_properties.push((key, value));
}
_ => return Err(Error::InvalidPropertyType(prop)),
}
}
Ok(Some(SubscribeProperties {
id,
user_properties,
}))
}
fn write(&self, buffer: &mut BytesMut) -> Result<(), Error> {
let len = self.len();
write_remaining_length(buffer, len)?;
if let Some(id) = &self.id {
buffer.put_u8(PropertyType::SubscriptionIdentifier as u8);
write_remaining_length(buffer, *id)?;
}
for (key, value) in self.user_properties.iter() {
buffer.put_u8(PropertyType::UserProperty as u8);
write_mqtt_string(buffer, key);
write_mqtt_string(buffer, value);
}
Ok(())
}
}
#[derive(Clone, PartialEq)]
pub struct SubscribeFilter {
pub path: String,
pub qos: QoS,
pub nolocal: bool,
pub preserve_retain: bool,
pub retain_forward_rule: RetainForwardRule,
}
impl SubscribeFilter {
pub fn new(path: String, qos: QoS) -> SubscribeFilter {
SubscribeFilter {
path,
qos,
nolocal: false,
preserve_retain: false,
retain_forward_rule: RetainForwardRule::OnEverySubscribe,
}
}
pub fn set_nolocal(&mut self, flag: bool) -> &mut Self {
self.nolocal = flag;
self
}
pub fn set_preserve_retain(&mut self, flag: bool) -> &mut Self {
self.preserve_retain = flag;
self
}
pub fn set_retain_forward_rule(&mut self, rule: RetainForwardRule) -> &mut Self {
self.retain_forward_rule = rule;
self
}
pub fn len(&self) -> usize {
2 + self.path.len() + 1
}
fn write(&self, buffer: &mut BytesMut) {
let mut options = 0;
options |= self.qos as u8;
if self.nolocal {
options |= 1 << 2;
}
if self.preserve_retain {
options |= 1 << 3;
}
match self.retain_forward_rule {
RetainForwardRule::OnEverySubscribe => options |= 0 << 4,
RetainForwardRule::OnNewSubscribe => options |= 1 << 4,
RetainForwardRule::Never => options |= 2 << 4,
}
write_mqtt_string(buffer, self.path.as_str());
buffer.put_u8(options);
}
}
#[derive(Debug, Clone, PartialEq)]
pub enum RetainForwardRule {
OnEverySubscribe,
OnNewSubscribe,
Never,
}
impl fmt::Debug for Subscribe {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(
f,
"Filters = {:?}, Packet id = {:?}",
self.filters, self.pkid
)
}
}
impl fmt::Debug for SubscribeFilter {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(
f,
"Filter = {}, Qos = {:?}, Nolocal = {}, Preserve retain = {}, Forward rule = {:?}",
self.path, self.qos, self.nolocal, self.preserve_retain, self.retain_forward_rule
)
}
}
#[cfg(test)]
mod test {
use super::*;
use alloc::vec;
use bytes::BytesMut;
use pretty_assertions::assert_eq;
fn sample() -> Subscribe {
let subscribe_properties = SubscribeProperties {
id: Some(100),
user_properties: vec![("test".to_owned(), "test".to_owned())],
};
let mut filter = SubscribeFilter::new("hello".to_owned(), QoS::AtLeastOnce);
filter
.set_nolocal(true)
.set_preserve_retain(true)
.set_retain_forward_rule(RetainForwardRule::Never);
Subscribe {
pkid: 42,
filters: vec![filter],
properties: Some(subscribe_properties),
}
}
fn sample_bytes() -> Vec<u8> {
vec![
0x82, 0x1a, 0x00, 0x2a, 0x0f, 0x0b, 0x64, 0x26, 0x00, 0x04, 0x74, 0x65, 0x73, 0x74, 0x00, 0x04, 0x74, 0x65, 0x73,
0x74, 0x00, 0x05, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x2d, ]
}
#[test]
fn subscribe_parsing_works() {
let mut stream = BytesMut::new();
let packetstream = &sample_bytes();
stream.extend_from_slice(&packetstream[..]);
let fixed_header = parse_fixed_header(stream.iter()).unwrap();
let subscribe_bytes = stream.split_to(fixed_header.frame_length()).freeze();
let subscribe = Subscribe::read(fixed_header, subscribe_bytes).unwrap();
assert_eq!(subscribe, sample());
}
#[test]
fn subscribe_encoding_works() {
let publish = sample();
let mut buf = BytesMut::new();
publish.write(&mut buf).unwrap();
assert_eq!(&buf[..], sample_bytes());
}
fn sample2() -> Subscribe {
let filter = SubscribeFilter::new("hello/world".to_owned(), QoS::AtLeastOnce);
Subscribe {
pkid: 42,
filters: vec![filter],
properties: None,
}
}
fn sample2_bytes() -> Vec<u8> {
vec![
0x82, 0x11, 0x00, 0x2a, 0x00, 0x00, 0x0b, 0x68, 0x65, 0x6c, 0x6c, 0x6f, 0x2f, 0x77,
0x6f, 0x72, 0x6c, 0x64, 0x01,
]
}
#[test]
fn subscribe2_parsing_works() {
let mut stream = BytesMut::new();
let packetstream = &sample2_bytes();
stream.extend_from_slice(&packetstream[..]);
let fixed_header = parse_fixed_header(stream.iter()).unwrap();
let subscribe_bytes = stream.split_to(fixed_header.frame_length()).freeze();
let subscribe = Subscribe::read(fixed_header, subscribe_bytes).unwrap();
assert_eq!(subscribe, sample2());
}
#[test]
fn subscribe2_encoding_works() {
let publish = sample2();
let mut buf = BytesMut::new();
publish.write(&mut buf).unwrap();
assert_eq!(&buf[..], sample2_bytes());
}
}