Struct ArcLocalResource 

pub struct ArcLocalResource<T> { /* private fields */ }

A reference-counted resource that only loads its data locally on the client.

Implementations

impl<T> ArcLocalResource<T>

pub fn new<Fut>(fetcher: impl Fn() -> Fut + 'static) -> ArcLocalResource<T>

where T: 'static, Fut: Future<Output = T> + 'static,

Creates the resource.

This will only begin loading data if you are on the client (i.e., if you do not have the ssr feature activated).

pub fn refetch(&self)

Re-runs the async function.

pub fn map<U>(&self, f: impl FnOnce(&SendWrapper<T>) -> U) -> Option<U>

where T: 'static,

Synchronously, reactively reads the current value of the resource and applies the function f to its value if it is Some(_).

impl<T, E> ArcLocalResource<Result<T, E>>

where T: 'static, E: Clone + 'static,

pub fn and_then<U>(&self, f: impl FnOnce(&T) -> U) -> Option<Result<U, E>>

Applies the given function when a resource that returns Result<T, E> has resolved and loaded an Ok(_), rather than requiring nested .map() calls over the Option<Result<_, _>> returned by the resource.

This is useful when used with features like server functions, in conjunction with <ErrorBoundary/> and <Suspense/>, when these other components are left to handle the None and Err(_) states.

Trait Implementations

impl<T> Clone for ArcLocalResource<T>

fn clone(&self) -> ArcLocalResource<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> DefinedAt for ArcLocalResource<T>

fn defined_at(&self) -> Option<&'static Location<'static>>

Returns the location at which the signal was defined. This is usually simply None in release mode.

impl<T> From<ArcLocalResource<T>> for LocalResource<T>

where T: 'static,

fn from(arc: ArcLocalResource<T>) -> LocalResource<T>

Converts to this type from the input type.

impl<T> From<LocalResource<T>> for ArcLocalResource<T>

where T: 'static,

fn from(local: LocalResource<T>) -> ArcLocalResource<T>

Converts to this type from the input type.

impl<T> IntoFuture for ArcLocalResource<T>

where T: Clone + 'static,

type Output = T

The output that the future will produce on completion.

type IntoFuture = Map<AsyncDerivedFuture<SendWrapper<T>>, fn(SendWrapper<T>) -> T>

Which kind of future are we turning this into?

fn into_future(self) -> <ArcLocalResource<T> as IntoFuture>::IntoFuture

Creates a future from a value.

impl<T> IsDisposed for ArcLocalResource<T>

where T: 'static,

fn is_disposed(&self) -> bool

If true, the signal cannot be accessed without a panic.

impl<T> ReactiveNode for ArcLocalResource<T>

fn mark_dirty(&self)

Notifies the source’s dependencies that it has changed.

fn mark_check(&self)

Notifies the source’s dependencies that it may have changed.

fn mark_subscribers_check(&self)

Marks that all subscribers need to be checked.

fn update_if_necessary(&self) -> bool

Regenerates the value for this node, if needed, and returns whether it has actually changed or not.

impl<T> ReadUntracked for ArcLocalResource<T>

where T: 'static,

type Value = ReadGuard<Option<SendWrapper<T>>, AsyncPlain<Option<SendWrapper<T>>>>

The guard type that will be returned, which can be dereferenced to the value.

fn try_read_untracked( &self, ) -> Option<<ArcLocalResource<T> as ReadUntracked>::Value>

Returns the guard, or None if the signal has already been disposed.

fn read_untracked(&self) -> Self::Value

Returns the guard.

fn custom_try_read(&self) -> Option<Option<Self::Value>>

This is a backdoor to allow overriding the Read::try_read implementation despite it being auto implemented.

impl<T> Source for ArcLocalResource<T>

fn add_subscriber(&self, subscriber: AnySubscriber)

Adds a subscriber to this source’s list of dependencies.

fn remove_subscriber(&self, subscriber: &AnySubscriber)

Removes a subscriber from this source’s list of dependencies.

fn clear_subscribers(&self)

Remove all subscribers from this source’s list of dependencies.

impl<T> Subscriber for ArcLocalResource<T>

fn add_source(&self, source: AnySource)

Adds a subscriber to this subscriber’s list of dependencies.

fn clear_sources(&self, subscriber: &AnySubscriber)

Clears the set of sources for this subscriber.

impl<T> ToAnySource for ArcLocalResource<T>

where T: 'static,

fn to_any_source(&self) -> AnySource

Converts this type to its type-erased equivalent.

impl<T> ToAnySubscriber for ArcLocalResource<T>

where T: 'static,

fn to_any_subscriber(&self) -> AnySubscriber

Converts this type to its type-erased equivalent.