pub struct WriteRequest<R: Send + 'static> { /* private fields */ }Expand description
One write request awaiting execution by the writer task.
Carries a typed closure and a typed oneshot reply so that the concrete
return type R (e.g. BatchWriteSummary) is preserved end to end,
while AnyWriteRequest lets the drain loop hold heterogeneous
requests in one homogeneous channel.
top_level (ADR-067 Component A): when true,
the drain loop runs this request’s operation WITHOUT wrapping it in a
BEGIN IMMEDIATE/COMMIT/ROLLBACK — still serialized through the
single writer owner (only one request drains at a time regardless of
this flag), but with the transaction wrap skipped entirely. Exists for
statements SQLite forbids inside any open transaction (e.g. VACUUM);
see WriterTaskHandle::send_top_level.
Trait Implementations§
Source§impl<R: Send + 'static> AnyWriteRequest for WriteRequest<R>
impl<R: Send + 'static> AnyWriteRequest for WriteRequest<R>
Source§fn execute_and_reply(self: Box<Self>, conn: &Connection)
fn execute_and_reply(self: Box<Self>, conn: &Connection)
Runs this request’s operation against
conn, commits or rolls back
the enclosing transaction based on the outcome, and sends the
(possibly commit-failure-adjusted) result to the request’s oneshot
reply channel. Read moreSource§fn execute_and_reply_top_level(self: Box<Self>, conn: &Connection)
fn execute_and_reply_top_level(self: Box<Self>, conn: &Connection)
Runs this request’s operation directly against
conn — no
transaction wrap, no COMMIT/ROLLBACK — and sends the result to
the request’s oneshot reply channel. Read moreSource§fn reply_error(self: Box<Self>, err: StorageError)
fn reply_error(self: Box<Self>, err: StorageError)
Source§fn is_top_level(&self) -> bool
fn is_top_level(&self) -> bool
true if the drain loop must run this request via
Self::execute_and_reply_top_level (no transaction wrap) instead
of Self::execute_and_reply (wrapped in BEGIN IMMEDIATE).Auto Trait Implementations§
impl<R> !RefUnwindSafe for WriteRequest<R>
impl<R> !Sync for WriteRequest<R>
impl<R> !UnwindSafe for WriteRequest<R>
impl<R> Freeze for WriteRequest<R>
impl<R> Send for WriteRequest<R>
impl<R> Unpin for WriteRequest<R>
impl<R> UnsafeUnpin for WriteRequest<R>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more