Skip to main content

PluginContext

Struct PluginContext 

Source
pub struct PluginContext { /* private fields */ }
Expand description

Context passed to a plugin. Registrations are automatically owned by its scope and survive when their returned handles are ignored.

Implementations§

Source§

impl PluginContext

Source

pub fn isolate<K: ServiceKey>(&self) -> Self

Source

pub fn provide<K: ServiceKey>( &self, value: Arc<K::Value>, ) -> Result<ServiceHandle<K>>

Source

pub fn on<E, H, Fut>(&self, handler: H) -> Result<ListenerHandle>
where E: Event, H: Fn(Context, Arc<E>) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<()>> + Send + 'static,

Source

pub fn on_query<Q, H, Fut>(&self, handler: H) -> Result<ListenerHandle>
where Q: Query, H: Fn(Context, Arc<Q>) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Option<Q::Response>>> + Send + 'static,

Source

pub fn defer<F, Fut>(&self, cleanup: F) -> Result<()>
where F: FnOnce() -> Fut + Send + 'static, Fut: Future<Output = Result<()>> + Send + 'static,

Source

pub fn manage<R: Resource>(&self, resource: R) -> Result<()>

Source

pub fn spawn<F, Fut>(&self, task: F) -> Result<TaskHandle>
where F: FnOnce(CancellationToken) -> Fut + Send + 'static, Fut: Future<Output = Result<()>> + Send + 'static,

Registers a cooperative task. It is spawned only when the activation commits. Disposal waits five seconds, then aborts an unresponsive task.

Methods from Deref<Target = Context>§

Source

pub fn scope_id(&self) -> u64

Source

pub fn child(&self) -> Self

Creates a lightweight child context sharing the same runtime.

Source

pub fn isolate<K: ServiceKey>(&self) -> Self

Creates a child where service K resolves in a fresh isolated slot; all other service types continue to inherit their current slots.

Source

pub fn get<K: ServiceKey>(&self) -> Result<Arc<K::Value>>

Source

pub fn try_get<K: ServiceKey>(&self) -> Option<Arc<K::Value>>

Source

pub async fn emit<E: Event>(&self, event: E) -> Result<()>

Invokes listeners serially in registration order.

Source

pub async fn parallel<E: Event>(&self, event: E) -> Result<()>

Invokes all listeners concurrently.

Source

pub async fn query<Q: Query>(&self, query: Q) -> Result<Option<Q::Response>>

Runs query handlers in registration order and returns the first answer.

Trait Implementations§

Source§

impl Clone for PluginContext

Source§

fn clone(&self) -> PluginContext

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Deref for PluginContext

Source§

type Target = Context

The resulting type after dereferencing.
Source§

fn deref(&self) -> &Self::Target

Dereferences the value.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Event for T
where T: Send + Sync + 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.