Struct Peer 

#[non_exhaustive]
pub struct Peer {
    pub ip: String,
    pub port: i64,
    pub labels: HashMap<String, String>,
    pub principal: String,
    pub region_code: String,
    /* private fields */
}

This message defines attributes for a node that handles a network request. The node can be either a service or an application that sends, forwards, or receives the request. Service peers should fill in principal and labels as appropriate.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

ip: String

The IP address of the peer.

port: i64

The network port of the peer.

labels: HashMap<String, String>

The labels associated with the peer.

principal: String

The identity of this peer. Similar to Request.auth.principal, but relative to the peer instead of the request. For example, the identity associated with a load balancer that forwarded the request.

region_code: String

The CLDR country/region code associated with the above IP address. If the IP address is private, the region_code should reflect the physical location where this peer is running.

Implementations

impl Peer

pub fn new() -> Self

pub fn set_ip<T: Into<String>>(self, v: T) -> Self

Sets the value of ip.

Example

let x = Peer::new().set_ip("example");

pub fn set_port<T: Into<i64>>(self, v: T) -> Self

Sets the value of port.

Example

let x = Peer::new().set_port(42);

pub fn set_labels<T, K, V>(self, v: T) -> Self

where T: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Sets the value of labels.

Example

let x = Peer::new().set_labels([
    ("key0", "abc"),
    ("key1", "xyz"),
]);

pub fn set_principal<T: Into<String>>(self, v: T) -> Self

Sets the value of principal.

Example

let x = Peer::new().set_principal("example");

pub fn set_region_code<T: Into<String>>(self, v: T) -> Self

Sets the value of region_code.

Example

let x = Peer::new().set_region_code("example");

Trait Implementations

impl Clone for Peer

fn clone(&self) -> Peer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Peer

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

Formats the value using the given formatter.

impl Default for Peer

fn default() -> Peer

Returns the “default value” for a type.

impl Message for Peer

fn typename() -> &'static str

The typename of this message.

impl PartialEq for Peer

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Peer