Struct Director 

pub struct Director<D: VclDirector> { /* private fields */ }

Safe wrapper around a struct director pointer with a trait implementation

This struct wraps a C director along with a Rust implementation that provides the director’s behavior through the VclDirector trait. The wrapper handles the FFI boundary and ensures proper lifetime management.

Directors are typically used to implement load balancing strategies (round-robin, random, hash-based, etc.) by selecting from multiple backends.

Implementations

impl<D: VclDirector> Director<D>

pub fn new( ctx: &mut Ctx<'_>, director_type: &str, vcl_name: &str, inner: D, ) -> VclResult<Self>

Create a new director by calling VRT_AddDirector

This registers the director with Varnish and sets up the appropriate callbacks. The director will be automatically unregistered when dropped.

pub fn get_inner(&self) -> &D

Access the bep director implementation

pub fn get_inner_mut(&mut self) -> &mut D

Access the bep director implementation mutably

pub fn resolve(&self, ctx: &Ctx<'_>) -> VCL_BACKEND

Resolve this director to a backend using VRT_DirectorResolve

This calls into Varnish’s resolution mechanism, which will invoke the director’s resolve method if needed.

pub fn probe(&self, ctx: &Ctx<'_>) -> ProbeResult

Check if this director is healthy using VRT_Healthy

Trait Implementations

impl<D: VclDirector> AsRef<BackendRef> for Director<D>

fn as_ref(&self) -> &BackendRef

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

impl<D: Debug + VclDirector> Debug for Director<D>

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

Formats the value using the given formatter.

impl<D: VclDirector> Drop for Director<D>

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.