2017-04-29 21:14:34 +00:00
|
|
|
|
// Copyright (c) 2017 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
|
|
|
|
|
//
|
|
|
|
|
// 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/.
|
|
|
|
|
|
2018-08-08 16:48:05 +00:00
|
|
|
|
#![allow(missing_docs)]
|
|
|
|
|
|
2017-07-20 19:03:15 +00:00
|
|
|
|
use try_from::TryFrom;
|
2017-04-19 01:27:42 +00:00
|
|
|
|
use std::str::FromStr;
|
|
|
|
|
|
2018-05-14 14:12:56 +00:00
|
|
|
|
use minidom::Element;
|
2017-05-24 21:28:54 +00:00
|
|
|
|
use jid::Jid;
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
use error::Error;
|
2017-04-20 22:16:12 +00:00
|
|
|
|
use ns;
|
2018-05-16 13:08:17 +00:00
|
|
|
|
use iq::IqSetPayload;
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
2018-09-20 18:28:50 +00:00
|
|
|
|
generate_attribute!(
|
|
|
|
|
/// The action attribute.
|
|
|
|
|
Action, "action", {
|
|
|
|
|
/// Accept a content-add action received from another party.
|
|
|
|
|
ContentAccept => "content-accept",
|
|
|
|
|
|
|
|
|
|
/// Add one or more new content definitions to the session.
|
|
|
|
|
ContentAdd => "content-add",
|
|
|
|
|
|
|
|
|
|
/// Change the directionality of media sending.
|
|
|
|
|
ContentModify => "content-modify",
|
|
|
|
|
|
|
|
|
|
/// Reject a content-add action received from another party.
|
|
|
|
|
ContentReject => "content-reject",
|
|
|
|
|
|
|
|
|
|
/// Remove one or more content definitions from the session.
|
|
|
|
|
ContentRemove => "content-remove",
|
|
|
|
|
|
|
|
|
|
/// Exchange information about parameters for an application type.
|
|
|
|
|
DescriptionInfo => "description-info",
|
|
|
|
|
|
|
|
|
|
/// Exchange information about security preconditions.
|
|
|
|
|
SecurityInfo => "security-info",
|
|
|
|
|
|
|
|
|
|
/// Definitively accept a session negotiation.
|
|
|
|
|
SessionAccept => "session-accept",
|
|
|
|
|
|
|
|
|
|
/// Send session-level information, such as a ping or a ringing message.
|
|
|
|
|
SessionInfo => "session-info",
|
|
|
|
|
|
|
|
|
|
/// Request negotiation of a new Jingle session.
|
|
|
|
|
SessionInitiate => "session-initiate",
|
|
|
|
|
|
|
|
|
|
/// End an existing session.
|
|
|
|
|
SessionTerminate => "session-terminate",
|
|
|
|
|
|
|
|
|
|
/// Accept a transport-replace action received from another party.
|
|
|
|
|
TransportAccept => "transport-accept",
|
|
|
|
|
|
|
|
|
|
/// Exchange transport candidates.
|
|
|
|
|
TransportInfo => "transport-info",
|
|
|
|
|
|
|
|
|
|
/// Reject a transport-replace action received from another party.
|
|
|
|
|
TransportReject => "transport-reject",
|
|
|
|
|
|
|
|
|
|
/// Redefine a transport method or replace it with a different method.
|
|
|
|
|
TransportReplace => "transport-replace",
|
|
|
|
|
}
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
generate_attribute!(
|
|
|
|
|
/// Which party originally generated the content type.
|
|
|
|
|
Creator, "creator", {
|
|
|
|
|
/// This content was created by the initiator of this session.
|
|
|
|
|
Initiator => "initiator",
|
|
|
|
|
|
|
|
|
|
/// This content was created by the responder of this session.
|
|
|
|
|
Responder => "responder",
|
|
|
|
|
}
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
generate_attribute!(
|
|
|
|
|
/// Which parties in the session will be generating content.
|
|
|
|
|
Senders, "senders", {
|
|
|
|
|
/// Both parties can send for this content.
|
|
|
|
|
Both => "both",
|
|
|
|
|
|
|
|
|
|
/// Only the initiator can send for this content.
|
|
|
|
|
Initiator => "initiator",
|
|
|
|
|
|
|
|
|
|
/// No one can send for this content.
|
|
|
|
|
None => "none",
|
|
|
|
|
|
|
|
|
|
/// Only the responder can send for this content.
|
|
|
|
|
Responder => "responder",
|
|
|
|
|
}, Default = Both
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
generate_attribute!(
|
|
|
|
|
/// How the content definition is to be interpreted by the recipient. The
|
|
|
|
|
/// meaning of this attribute matches the "Content-Disposition" header as
|
|
|
|
|
/// defined in RFC 2183 and applied to SIP by RFC 3261.
|
|
|
|
|
///
|
|
|
|
|
/// Possible values are defined here:
|
|
|
|
|
/// https://www.iana.org/assignments/cont-disp/cont-disp.xhtml
|
|
|
|
|
Disposition, "disposition", {
|
|
|
|
|
/// Displayed automatically.
|
|
|
|
|
Inline => "inline",
|
|
|
|
|
|
|
|
|
|
/// User controlled display.
|
|
|
|
|
Attachment => "attachment",
|
|
|
|
|
|
|
|
|
|
/// Process as form response.
|
|
|
|
|
FormData => "form-data",
|
|
|
|
|
|
|
|
|
|
/// Tunneled content to be processed silently.
|
|
|
|
|
Signal => "signal",
|
|
|
|
|
|
|
|
|
|
/// The body is a custom ring tone to alert the user.
|
|
|
|
|
Alert => "alert",
|
|
|
|
|
|
|
|
|
|
/// The body is displayed as an icon to the user.
|
|
|
|
|
Icon => "icon",
|
|
|
|
|
|
|
|
|
|
/// The body should be displayed to the user.
|
|
|
|
|
Render => "render",
|
|
|
|
|
|
|
|
|
|
/// The body contains a list of URIs that indicates the recipients of
|
|
|
|
|
/// the request.
|
|
|
|
|
RecipientListHistory => "recipient-list-history",
|
|
|
|
|
|
|
|
|
|
/// The body describes a communications session, for example, an
|
|
|
|
|
/// RFC2327 SDP body.
|
|
|
|
|
Session => "session",
|
|
|
|
|
|
|
|
|
|
/// Authenticated Identity Body.
|
|
|
|
|
Aib => "aib",
|
|
|
|
|
|
|
|
|
|
/// The body describes an early communications session, for example,
|
|
|
|
|
/// and [RFC2327] SDP body.
|
|
|
|
|
EarlySession => "early-session",
|
|
|
|
|
|
|
|
|
|
/// The body includes a list of URIs to which URI-list services are to
|
|
|
|
|
/// be applied.
|
|
|
|
|
RecipientList => "recipient-list",
|
|
|
|
|
|
|
|
|
|
/// The payload of the message carrying this Content-Disposition header
|
|
|
|
|
/// field value is an Instant Message Disposition Notification as
|
|
|
|
|
/// requested in the corresponding Instant Message.
|
|
|
|
|
Notification => "notification",
|
|
|
|
|
|
|
|
|
|
/// The body needs to be handled according to a reference to the body
|
|
|
|
|
/// that is located in the same SIP message as the body.
|
|
|
|
|
ByReference => "by-reference",
|
|
|
|
|
|
|
|
|
|
/// The body contains information associated with an Info Package.
|
|
|
|
|
InfoPackage => "info-package",
|
|
|
|
|
|
|
|
|
|
/// The body describes either metadata about the RS or the reason for
|
|
|
|
|
/// the metadata snapshot request as determined by the MIME value
|
|
|
|
|
/// indicated in the Content-Type.
|
|
|
|
|
RecordingSession => "recording-session",
|
|
|
|
|
}, Default = Session
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
generate_id!(
|
|
|
|
|
/// An unique identifier in a session, referencing a
|
|
|
|
|
/// [struct.Content.html](Content element).
|
|
|
|
|
ContentId
|
|
|
|
|
);
|
2017-07-29 01:47:33 +00:00
|
|
|
|
|
2018-05-28 14:45:13 +00:00
|
|
|
|
generate_element!(
|
2018-05-28 14:29:51 +00:00
|
|
|
|
Content, "content", JINGLE,
|
|
|
|
|
attributes: [
|
2018-09-20 18:28:50 +00:00
|
|
|
|
/// Who created this content.
|
2018-05-28 14:29:51 +00:00
|
|
|
|
creator: Creator = "creator" => required,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// How the content definition is to be interpreted by the recipient.
|
2018-05-28 14:29:51 +00:00
|
|
|
|
disposition: Disposition = "disposition" => default,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// A per-session unique identifier for this content.
|
2018-05-28 14:29:51 +00:00
|
|
|
|
name: ContentId = "name" => required,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// Who can send data for this content.
|
2018-05-28 14:29:51 +00:00
|
|
|
|
senders: Senders = "senders" => default
|
|
|
|
|
],
|
|
|
|
|
children: [
|
|
|
|
|
description: Option<Element> = ("description", JINGLE) => Element,
|
|
|
|
|
transport: Option<Element> = ("transport", JINGLE) => Element,
|
|
|
|
|
security: Option<Element> = ("security", JINGLE) => Element
|
|
|
|
|
]
|
|
|
|
|
);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
2018-05-04 17:10:29 +00:00
|
|
|
|
impl Content {
|
|
|
|
|
pub fn new(creator: Creator, name: ContentId) -> Content {
|
|
|
|
|
Content {
|
|
|
|
|
creator,
|
|
|
|
|
name,
|
|
|
|
|
disposition: Disposition::Session,
|
|
|
|
|
senders: Senders::Both,
|
|
|
|
|
description: None,
|
|
|
|
|
transport: None,
|
|
|
|
|
security: None,
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_disposition(mut self, disposition: Disposition) -> Content {
|
|
|
|
|
self.disposition = disposition;
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_senders(mut self, senders: Senders) -> Content {
|
|
|
|
|
self.senders = senders;
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_description(mut self, description: Element) -> Content {
|
|
|
|
|
self.description = Some(description);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_transport(mut self, transport: Element) -> Content {
|
|
|
|
|
self.transport = Some(transport);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_security(mut self, security: Element) -> Content {
|
|
|
|
|
self.security = Some(security);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-04-20 23:41:15 +00:00
|
|
|
|
#[derive(Debug, Clone, PartialEq)]
|
2017-04-19 01:27:42 +00:00
|
|
|
|
pub enum Reason {
|
2018-09-20 18:28:50 +00:00
|
|
|
|
/// The party prefers to use an existing session with the peer rather than
|
|
|
|
|
/// initiate a new session; the Jingle session ID of the alternative
|
|
|
|
|
/// session SHOULD be provided as the XML character data of the <sid/>
|
|
|
|
|
/// child.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
AlternativeSession, //(String),
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party is busy and cannot accept a session.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Busy,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The initiator wishes to formally cancel the session initiation request.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Cancel,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The action is related to connectivity problems.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
ConnectivityError,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party wishes to formally decline the session.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Decline,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The session length has exceeded a pre-defined time limit (e.g., a
|
|
|
|
|
/// meeting hosted at a conference service).
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Expired,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party has been unable to initialize processing related to the
|
|
|
|
|
/// application type.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
FailedApplication,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party has been unable to establish connectivity for the transport
|
|
|
|
|
/// method.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
FailedTransport,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The action is related to a non-specific application error.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
GeneralError,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The entity is going offline or is no longer available.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Gone,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party supports the offered application type but does not support
|
|
|
|
|
/// the offered or negotiated parameters.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
IncompatibleParameters,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The action is related to media processing problems.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
MediaError,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The action is related to a violation of local security policies.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
SecurityError,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The action is generated during the normal course of state management
|
|
|
|
|
/// and does not reflect any error.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Success,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// A request has not been answered so the sender is timing out the
|
|
|
|
|
/// request.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
Timeout,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party supports none of the offered application types.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
UnsupportedApplications,
|
2018-09-20 18:28:50 +00:00
|
|
|
|
|
|
|
|
|
/// The party supports none of the offered transport methods.
|
2017-04-19 01:27:42 +00:00
|
|
|
|
UnsupportedTransports,
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
impl FromStr for Reason {
|
|
|
|
|
type Err = Error;
|
|
|
|
|
|
|
|
|
|
fn from_str(s: &str) -> Result<Reason, Error> {
|
2017-04-23 02:41:26 +00:00
|
|
|
|
Ok(match s {
|
|
|
|
|
"alternative-session" => Reason::AlternativeSession,
|
|
|
|
|
"busy" => Reason::Busy,
|
|
|
|
|
"cancel" => Reason::Cancel,
|
|
|
|
|
"connectivity-error" => Reason::ConnectivityError,
|
|
|
|
|
"decline" => Reason::Decline,
|
|
|
|
|
"expired" => Reason::Expired,
|
|
|
|
|
"failed-application" => Reason::FailedApplication,
|
|
|
|
|
"failed-transport" => Reason::FailedTransport,
|
|
|
|
|
"general-error" => Reason::GeneralError,
|
|
|
|
|
"gone" => Reason::Gone,
|
|
|
|
|
"incompatible-parameters" => Reason::IncompatibleParameters,
|
|
|
|
|
"media-error" => Reason::MediaError,
|
|
|
|
|
"security-error" => Reason::SecurityError,
|
|
|
|
|
"success" => Reason::Success,
|
|
|
|
|
"timeout" => Reason::Timeout,
|
|
|
|
|
"unsupported-applications" => Reason::UnsupportedApplications,
|
|
|
|
|
"unsupported-transports" => Reason::UnsupportedTransports,
|
|
|
|
|
|
|
|
|
|
_ => return Err(Error::ParseError("Unknown reason.")),
|
|
|
|
|
})
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-07-20 19:36:13 +00:00
|
|
|
|
impl From<Reason> for Element {
|
|
|
|
|
fn from(reason: Reason) -> Element {
|
|
|
|
|
Element::builder(match reason {
|
2017-04-28 22:45:02 +00:00
|
|
|
|
Reason::AlternativeSession => "alternative-session",
|
|
|
|
|
Reason::Busy => "busy",
|
|
|
|
|
Reason::Cancel => "cancel",
|
|
|
|
|
Reason::ConnectivityError => "connectivity-error",
|
|
|
|
|
Reason::Decline => "decline",
|
|
|
|
|
Reason::Expired => "expired",
|
|
|
|
|
Reason::FailedApplication => "failed-application",
|
|
|
|
|
Reason::FailedTransport => "failed-transport",
|
|
|
|
|
Reason::GeneralError => "general-error",
|
|
|
|
|
Reason::Gone => "gone",
|
|
|
|
|
Reason::IncompatibleParameters => "incompatible-parameters",
|
|
|
|
|
Reason::MediaError => "media-error",
|
|
|
|
|
Reason::SecurityError => "security-error",
|
|
|
|
|
Reason::Success => "success",
|
|
|
|
|
Reason::Timeout => "timeout",
|
|
|
|
|
Reason::UnsupportedApplications => "unsupported-applications",
|
|
|
|
|
Reason::UnsupportedTransports => "unsupported-transports",
|
2017-05-04 00:20:28 +00:00
|
|
|
|
}).build()
|
2017-04-28 22:45:02 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-04-20 23:41:15 +00:00
|
|
|
|
#[derive(Debug, Clone)]
|
2017-04-19 01:27:42 +00:00
|
|
|
|
pub struct ReasonElement {
|
|
|
|
|
pub reason: Reason,
|
|
|
|
|
pub text: Option<String>,
|
|
|
|
|
}
|
|
|
|
|
|
2017-05-24 21:28:54 +00:00
|
|
|
|
impl TryFrom<Element> for ReasonElement {
|
2017-07-20 19:03:15 +00:00
|
|
|
|
type Err = Error;
|
2017-05-24 21:28:54 +00:00
|
|
|
|
|
|
|
|
|
fn try_from(elem: Element) -> Result<ReasonElement, Error> {
|
2018-05-14 14:30:28 +00:00
|
|
|
|
check_self!(elem, "reason", JINGLE);
|
2017-05-24 21:28:54 +00:00
|
|
|
|
let mut reason = None;
|
|
|
|
|
let mut text = None;
|
|
|
|
|
for child in elem.children() {
|
2017-08-27 00:04:56 +00:00
|
|
|
|
if !child.has_ns(ns::JINGLE) {
|
2017-05-24 21:28:54 +00:00
|
|
|
|
return Err(Error::ParseError("Reason contains a foreign element."));
|
|
|
|
|
}
|
|
|
|
|
match child.name() {
|
|
|
|
|
"text" => {
|
|
|
|
|
if text.is_some() {
|
|
|
|
|
return Err(Error::ParseError("Reason must not have more than one text."));
|
|
|
|
|
}
|
|
|
|
|
text = Some(child.text());
|
|
|
|
|
},
|
|
|
|
|
name => {
|
|
|
|
|
if reason.is_some() {
|
|
|
|
|
return Err(Error::ParseError("Reason must not have more than one reason."));
|
|
|
|
|
}
|
|
|
|
|
reason = Some(name.parse()?);
|
|
|
|
|
},
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
let reason = reason.ok_or(Error::ParseError("Reason doesn’t contain a valid reason."))?;
|
|
|
|
|
Ok(ReasonElement {
|
|
|
|
|
reason: reason,
|
|
|
|
|
text: text,
|
|
|
|
|
})
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-07-20 19:36:13 +00:00
|
|
|
|
impl From<ReasonElement> for Element {
|
|
|
|
|
fn from(reason: ReasonElement) -> Element {
|
2017-05-24 21:28:54 +00:00
|
|
|
|
Element::builder("reason")
|
2017-07-20 19:36:13 +00:00
|
|
|
|
.append(Element::from(reason.reason))
|
|
|
|
|
.append(reason.text)
|
2017-05-24 21:28:54 +00:00
|
|
|
|
.build()
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2018-09-20 18:28:50 +00:00
|
|
|
|
generate_id!(
|
|
|
|
|
/// Unique identifier for a session between two JIDs.
|
|
|
|
|
SessionId
|
|
|
|
|
);
|
2017-06-14 01:28:42 +00:00
|
|
|
|
|
2017-04-20 23:41:15 +00:00
|
|
|
|
#[derive(Debug, Clone)]
|
2017-04-19 01:27:42 +00:00
|
|
|
|
pub struct Jingle {
|
|
|
|
|
pub action: Action,
|
|
|
|
|
pub initiator: Option<Jid>,
|
|
|
|
|
pub responder: Option<Jid>,
|
2017-06-25 21:14:51 +00:00
|
|
|
|
pub sid: SessionId,
|
2017-04-19 01:27:42 +00:00
|
|
|
|
pub contents: Vec<Content>,
|
|
|
|
|
pub reason: Option<ReasonElement>,
|
2017-04-28 22:45:27 +00:00
|
|
|
|
pub other: Vec<Element>,
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
|
2018-05-16 13:08:17 +00:00
|
|
|
|
impl IqSetPayload for Jingle {}
|
|
|
|
|
|
2018-05-04 17:10:29 +00:00
|
|
|
|
impl Jingle {
|
|
|
|
|
pub fn new(action: Action, sid: SessionId) -> Jingle {
|
|
|
|
|
Jingle {
|
|
|
|
|
action: action,
|
|
|
|
|
sid: sid,
|
|
|
|
|
initiator: None,
|
|
|
|
|
responder: None,
|
|
|
|
|
contents: Vec::new(),
|
|
|
|
|
reason: None,
|
|
|
|
|
other: Vec::new(),
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_initiator(mut self, initiator: Jid) -> Jingle {
|
|
|
|
|
self.initiator = Some(initiator);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn with_responder(mut self, responder: Jid) -> Jingle {
|
|
|
|
|
self.responder = Some(responder);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn add_content(mut self, content: Content) -> Jingle {
|
|
|
|
|
self.contents.push(content);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
pub fn set_reason(mut self, content: Content) -> Jingle {
|
|
|
|
|
self.contents.push(content);
|
|
|
|
|
self
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-05-23 22:31:33 +00:00
|
|
|
|
impl TryFrom<Element> for Jingle {
|
2017-07-20 19:03:15 +00:00
|
|
|
|
type Err = Error;
|
2017-04-19 22:41:54 +00:00
|
|
|
|
|
2017-05-23 22:31:33 +00:00
|
|
|
|
fn try_from(root: Element) -> Result<Jingle, Error> {
|
2018-05-14 14:30:28 +00:00
|
|
|
|
check_self!(root, "jingle", JINGLE, "Jingle");
|
2018-05-14 23:47:12 +00:00
|
|
|
|
check_no_unknown_attributes!(root, "Jingle", ["action", "initiator", "responder", "sid"]);
|
2017-05-04 00:20:28 +00:00
|
|
|
|
|
2017-05-24 21:28:54 +00:00
|
|
|
|
let mut jingle = Jingle {
|
|
|
|
|
action: get_attr!(root, "action", required),
|
|
|
|
|
initiator: get_attr!(root, "initiator", optional),
|
|
|
|
|
responder: get_attr!(root, "responder", optional),
|
|
|
|
|
sid: get_attr!(root, "sid", required),
|
|
|
|
|
contents: vec!(),
|
|
|
|
|
reason: None,
|
|
|
|
|
other: vec!(),
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
for child in root.children().cloned() {
|
2017-05-04 00:20:28 +00:00
|
|
|
|
if child.is("content", ns::JINGLE) {
|
2017-05-24 22:38:44 +00:00
|
|
|
|
let content = Content::try_from(child)?;
|
2017-05-24 21:28:54 +00:00
|
|
|
|
jingle.contents.push(content);
|
2017-05-04 00:20:28 +00:00
|
|
|
|
} else if child.is("reason", ns::JINGLE) {
|
2017-05-24 21:28:54 +00:00
|
|
|
|
if jingle.reason.is_some() {
|
2017-05-04 00:20:28 +00:00
|
|
|
|
return Err(Error::ParseError("Jingle must not have more than one reason."));
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
2017-05-24 22:38:44 +00:00
|
|
|
|
let reason = ReasonElement::try_from(child)?;
|
2017-05-24 21:28:54 +00:00
|
|
|
|
jingle.reason = Some(reason);
|
2017-05-04 00:20:28 +00:00
|
|
|
|
} else {
|
2017-05-24 22:38:44 +00:00
|
|
|
|
jingle.other.push(child);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-05-24 21:28:54 +00:00
|
|
|
|
Ok(jingle)
|
2017-04-24 18:25:00 +00:00
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2017-07-20 19:36:13 +00:00
|
|
|
|
impl From<Jingle> for Element {
|
|
|
|
|
fn from(jingle: Jingle) -> Element {
|
2017-05-24 21:28:54 +00:00
|
|
|
|
Element::builder("jingle")
|
|
|
|
|
.ns(ns::JINGLE)
|
2017-07-20 19:36:13 +00:00
|
|
|
|
.attr("action", jingle.action)
|
2017-07-29 05:28:20 +00:00
|
|
|
|
.attr("initiator", jingle.initiator)
|
|
|
|
|
.attr("responder", jingle.responder)
|
2017-07-20 19:36:13 +00:00
|
|
|
|
.attr("sid", jingle.sid)
|
|
|
|
|
.append(jingle.contents)
|
|
|
|
|
.append(jingle.reason)
|
2017-05-24 21:28:54 +00:00
|
|
|
|
.build()
|
2017-04-24 18:25:00 +00:00
|
|
|
|
}
|
2017-05-04 00:20:28 +00:00
|
|
|
|
}
|
|
|
|
|
|
2017-04-19 01:27:42 +00:00
|
|
|
|
#[cfg(test)]
|
|
|
|
|
mod tests {
|
2017-05-04 00:20:28 +00:00
|
|
|
|
use super::*;
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
|
fn test_simple() {
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'/>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let jingle = Jingle::try_from(elem).unwrap();
|
2017-05-04 00:20:28 +00:00
|
|
|
|
assert_eq!(jingle.action, Action::SessionInitiate);
|
2017-06-25 21:14:51 +00:00
|
|
|
|
assert_eq!(jingle.sid, SessionId(String::from("coucou")));
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
|
fn test_invalid_jingle() {
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1'/>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-05-24 21:28:54 +00:00
|
|
|
|
assert_eq!(message, "Required attribute 'action' missing.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-info'/>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-05-24 21:28:54 +00:00
|
|
|
|
assert_eq!(message, "Required attribute 'sid' missing.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='coucou' sid='coucou'/>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-06-13 23:50:57 +00:00
|
|
|
|
assert_eq!(message, "Unknown value for 'action' attribute.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
|
fn test_content() {
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='initiator' name='coucou'><description/><transport/></content></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let jingle = Jingle::try_from(elem).unwrap();
|
2017-05-04 00:20:28 +00:00
|
|
|
|
assert_eq!(jingle.contents[0].creator, Creator::Initiator);
|
2017-07-15 10:37:29 +00:00
|
|
|
|
assert_eq!(jingle.contents[0].name, ContentId(String::from("coucou")));
|
2017-05-04 00:20:28 +00:00
|
|
|
|
assert_eq!(jingle.contents[0].senders, Senders::Both);
|
2017-10-31 17:17:06 +00:00
|
|
|
|
assert_eq!(jingle.contents[0].disposition, Disposition::Session);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='initiator' name='coucou' senders='both'><description/><transport/></content></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let jingle = Jingle::try_from(elem).unwrap();
|
2017-05-04 00:20:28 +00:00
|
|
|
|
assert_eq!(jingle.contents[0].senders, Senders::Both);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='initiator' name='coucou' disposition='early-session'><description/><transport/></content></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let jingle = Jingle::try_from(elem).unwrap();
|
2017-10-31 17:17:06 +00:00
|
|
|
|
assert_eq!(jingle.contents[0].disposition, Disposition::EarlySession);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
|
fn test_invalid_content() {
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-05-24 21:28:54 +00:00
|
|
|
|
assert_eq!(message, "Required attribute 'creator' missing.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='initiator'/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-05-24 21:28:54 +00:00
|
|
|
|
assert_eq!(message, "Required attribute 'name' missing.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='coucou' name='coucou'/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-06-13 23:50:57 +00:00
|
|
|
|
assert_eq!(message, "Unknown value for 'creator' attribute.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='initiator' name='coucou' senders='coucou'/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-06-13 23:50:57 +00:00
|
|
|
|
assert_eq!(message, "Unknown value for 'senders' attribute.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><content creator='initiator' name='coucou' senders=''/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
2017-06-13 23:50:57 +00:00
|
|
|
|
assert_eq!(message, "Unknown value for 'senders' attribute.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
|
fn test_reason() {
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason><success/></reason></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let jingle = Jingle::try_from(elem).unwrap();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let reason = jingle.reason.unwrap();
|
2017-05-04 00:20:28 +00:00
|
|
|
|
assert_eq!(reason.reason, Reason::Success);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
assert_eq!(reason.text, None);
|
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason><success/><text>coucou</text></reason></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let jingle = Jingle::try_from(elem).unwrap();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let reason = jingle.reason.unwrap();
|
2017-05-04 00:20:28 +00:00
|
|
|
|
assert_eq!(reason.reason, Reason::Success);
|
2017-04-19 01:27:42 +00:00
|
|
|
|
assert_eq!(reason.text, Some(String::from("coucou")));
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
|
fn test_invalid_reason() {
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
|
|
|
|
assert_eq!(message, "Reason doesn’t contain a valid reason.");
|
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason><a/></reason></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
|
|
|
|
assert_eq!(message, "Unknown reason.");
|
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason><a xmlns='http://www.w3.org/1999/xhtml'/></reason></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
|
|
|
|
assert_eq!(message, "Reason contains a foreign element.");
|
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason><decline/></reason><reason/></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:27:42 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
|
|
|
|
assert_eq!(message, "Jingle must not have more than one reason.");
|
2017-04-19 01:38:10 +00:00
|
|
|
|
|
|
|
|
|
let elem: Element = "<jingle xmlns='urn:xmpp:jingle:1' action='session-initiate' sid='coucou'><reason><decline/><text/><text/></reason></jingle>".parse().unwrap();
|
2017-05-23 22:31:33 +00:00
|
|
|
|
let error = Jingle::try_from(elem).unwrap_err();
|
2017-04-19 01:38:10 +00:00
|
|
|
|
let message = match error {
|
|
|
|
|
Error::ParseError(string) => string,
|
|
|
|
|
_ => panic!(),
|
|
|
|
|
};
|
|
|
|
|
assert_eq!(message, "Reason must not have more than one text.");
|
2017-04-19 01:27:42 +00:00
|
|
|
|
}
|
|
|
|
|
}
|