// Copyright (c) 2018 Emmanuel Gil Peyrot // // This Source Code Form is subject to the terms of the Mozilla Public // License, v. 2.0. If a copy of the MPL was not distributed with this // file, You can obtain one at http://mozilla.org/MPL/2.0/. use xso::{AsXml, FromXml}; use crate::ns; use crate::stanza_error::DefinedCondition; /// Acknowledgement of the currently received stanzas. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::SM, name = "a")] pub struct A { /// The last handled stanza. #[xml(attribute)] pub h: u32, } impl A { /// Generates a new `` element. pub fn new(h: u32) -> A { A { h } } } generate_attribute!( /// Whether to allow resumption of a previous stream. ResumeAttr, "resume", bool ); /// Client request for enabling stream management. #[derive(FromXml, AsXml, PartialEq, Debug, Clone, Default)] #[xml(namespace = ns::SM, name = "enable")] pub struct Enable { /// The preferred resumption time in seconds by the client. // TODO: should be the infinite integer set ≥ 1. #[xml(attribute(default))] pub max: Option, /// Whether the client wants to be allowed to resume the stream. #[xml(attribute(default))] pub resume: ResumeAttr, } impl Enable { /// Generates a new `` element. pub fn new() -> Self { Enable::default() } /// Sets the preferred resumption time in seconds. pub fn with_max(mut self, max: u32) -> Self { self.max = Some(max); self } /// Asks for resumption to be possible. pub fn with_resume(mut self) -> Self { self.resume = ResumeAttr::True; self } } generate_id!( /// A random identifier used for stream resumption. StreamId ); /// Server response once stream management is enabled. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::SM, name = "enabled")] pub struct Enabled { /// A random identifier used for stream resumption. #[xml(attribute(default))] pub id: Option, /// The preferred IP, domain, IP:port or domain:port location for /// resumption. #[xml(attribute(default))] pub location: Option, /// The preferred resumption time in seconds by the server. // TODO: should be the infinite integer set ≥ 1. #[xml(attribute(default))] pub max: Option, /// Whether stream resumption is allowed. #[xml(attribute(default))] pub resume: ResumeAttr, } /// A stream management error happened. #[derive(FromXml, AsXml, Debug, PartialEq, Clone)] #[xml(namespace = ns::SM, name = "failed")] pub struct Failed { /// The last handled stanza. #[xml(attribute)] pub h: Option, /// The error returned. // XXX: implement the * handling. #[xml(child(default))] pub error: Option, } /// Requests the currently received stanzas by the other party. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::SM, name = "r")] pub struct R; /// Requests a stream resumption. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::SM, name = "resume")] pub struct Resume { /// The last handled stanza. #[xml(attribute)] pub h: u32, /// The previous id given by the server on /// [enabled](struct.Enabled.html). #[xml(attribute)] pub previd: StreamId, } /// The response by the server for a successfully resumed stream. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::SM, name = "resumed")] pub struct Resumed { /// The last handled stanza. #[xml(attribute)] pub h: u32, /// The previous id given by the server on /// [enabled](struct.Enabled.html). #[xml(attribute)] pub previd: StreamId, } // TODO: add support for optional and required. /// Represents availability of Stream Management in ``. #[derive(FromXml, AsXml, PartialEq, Debug, Clone)] #[xml(namespace = ns::SM, name = "sm")] pub struct StreamManagement; #[cfg(test)] mod tests { use super::*; use minidom::Element; #[cfg(target_pointer_width = "32")] #[test] fn test_size() { assert_size!(A, 4); assert_size!(ResumeAttr, 1); assert_size!(Enable, 12); assert_size!(StreamId, 12); assert_size!(Enabled, 36); assert_size!(Failed, 24); assert_size!(R, 0); assert_size!(Resume, 16); assert_size!(Resumed, 16); assert_size!(StreamManagement, 0); } #[cfg(target_pointer_width = "64")] #[test] fn test_size() { assert_size!(A, 4); assert_size!(ResumeAttr, 1); assert_size!(Enable, 12); assert_size!(StreamId, 24); assert_size!(Enabled, 64); assert_size!(Failed, 40); assert_size!(R, 0); assert_size!(Resume, 32); assert_size!(Resumed, 32); assert_size!(StreamManagement, 0); } #[test] fn a() { let elem: Element = "".parse().unwrap(); let a = A::try_from(elem).unwrap(); assert_eq!(a.h, 5); } #[test] fn stream_feature() { let elem: Element = "".parse().unwrap(); StreamManagement::try_from(elem).unwrap(); } #[test] fn resume() { let elem: Element = "" .parse() .unwrap(); let enable = Enable::try_from(elem).unwrap(); assert_eq!(enable.max, None); assert_eq!(enable.resume, ResumeAttr::True); let elem: Element = "" .parse() .unwrap(); let enabled = Enabled::try_from(elem).unwrap(); let previd = enabled.id.unwrap(); assert_eq!(enabled.resume, ResumeAttr::True); assert_eq!(previd, StreamId(String::from("coucou"))); assert_eq!(enabled.max, Some(600)); assert_eq!(enabled.location, None); let elem: Element = "" .parse() .unwrap(); let resume = Resume::try_from(elem).unwrap(); assert_eq!(resume.h, 5); assert_eq!(resume.previd, previd); let elem: Element = "" .parse() .unwrap(); let resumed = Resumed::try_from(elem).unwrap(); assert_eq!(resumed.h, 5); assert_eq!(resumed.previd, previd); } #[test] fn test_serialize_failed() { let reference: Element = "" .parse() .unwrap(); let elem: Element = "" .parse() .unwrap(); let error = DefinedCondition::try_from(elem).unwrap(); let failed = Failed { h: None, error: Some(error), }; let serialized: Element = failed.into(); assert_eq!(serialized, reference); } }