Struct Resource 

pub struct Resource<K, T, E>(/* private fields */);

A shared handle to one owned read, with no Clone bound on data or errors. Dropping its last handle cancels the read and detaches its key subscription. Cloned handles cannot extend the owner’s lifetime.

Implementations

impl<K: Clone + PartialEq + 'static, T: 'static, E: 'static> Resource<K, T, E>

pub fn new<F: Future<Output = Result<T, E>> + 'static>( owner: &OwnerHandle, key: impl Fn() -> Option<K> + 'static, load: impl Fn(K, CancellationToken) -> F + 'static, spawn: impl Fn(LocalBoxFuture<'static, ()>) + 'static, ) -> Self

spawn must schedule the future on a local executor. The loader is first called when the scheduled future is polled after owner activation. Return None from key to disable loading and clear previous data.

pub fn shared( owner: &OwnerHandle, key: impl Fn() -> Option<K> + 'static, load: Rc<Loader<K, Result<T, E>>>, spawn: Rc<Spawner>, ) -> Self

Like Self::new, with a loader and spawner shared by other reads, such as the entries of one query cache.

pub fn get(&self) -> ResourceState<K, T, E>

pub fn with<R>(&self, read: impl FnOnce(&ResourceState<K, T, E>) -> R) -> R

pub fn refresh(&self)

Reload the current key. No-op for a disabled or disposed resource.

pub fn dispose(&self)

Permanently stop this resource, even while its owner remains alive.

Trait Implementations

impl<K, T, E> Clone for Resource<K, T, E>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.