Struct BrokerSearch 

pub struct BrokerSearch { /* private fields */ }

Available on crate feature alloc only.

One broker search, with no I/O: the backend’s sightings and the time go in; requeries and, once, the result come out.

The browse covers every broker type, so a broker of a type not accepted is logged with reason=brokerTransportNotAccepted, and a broker wanted by device id is found under an accepted transport when only another of its transports carries the id. The result is set settle_ms after a usable broker is first seen, so each broker’s every transport has been heard and the one earliest in BrokerConfig::accepted is chosen; in DiscoveryWithFallback with a URL, the configured broker becomes the result fallback_after_ms after the start when no usable broker is pending. While no usable broker is seen, BrokerSearch::poll_requery asks for a requery 3 s, 6 s and 36 s after the start, then every 30 s. Once set, the result never changes.

Implementations

impl BrokerSearch

pub fn new(now: Instant, cfg: BrokerConfig) -> Result<Self, BrokerConfigError>

A search starting at now. In ConfiguredOnly the result is the configured broker at once.

pub fn browses(&self) -> bool

False in ConfiguredOnly: no browse runs.

pub fn mode(&self) -> BrokerMode

The mode in effect.

pub fn browse_types(&self) -> &'static [BrokerType]

The service types to browse: every broker type.

pub fn handle(&mut self, now: Instant, s: Sighting)

Apply a backend report.

pub fn handle_timeout(&mut self, now: Instant)

Advance to now: settle, fall back or schedule a requery when due.

pub fn poll_requery(&mut self) -> bool

True once per requery the search asks the backend for.

pub fn poll_timeout(&self) -> Option<Instant>

The next instant BrokerSearch::handle_timeout has work at.

pub fn result(&self) -> Option<&BrokerEndpoint>

The broker chosen, set once and then fixed.

pub fn candidates(&self) -> Vec<BrokerEndpoint>

The accepted brokers now seen, with wanted applied, ranked.

Trait Implementations

impl Clone for BrokerSearch

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrokerSearch

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

Formats the value using the given formatter.