Struct abstract_ns::Address

pub struct Address(_);

Address that nameservice has returned

We hide this structure to allow future additions. There is AddressBuilder which provides a forward compatible way to build such address in a resolver and there are methods to extract data from it.

Internally it's an Arc over a structure so it's cheap to clone and you can cache addresses.

Methods

impl Address

fn pick_one(&self) -> Option<SocketAddr>

Select one random address to connect to

Picks a single address from the set of high priority addresses, with the random distribution according to the weights.

This method is stateless so it can't find out that high priority addresses are all inaccessible and fallback addresses should be used.

Returns None if address is empty

fn at(&self, priority: usize) -> WeightedSet

Returns the set of the hosts for the same priority

Note: original priorities are lost. This method has contiguous array of sets of hosts. The highest priority hosts returned by .at(0).

If no hosts the priority exists returns an empty set

Use iter() to iterate over WeightedSet's by priority

fn iter(&self) -> PriorityIter

Returns iterator over WeightedSet's starting from high priority set

Trait Implementations

impl Clone for Address

fn clone(&self) -> Address

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Address

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl From<(IpAddr, u16)> for Address

fn from((ip, port): (IpAddr, u16)) -> Address

Performs the conversion.

impl From<SocketAddr> for Address

fn from(addr: SocketAddr) -> Address

Performs the conversion.

impl<'a> From<&'a [SocketAddr]> for Address

fn from(addr: &[SocketAddr]) -> Address

Performs the conversion.

impl FromIterator<SocketAddr> for Address

fn from_iter<T>(iter: T) -> Self where T: IntoIterator<Item=SocketAddr>

Creates a value from an iterator.

impl PartialEq for Address

fn eq(&self, other: &Address) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl Eq for Address