Struct ProxyHandler 

pub struct ProxyHandler<S: HandlerState>(/* private fields */);

Available on crate feature component-model-async only.

Represents the state of a web server.

Note that this supports optional instance reuse, enabled when S::max_instance_reuse_count() returns a number greater than one. See [Self::push] for details.

Implementations

impl<S> ProxyHandler<S>

where S: HandlerState,

pub fn new(state: S, instance_pre: ProxyPre<S::StoreData>) -> Self

Create a new ProxyHandler with the specified application state and pre-instance.

pub fn spawn(&self, req_id: Option<u64>, task: TaskFn<S::StoreData>)

Push a task to the task queue for this handler.

This will either spawn a new background worker to run the task or deliver it to an already-running worker.

The req_id will be passed to <S as HandlerState>::new_store if a new worker is started for this task. It is intended to be used as a “request identifier” corresponding to that task and can be used e.g. to prefix all logging from the Store with that identifier. Note that a non-None value only makes sense when <S as HandlerState>::max_instance_reuse_count == 1; otherwise the identifier will not match subsequent tasks handled by the worker.

pub fn next_req_id(&self) -> u64

Generate a unique request ID.

pub fn state(&self) -> &S

Return a reference to the application state.

pub fn instance_pre(&self) -> &ProxyPre<S::StoreData>

Return a reference to the pre-instance.

Trait Implementations

impl<S: HandlerState> Clone for ProxyHandler<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.