Struct Backend 

pub struct Backend<S: VclBackend<T>, T: VclResponse> { /* private fields */ }

Fat wrapper around VCL_BACKEND.

It will handle almost all the necessary boilerplate needed to create a custom backend. Most importantly, it destroys/unregisters the backend as part of it’s Drop implementation, and will convert the C methods to something more idiomatic.

Once created, a Backend’s sole purpose is to exist as a C reference for the VCL. As a result, you don’t want to drop it until after all the transfers are done. The most common way is just to have the backend be part of a vmod object because the object won’t be dropped until the VCL is discarded and that can only happen once all the backend fetches are done.

Implementations

impl<S: VclBackend<T>, T: VclResponse> Backend<S, T>

pub fn get_inner(&self) -> &S

Access the inner type wrapped by Backend. Note that it isn’t mut as other threads are likely to have access to it too.

pub fn new( ctx: &mut Ctx<'_>, backend_type: &str, backend_id: &str, be: S, has_probe: bool, ) -> VclResult<Self>

Create a new builder, wrapping the inner structure (that implements VclBackend), calling the backend backend_id. If the backend has a probe attached to it, set has_probe to true.

Trait Implementations

impl<S: VclBackend<T>, T: VclResponse> AsRef<BackendRef> for Backend<S, T>

fn as_ref(&self) -> &BackendRef

Converts this type into a shared reference of the (usually inferred) input type.

impl<S: Debug + VclBackend<T>, T: Debug + VclResponse> Debug for Backend<S, T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: VclBackend<T>, T: VclResponse> Drop for Backend<S, T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.