Skip to main content

Storage

Trait Storage 

Source
pub trait Storage {
Show 17 methods // Required methods fn commit(&mut self, writes: Vec<StorageWrite>) -> Result<Seq>; fn mint_id(&mut self) -> Result<u64>; fn conversation( &self, id: ConversationId, ) -> Result<Option<ConversationRecord>>; fn scan_conversations( &self, query: &ConversationQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<ConversationRecord>>; fn entry(&self, id: EntryId) -> Result<Option<StoredEntry>>; fn visible_entry( &self, conversation_id: ConversationId, id: EntryId, ) -> Result<Option<StoredEntry>>; fn find_latest_head_marker( &self, conversation_id: ConversationId, at_or_before: Option<EntryId>, ) -> Result<Option<EntryRecord>>; fn scan_entries( &self, query: &EntryQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<EntryRecord>>; fn task(&self, id: TaskId) -> Result<Option<TaskRecord>>; fn scan_tasks( &self, query: &TaskQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<TaskRecord>>; fn submission(&self, id: SubmissionId) -> Result<Option<SubmissionRecord>>; fn scan_submissions( &self, query: &SubmissionQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<SubmissionRecord>>; fn submission_by_request( &self, conversation_id: ConversationId, request_id: &str, ) -> Result<Option<SubmissionRecord>>; fn find_document( &self, address: &DocumentAddress, at: DocumentPoint, ) -> Result<Option<DocumentRecord>>; fn document( &self, id: DocumentId, at: DocumentPoint, ) -> Result<Option<StoredDocument>>; fn scan_documents( &self, query: &DocumentQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<DocumentRecord>>; fn close(&mut self) -> Result<()>;
}
Expand description

Atomic persistence boundary for Session records.

Storage trusts the owning Session for semantically valid records, references, ancestry, and transitions. It enforces atomicity, the global ID namespace, immutable conversation/entry creation, and document record consistency; the Session serializes commits. A scan returns at most limit items and a cursor when more remain.

Required Methods§

Source

fn commit(&mut self, writes: Vec<StorageWrite>) -> Result<Seq>

Atomically persist one batch and return its sequence; later reads observe it.

Source

fn mint_id(&mut self) -> Result<u64>

A fresh ID from the Session-global namespace, greater than every ID minted or stored before, across reopen.

Source

fn conversation(&self, id: ConversationId) -> Result<Option<ConversationRecord>>

Source

fn scan_conversations( &self, query: &ConversationQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<ConversationRecord>>

Source

fn entry(&self, id: EntryId) -> Result<Option<StoredEntry>>

Source

fn visible_entry( &self, conversation_id: ConversationId, id: EntryId, ) -> Result<Option<StoredEntry>>

One entry only when it is visible through the conversation’s fork ancestry.

Source

fn find_latest_head_marker( &self, conversation_id: ConversationId, at_or_before: Option<EntryId>, ) -> Result<Option<EntryRecord>>

The newest visible entry with a head at or below the optional inclusive cutoff.

Source

fn scan_entries( &self, query: &EntryQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<EntryRecord>>

Source

fn task(&self, id: TaskId) -> Result<Option<TaskRecord>>

Source

fn scan_tasks( &self, query: &TaskQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<TaskRecord>>

Source

fn submission(&self, id: SubmissionId) -> Result<Option<SubmissionRecord>>

Source

fn scan_submissions( &self, query: &SubmissionQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<SubmissionRecord>>

Source

fn submission_by_request( &self, conversation_id: ConversationId, request_id: &str, ) -> Result<Option<SubmissionRecord>>

Source

fn find_document( &self, address: &DocumentAddress, at: DocumentPoint, ) -> Result<Option<DocumentRecord>>

The incarnation occupying one exact logical address at the point.

Source

fn document( &self, id: DocumentId, at: DocumentPoint, ) -> Result<Option<StoredDocument>>

Materialize one incarnation by ID at the point, without following a replacement at its address.

Source

fn scan_documents( &self, query: &DocumentQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<DocumentRecord>>

Source

fn close(&mut self) -> Result<()>

Release resources; every later operation fails.

Dyn Compatibility§

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors§