Custom serialization
Serde's derive macro through #[derive(Serialize, Deserialize)]
provides reasonable default serialization behavior for structs and enums and it
can be customized to some extent using attributes. For unusual
needs, Serde allows full customization of the serialization behavior by manually
implementing Serialize
and Deserialize
traits for your type.
The traits each have a single method:
pub trait Serialize {
fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where
S: Serializer;
}
pub trait Deserialize<'de>: Sized {
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where
D: Deserializer<'de>;
}
These methods are generic over the serialization format, represented by the
Serializer
and Deserializer
traits. For example there is one Serializer
type for JSON and a different one for Postcard.