Struct sync15::bso_record::Payload

pub struct Payload {
    pub id: Guid,
    pub deleted: bool,
    pub data: Map<String, Value>,
}

Represents the decrypted payload in a Bso. Provides a minimal layer of type safety to avoid double-encrypting.

Fields

id: Guid

deleted: bool

data: Map<String, Value>

Implementations

impl Payload

pub fn new_tombstone(id: impl Into<Guid>) -> Payload

pub fn new_tombstone_with_ttl(id: impl Into<Guid>, ttl: u32) -> Payload

pub fn with_sortindex(self, index: i32) -> Payload

pub fn with_auto_field<T>(self, name: &str, v: Option<T>) -> Payload where
    T: Into<Value>, 

"Auto" fields are fields like 'sortindex' and 'ttl', which are:

• Added to the payload automatically when deserializing if present on the incoming BSO or envelope.
• Removed from the payload automatically and attached to the BSO or envelope if present on the outgoing payload.

pub fn take_auto_field<V>(&mut self, name: &str) -> Option<V> where
    V: for<'a> Deserialize<'a>, 

pub fn id(&self) -> &str

pub fn is_tombstone(&self) -> bool

pub fn from_json(value: Value) -> Result<Payload, Error>

pub fn into_record<T>(self) -> Result<T, Error> where
    T: for<'a> Deserialize<'a>, 

Deserializes the BSO payload into a specific record type T.

BSO payloads are unstructured JSON objects, with string keys and dynamically-typed values. into_record makes it more convenient to work with payloads by converting them into data type-specific structs. Your record type only needs to derive or implement serde::Deserialize; Serde will take care of the rest.

Errors

into_record returns errors for type mismatches. As an example, trying to deserialize a string value from the payload into an integer field in T will fail.

If there's a chance that a field contains invalid or mistyped data, you'll want to extract it from payload.data manually, instead of using into_record. This has been seen in the wild: for example, dateAdded for bookmarks can be either an integer or a string.

pub fn from_record<T>(v: T) -> Result<Payload, Error> where
    T: Serialize, 

pub fn into_json_string(self) -> String

Trait Implementations

impl Clone for Payload

fn clone(&self) -> Payload

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Payload

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Payload

fn deserialize<__D>(
    __deserializer: __D
) -> Result<Payload, <__D as Deserializer<'de>>::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl PartialEq<Payload> for Payload

fn eq(&self, other: &Payload) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Payload) -> bool

This method tests for !=.

impl Serialize for Payload

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Payload