Struct Jobs 

pub struct Jobs<R: Resource> { /* private fields */ }

Work a view or surface starts on its own, with nobody invoking an effect: a route fetched when the destination changes, a feed refreshed when it opens. Each job runs under a key; starting another under a key still running stops the earlier one, so the latest request wins. A job is started like an effect’s (EffectCx::thread, EffectCx::spawn) and finishes the same way, on the UI thread, with ordinary actions; a surface’s completion gets &mut the surface. Jobs run only in a window someone uses: a past version and a capture start none.

Get one from SurfaceCx::jobs or ViewCx::jobs. Clones share the jobs.

Implementations

impl<R: Resource> Jobs<R>

pub fn start<H: 'static>( &self, key: impl Into<String>, start: impl FnOnce(&mut EffectCx<R, H>) -> EffectAnswer, )

Start the job key as start does it, through an EffectCx whose completions get &mut H: the surface itself for a surface’s jobs (jobs.start::<Self>(…)), () for a view’s. Work it finishes at once needs no job; a failure is logged, as nobody waits for it.

pub fn cancel(&self, key: &str)

Stop the job key; its result, if it comes, is dropped.

pub fn is_running(&self, key: &str) -> bool

Whether the job key is still running.

pub fn progress(&self, key: &str) -> Option<JobProgress>

Where the running job key last said it is, for the view to show and publish; None before its first report and once it ended.

Trait Implementations

impl<R: Resource> Clone for Jobs<R>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.