Struct EndpointList 

pub struct EndpointList { /* private fields */ }

Priority-ordered list of endpoints with failover support.

Implementations

impl EndpointList

pub fn new() -> Self

Create a new, empty list.

pub fn with_primary(url: impl Into<String>) -> Self

Create with a single primary endpoint.

pub fn add_endpoint(&mut self, url: impl Into<String>, priority: u32)

Add an endpoint with the given priority. Re-sorts internally.

pub fn len(&self) -> usize

Number of registered endpoints.

pub fn is_empty(&self) -> bool

Check if the list is empty.

pub fn iter(&self) -> impl Iterator<Item = &EndpointEntry>

Iterate endpoints in priority order.

pub fn next_endpoint(&self) -> Option<&EndpointEntry>

Get the next endpoint to try after the currently active one. Wraps around if at the end of the list.

pub fn primary(&self) -> Option<&EndpointEntry>

Get the first (highest-priority) endpoint.

pub fn set_active(&mut self, index: usize) -> Result<()>

Mark an endpoint as active by index.

pub fn set_active_by_url(&mut self, url: &str) -> Result<()>

Mark the endpoint with the given URL as active.

pub fn active(&self) -> Option<&ActiveEndpoint>

Get the currently active endpoint.

pub fn clear_active(&mut self)

Clear the active endpoint.

pub fn failover(&mut self) -> Option<String>

Perform a failover: activate the next endpoint in priority order. Returns the newly active endpoint’s URL, or None if the list is empty.

Trait Implementations

impl Clone for EndpointList

fn clone(&self) -> EndpointList

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EndpointList

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

Formats the value using the given formatter.

impl Default for EndpointList

fn default() -> Self

Returns the “default value” for a type.