Struct SqlitePool 

pub struct SqlitePool(/* private fields */);

Implementations

impl SqlitePool

pub async fn new<P: AsRef<Path>>( path: P, config: SqliteConfig, ) -> Result<Self, InitializationError>

pub async fn transaction_write<F, T, E>( &self, func: F, name: &'static str, ) -> Result<Result<T, E>, DbErrorGeneric>

where F: FnOnce(&mut Transaction<'_>) -> Result<T, E> + Send + 'static, T: Send + 'static, E: From<DbErrorGeneric> + Send + 'static,

pub async fn transaction_read<F, T, E>( &self, func: F, name: &'static str, ) -> Result<Result<T, E>, DbErrorGeneric>

where F: FnOnce(&mut Transaction<'_>) -> Result<T, E> + Send + 'static, T: Send + 'static, E: From<DbErrorGeneric> + Send + 'static,

pub async fn conn_low_prio<F, T>( &self, func: F, name: &'static str, ) -> Result<T, DbErrorGeneric>

where F: FnOnce(&Connection) -> Result<T, DbErrorGeneric> + Send + 'static, T: Send + 'static + Default,

Trait Implementations

impl Clone for SqlitePool

fn clone(&self) -> SqlitePool

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DbConnection for SqlitePool

fn get_expired_timers<'life0, 'async_trait>( &'life0 self, at: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = Result<Vec<ExpiredTimer>, DbErrorGeneric>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Get currently expired delays and locks.

fn create<'life0, 'async_trait>( &'life0 self, req: CreateRequest, ) -> Pin<Box<dyn Future<Output = Result<AppendResponse, DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create a new execution log

fn append_batch<'life0, 'async_trait>( &'life0 self, current_time: DateTime<Utc>, batch: Vec<AppendRequest>, execution_id: ExecutionId, version: Version, ) -> Pin<Box<dyn Future<Output = Result<AppendBatchResponse, DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Append a batch of events to an existing execution log, and append a response to a parent execution. The batch cannot contain ExecutionEventInner::Created.

fn append_batch_create_new_execution<'life0, 'async_trait>( &'life0 self, current_time: DateTime<Utc>, batch: Vec<AppendRequest>, execution_id: ExecutionId, version: Version, child_req: Vec<CreateRequest>, ) -> Pin<Box<dyn Future<Output = Result<AppendBatchResponse, DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Append one or more events to the parent execution log, and create zero or more child execution logs. The batch cannot contain ExecutionEventInner::Created.

fn list_execution_events<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, since: &'life2 Version, max_length: VersionType, include_backtrace_id: bool, ) -> Pin<Box<dyn Future<Output = Result<Vec<ExecutionEvent>, DbErrorRead>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

fn subscribe_to_next_responses<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, start_idx: usize, timeout_fut: Pin<Box<dyn Future<Output = ()> + Send>>, ) -> Pin<Box<dyn Future<Output = Result<Vec<JoinSetResponseEventOuter>, DbErrorReadWithTimeout>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Notification mechainism with no strict guarantees for getting notified when a new response arrives. Parameter start_idx must be at most be equal to current size of responses in the execution log. If no response arrives immediately and interrupt_after resolves, DbErrorReadWithTimeout::Timeout is returned. Implementations with no pubsub support should use polling.

fn wait_for_finished_result<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, timeout_fut: Option<Pin<Box<dyn Future<Output = ()> + Send>>>, ) -> Pin<Box<dyn Future<Output = Result<SupportedFunctionReturnValue, DbErrorReadWithTimeout>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Notification mechainism with no strict guarantees for getting the finished result. Implementations with no pubsub support should use polling.

fn append_response<'life0, 'async_trait>( &'life0 self, created_at: DateTime<Utc>, execution_id: ExecutionId, response_event: JoinSetResponseEvent, ) -> Pin<Box<dyn Future<Output = Result<(), DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn append_backtrace<'life0, 'async_trait>( &'life0 self, append: BacktraceInfo, ) -> Pin<Box<dyn Future<Output = Result<(), DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn append_backtrace_batch<'life0, 'async_trait>( &'life0 self, batch: Vec<BacktraceInfo>, ) -> Pin<Box<dyn Future<Output = Result<(), DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn get_backtrace<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, filter: BacktraceFilter, ) -> Pin<Box<dyn Future<Output = Result<BacktraceInfo, DbErrorRead>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Used by gRPC only. Get the latest backtrace if version is not set.

fn get_execution_event<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, version: &'life2 Version, ) -> Pin<Box<dyn Future<Output = Result<ExecutionEvent, DbErrorRead>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Get a single event without backtrace_id

fn get_pending_state<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, ) -> Pin<Box<dyn Future<Output = Result<PendingState, DbErrorRead>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

fn list_executions<'life0, 'async_trait>( &'life0 self, ffqn: Option<FunctionFqn>, top_level_only: bool, pagination: ExecutionListPagination, ) -> Pin<Box<dyn Future<Output = Result<Vec<ExecutionWithState>, DbErrorGeneric>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Returns executions sorted in descending order. Used by gRPC only.

fn list_responses<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, pagination: Pagination<u32>, ) -> Pin<Box<dyn Future<Output = Result<Vec<ResponseWithCursor>, DbErrorRead>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Returns responses of an execution ordered as they arrived, enabling matching each JoinNext to its corresponding response. Used by gRPC only.

fn get_create_request<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, ) -> Pin<Box<dyn Future<Output = Result<CreateRequest, DbErrorRead>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

fn get_finished_result<'life0, 'life1, 'async_trait>( &'life0 self, execution_id: &'life1 ExecutionId, finished: PendingStateFinished, ) -> Pin<Box<dyn Future<Output = Result<Option<SupportedFunctionReturnValue>, DbErrorRead>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Self: Sync + 'async_trait,

impl DbExecutor for SqlitePool

fn lock_pending<'life0, 'async_trait>( &'life0 self, batch_size: usize, pending_at_or_sooner: DateTime<Utc>, ffqns: Arc<[FunctionFqn]>, created_at: DateTime<Utc>, component_id: ComponentId, executor_id: ExecutorId, lock_expires_at: DateTime<Utc>, run_id: RunId, ) -> Pin<Box<dyn Future<Output = Result<LockPendingResponse, DbErrorGeneric>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

fn lock_one<'life0, 'life1, 'async_trait>( &'life0 self, created_at: DateTime<Utc>, component_id: ComponentId, execution_id: &'life1 ExecutionId, run_id: RunId, version: Version, executor_id: ExecutorId, lock_expires_at: DateTime<Utc>, ) -> Pin<Box<dyn Future<Output = Result<LockedExecution, DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Specialized locking for e.g. extending the lock by the original executor and run.

fn append<'life0, 'async_trait>( &'life0 self, execution_id: ExecutionId, version: Version, req: AppendRequest, ) -> Pin<Box<dyn Future<Output = Result<AppendResponse, DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Append a single event to an existing execution log. The request cannot contain ExecutionEventInner::Created.

fn append_batch_respond_to_parent<'life0, 'async_trait>( &'life0 self, execution_id: ExecutionIdDerived, current_time: DateTime<Utc>, batch: Vec<AppendRequest>, version: Version, parent_execution_id: ExecutionId, parent_response_event: JoinSetResponseEventOuter, ) -> Pin<Box<dyn Future<Output = Result<AppendBatchResponse, DbErrorWrite>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Append a batch of events to an existing execution log, and append a response to a parent execution. The batch cannot contain ExecutionEventInner::Created.

fn wait_for_pending<'life0, 'async_trait>( &'life0 self, pending_at_or_sooner: DateTime<Utc>, ffqns: Arc<[FunctionFqn]>, timeout_fut: Pin<Box<dyn Future<Output = ()> + Send>>, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Notification mechainism with no strict guarantees for waiting while there are no pending executions. Return immediately if there are pending notifications at pending_at_or_sooner. Otherwise wait until timeout_fut resolves. Timers that expire between pending_at_or_sooner and timeout can be disregarded.

impl DbPool for SqlitePool

fn connection(&self) -> Box<dyn DbConnection>

impl DbPoolCloseable for SqlitePool

fn close<'async_trait>( self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait,

impl Drop for SqlitePool

fn drop(&mut self)

Executes the destructor for this type.