Trait xso::DynNamespaceEnum

pub trait DynNamespaceEnum: Sized + PartialEq<str> {
    // Required methods
    fn from_xml_text(s: &str) -> Result<Self, DynNamespaceError>;
    fn into_xml_text(self) -> String;
}

Enumeration of possible dynamically determined namespaces.

This trait must be implemented on types used on #[xml(namespace)] fields.

It allows to specify XML elements which can be parsed in different namespaces. This can be useful in weird protocols (looking at you, XMPP) where the same element occurs in multiple different namespaces. The namespace is then kept in the field and is thus available at serialisation time.

This trait depends on PartialEq<str>; this is used to compare a value against the value of an xmlns attribute without requiring to go through (potentially costly and also error-inducing) Self::from_xml_text.

Required Methods

fn from_xml_text(s: &str) -> Result<Self, DynNamespaceError>

Parse the namespace from the xmlns attribute data.

This should return Mismatch for namespaces which are not part of the enumeration of matching namespaces. In such cases, the parser may attempt to parse using another FromXml implementation.

You can also return Invalid to abort parsing altogether; this is probably not what you want, though.

fn into_xml_text(self) -> String

Convert the namespace into the text value of an xmlns attribute.

Object Safety

This trait is not object safe.

Implementors