Struct ManyAttachments 

pub struct ManyAttachments { /* private fields */ }

Represents a has_many_attached relation.

Implementations

impl ManyAttachments

pub fn new( record_type: impl Into<String>, record_id: impl Into<String>, name: impl Into<String>, ) -> Self

Creates an empty collection attachment relation.

pub fn attach(&mut self, blob: Blob) -> Result<&Attachment, AttachmentError>

Appends a blob to the collection.

Errors

Returns an error when the attachment cannot be built.

pub fn attach_many<I>(&mut self, blobs: I) -> Result<(), AttachmentError>

where I: IntoIterator<Item = Blob>,

Appends several blobs to the collection.

Errors

Returns an error when any attachment cannot be built.

pub fn is_attached(&self) -> bool

Returns whether at least one blob is attached.

pub fn len(&self) -> usize

Returns the attachment count.

pub fn is_empty(&self) -> bool

Returns whether the collection is empty.

pub fn attachments(&self) -> &[Attachment]

Returns all attachments in insertion order.

pub fn blobs(&self) -> impl Iterator<Item = &Blob>

Returns an iterator over the attached blobs.

pub fn detach_blob(&mut self, blob_id: Uuid) -> Option<Attachment>

Removes an attachment by blob id.

pub async fn purge_all<S: StorageService + ?Sized>( &mut self, service: &S, ) -> Result<Vec<Attachment>, AttachmentError>

Purges all attached blobs from storage and clears the collection.

Errors

Returns an error when any storage delete fails.

pub fn purge_all_sync<S: StorageService + ?Sized>( &mut self, service: &S, ) -> Result<Vec<Attachment>, AttachmentError>

Purges all attached blobs from storage and clears the collection using the thread-local runtime.

Errors

Returns an error when any storage delete fails.

Trait Implementations

impl Clone for ManyAttachments

fn clone(&self) -> ManyAttachments

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ManyAttachments

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

Formats the value using the given formatter.