Struct CacheLock

pub struct CacheLock { /* private fields */ }

The global cache locking manager

Implementations

impl CacheLock

pub fn new(timeout: Duration) -> Self

Create a new CacheLock with the given lock timeout

When the timeout is reached, the read locks are automatically unlocked

pub fn lock<K: CacheHashKey>(&self, key: &K) -> Locked

Try to lock a cache fetch

Users should call after a cache miss before fetching the asset. The returned Locked will tell the caller either to fetch or wait.

pub fn release<K: CacheHashKey>(&self, key: &K, reason: LockStatus)

Release a lock for the given key

When the write lock is dropped without being released, the read lock holders will consider it to be failed so that they will compete for the write lock again.