Struct Wrapper 

pub struct Wrapper { /* private fields */ }

A stored entry containing the serialized representation and an optional cached runtime value.

• serialized: the serde_value::Value used for Serialize/Deserialize of the map.
• value: an optional Box<dyn Any> holding the deserialized value. This field is not serialized and is cleared on Clone and Deserialize.

Semantics:

• On insert, both serialized and value are populated.
• On access (get/get_mut), the entry will lazily deserialize serialized into value if the cache is empty.
• into_inner attempts to extract the concrete type from the cache or by deserializing.

Notes:

• The cloning, serialization and deserialization happens based on the serialized serde_value::Value, so any modifications to fields that are marked #[serde(skip)] will not be lost after a serialization round-trip, or after cloning the map.
• Currently any modifications to the cached value are not reflected back into the serialized form, so serialization WILL reflect the original value only. This is a known limitation and is planned to be addressed in a future version by returning a Guard object that will update the serialized value on Drop.

Implementations

impl Wrapper

pub fn try_get<T>(&self) -> Option<&T>

where T: for<'de> Deserialize<'de> + 'static,

Attempt to get an immutable reference to the deserialized value of type T. Will return None if the value has not yet been deserialized, as we need a mutable reference to mutate the entry to save the deserialized value.

pub fn get<T>(&mut self) -> Result<&T, DeserializerError>

where T: Serialize + for<'de> Deserialize<'de> + 'static,

Attempt to get an immutable reference to the deserialized value of type T, lazily deserializing if necessary. We need a mutable reference in order to save the deserialized value to the entry

pub fn get_mut<'a, T>( &'a mut self, ) -> Result<WriteGuard<'a, T>, DeserializerError>

where T: for<'de> Deserialize<'de> + Serialize + 'static,

Attempt to an mutable reference to the deserialized value of type T, lazily deserializing if necessary.

pub fn into_inner<T>(self) -> Result<T, DeserializerError>

where T: for<'de> Deserialize<'de> + 'static,

Attempt to extract the inner value by deserializing if necessary.

Trait Implementations

impl Clone for Wrapper

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Wrapper

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Wrapper

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Wrapper

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.