Struct Window 

pub struct Window<T>
where
    T: Send + Sync + Clone + 'static,
{ /* private fields */ }

A load balancer that limits the number of allocations per entry over a specified time interval.

This implementation supports both async and sync allocation.

Implementations

impl<T> Window<T>

where T: Send + Sync + Clone + 'static,

pub fn new(entries: Vec<(u64, T)>) -> Self

Create a new Window with the default interval of 1 second.

Arguments

• entries - A vector of tuples (max_count, value).

pub fn new_interval(entries: Vec<(u64, T)>, interval: Duration) -> Self

Create a new Window with a custom interval duration.

Arguments

• entries - A vector of tuples (max_count, value).
• interval - Duration after which allocation counts are reset.

pub async fn update<F, R, N>(&self, handler: F) -> Result<N>

where F: Fn(Arc<Inner<T>>) -> R, R: Future<Output = Result<N>>,

Update the load balancer using an async callback.

pub async fn update_timer<F, R>( &self, handler: F, interval: Duration, ) -> Result<JoinHandle<()>>

where F: Fn(Arc<Inner<T>>) -> R + Send + Sync + 'static, R: Future<Output = Result<()>> + Send,

Spawn a background task that calls handler every interval.

The handler is called once immediately; if that initial call fails the error is returned and no background task is spawned. Returns a JoinHandle that can be aborted to stop the timer.

pub async fn alloc_skip(&self, index: usize) -> (usize, T)

Asynchronously allocate an entry, skipping the specified index. Loops until a valid entry is found.

pub fn try_alloc_skip(&self, index: usize) -> Option<(usize, T)>

Try to allocate an entry without awaiting. Returns None immediately if no entry is available.

Trait Implementations

impl<T> Clone for Window<T>

where T: Send + Sync + Clone + 'static + Clone,

fn clone(&self) -> Window<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> LoadBalancer<T> for Window<T>

where T: Send + Sync + Clone + 'static,

fn alloc(&self) -> impl Future<Output = T> + Send

Asynchronously allocate a resource from the load balancer.

fn try_alloc(&self) -> Option<T>

Synchronously try to allocate a resource.