Trait xso::ElementCodec

pub trait ElementCodec<T>: Sized {
    // Required methods
    fn decode(value: Self) -> Result<T, Error>;
    fn encode(value: T) -> Result<Self, Error>;
}

Trait to support destructuring of child structs beyond what the extract(..) attribute can deliver.

This trait can only be sensibly implemented on types which implement both FromXml and IntoXml. However, as there may be corner cases where only one of these other traits is needed, they’re not strictly included in the trait bounds.

When used as value for codec = .. inside a #[xml(child(..))] or #[xml(children(..))] field attribute, the field is destructured using the trait implementations of FromXml / IntoXml and then converted to the actual field’s type by invoking the ElementCodec<T> methods, with T being the field type.

This trait is automatically implemented on minidom::Element for all types which can be converted to and from minidom::Element with an error which is convertible to crate::error::Error.

Required Methods

fn decode(value: Self) -> Result<T, Error>

Transform the destructured value further toward the field type.

fn encode(value: T) -> Result<Self, Error>

Transform the field type back to something which can be structured into XML.

Object Safety

This trait is not object safe.

Implementations on Foreign Types

impl<EI, EF, T> ElementCodec<T> for Element

where T: TryFrom<Element, Error = EF>, Element: TryFrom<T, Error = EI>, Error: From<EI> + From<EF>,

fn decode(value: Self) -> Result<T, Error>

fn encode(value: T) -> Result<Self, Error>

impl<T, U: ElementCodec<T>> ElementCodec<Option<T>> for Option<U>

fn decode(value: Self) -> Result<Option<T>, Error>

fn encode(value: Option<T>) -> Result<Self, Error>

Implementors