Struct Backend

pub struct Backend<S: Serve<T>, T: Transfer> { /* private fields */ }

Fat wrapper around VCL_BACKEND.

It will handle almost all the necessary boilerplate needed to create a vmod. 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: Serve<T>, T: Transfer> 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 vcl_ptr(&self) -> VCL_BACKEND

Return the C pointer wrapped by the Backend. Conventionally used by the .backend() methods of VCL objects.

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

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

Trait Implementations

impl<S: Debug + Serve<T>, T: Debug + Transfer> Debug for Backend<S, T>

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

Formats the value using the given formatter.

impl<S: Serve<T>, T: Transfer> Drop for Backend<S, T>

fn drop(&mut self)

Executes the destructor for this type.