Struct ThreadToken

pub struct ThreadToken { /* private fields */ }

ThreadToken is used to separate transactions in time for each thread.

Only one ThreadToken can exist in each thread and transactions need to mutably borrow a thread token. Furthermore, neither ThreadToken nor any of the transaction types can be moved between threads. This makes it impossible to have access to two transactions from one thread.

Implementations

impl ThreadToken

pub fn try_new() -> Option<Self>

Create a ThreadToken if it was not created yet on this thread.

Async tasks often share their thread and can thus not use this method. Instead you should use your equivalent of spawn_blocking or block_in_place. These functions guarantee that you have a unique thread and thus allow ThreadToken::try_new.

Note that using spawn_blocking for sqlite is actually a good practice. Sqlite queries can be expensive, it might need to read from disk which is slow. Doing so on all async runtime threads would prevent other tasks from executing.

Trait Implementations

impl Drop for ThreadToken

fn drop(&mut self)

Dropping a ThreadToken allows retrieving it with ThreadToken::try_new again.