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§
Sourcefn commit(&mut self, writes: Vec<StorageWrite>) -> Result<Seq>
fn commit(&mut self, writes: Vec<StorageWrite>) -> Result<Seq>
Atomically persist one batch and return its sequence; later reads observe it.
Sourcefn mint_id(&mut self) -> Result<u64>
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.
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>>
Sourcefn visible_entry(
&self,
conversation_id: ConversationId,
id: EntryId,
) -> Result<Option<StoredEntry>>
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.
Sourcefn find_latest_head_marker(
&self,
conversation_id: ConversationId,
at_or_before: Option<EntryId>,
) -> Result<Option<EntryRecord>>
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.
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>>
Sourcefn find_document(
&self,
address: &DocumentAddress,
at: DocumentPoint,
) -> Result<Option<DocumentRecord>>
fn find_document( &self, address: &DocumentAddress, at: DocumentPoint, ) -> Result<Option<DocumentRecord>>
The incarnation occupying one exact logical address at the point.
Sourcefn document(
&self,
id: DocumentId,
at: DocumentPoint,
) -> Result<Option<StoredDocument>>
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.
fn scan_documents( &self, query: &DocumentQuery, limit: usize, cursor: Option<&Cursor>, ) -> Result<Page<DocumentRecord>>
Dyn Compatibility§
This trait is dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety".