Struct bonsaidb::core::document::CollectionDocument

pub struct CollectionDocument<C> where
    C: SerializedCollection,  {
    pub header: Header,
    pub contents: <C as SerializedCollection>::Contents,
}

A document with serializable contents.

Fields

header: Header

The header of the document, which contains the id and Revision.

contents: <C as SerializedCollection>::Contents

The document’s contents.

Implementations

impl<C> CollectionDocument<C> where
    C: SerializedCollection, 

pub async fn update<Cn>(&'_ mut self, connection: &'_ Cn) -> Result<(), Error> where
    Cn: Connection, 

Stores the new value of contents in the document.

pub async fn modify<Cn, Modifier>(
    &'_ mut self,
    connection: &'_ Cn,
    modifier: Modifier
) -> Result<(), Error> where
    Cn: Connection,
    Modifier: FnMut(&mut CollectionDocument<C>) + Send + Sync, 

Modifies self, automatically retrying the modification if the document has been updated on the server.

Data loss warning

If you’ve modified self before calling this function and a conflict occurs, all changes to self will be lost when the current document is fetched before retrying the process again. When you use this function, you should limit the edits to the value to within the modifier callback.

pub async fn delete<Cn>(&'_ self, connection: &'_ Cn) -> Result<(), Error> where
    Cn: Connection, 

Removes the document from the collection.

pub fn to_document(&self) -> Result<OwnedDocument, Error>

Converts this value to a serialized Document.

Methods from Deref<Target = Header>

pub fn emit(&self) -> Mappings<(), ()>

Creates a Map result with an empty key and value.

pub fn emit_key<K>(&self, key: K) -> Mappings<K, ()> where
    K: for<'a> Key<'a>, 

Creates a Map result with a key and an empty value.

pub fn emit_value<Value>(&self, value: Value) -> Mappings<(), Value>

Creates a Map result with value and an empty key.

pub fn emit_key_and_value<K, Value>(
    &self,
    key: K,
    value: Value
) -> Mappings<K, Value> where
    K: for<'a> Key<'a>, 

Creates a Map result with a key and value.

Trait Implementations

impl<C> AsRef<Header> for CollectionDocument<C> where
    C: SerializedCollection, 

pub fn as_ref(&self) -> &Header

Performs the conversion.

impl<C> Clone for CollectionDocument<C> where
    C: Clone + SerializedCollection,
    <C as SerializedCollection>::Contents: Clone, 

pub fn clone(&self) -> CollectionDocument<C>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C> Debug for CollectionDocument<C> where
    C: Debug + SerializedCollection,
    <C as SerializedCollection>::Contents: Debug, 

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

Formats the value using the given formatter.

impl<C> Deref for CollectionDocument<C> where
    C: SerializedCollection, 

type Target = Header

The resulting type after dereferencing.

pub fn deref(&self) -> &<CollectionDocument<C> as Deref>::Target

Dereferences the value.

impl<'a, 'c, C> From<&'c CollectionDocument<C>> for NamedReference<'a> where
    C: SerializedCollection, 

pub fn from(doc: &'c CollectionDocument<C>) -> NamedReference<'a>

Performs the conversion.

impl<C> PartialEq<CollectionDocument<C>> for CollectionDocument<C> where
    C: PartialEq<C> + SerializedCollection,
    <C as SerializedCollection>::Contents: PartialEq<<C as SerializedCollection>::Contents>, 

pub fn eq(&self, other: &CollectionDocument<C>) -> bool

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

pub fn ne(&self, other: &CollectionDocument<C>) -> bool

This method tests for !=.

impl<'a, C> TryFrom<&'a BorrowedDocument<'a>> for CollectionDocument<C> where
    C: SerializedCollection, 

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(
    value: &'a BorrowedDocument<'a>
) -> Result<CollectionDocument<C>, <CollectionDocument<C> as TryFrom<&'a BorrowedDocument<'a>>>::Error>

Performs the conversion.

impl<'a, C> TryFrom<&'a OwnedDocument> for CollectionDocument<C> where
    C: SerializedCollection, 

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(
    value: &'a OwnedDocument
) -> Result<CollectionDocument<C>, <CollectionDocument<C> as TryFrom<&'a OwnedDocument>>::Error>

Performs the conversion.

impl<'a, 'b, C> TryFrom<&'b CollectionDocument<C>> for BorrowedDocument<'a> where
    C: SerializedCollection, 

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(
    value: &'b CollectionDocument<C>
) -> Result<BorrowedDocument<'a>, <BorrowedDocument<'a> as TryFrom<&'b CollectionDocument<C>>>::Error>

Performs the conversion.

impl<C> Eq for CollectionDocument<C> where
    C: Eq + SerializedCollection,
    <C as SerializedCollection>::Contents: Eq, 

impl<C> StructuralEq for CollectionDocument<C> where
    C: SerializedCollection, 

impl<C> StructuralPartialEq for CollectionDocument<C> where
    C: SerializedCollection,