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,
}

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.

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

Sets the value of port.

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

Sets the value of principal.

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

Sets the value of region_code.

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.

Trait Implementations

impl Clone for Peer

fn clone(&self) -> Peer

Returns a copy 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<'de> Deserialize<'de> for Peer

where Peer: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Message for Peer

fn typename() -> &'static str

The typename of this message.

fn to_map(&self) -> Result<Map<String, Value>, AnyError>

where Self: Sized + Serialize,

Store the value into a JSON object.

fn from_map(map: &Map<String, Value>) -> Result<Self, AnyError>

where Self: DeserializeOwned,

Extract the value from a JSON object.

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 Serialize for Peer

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Peer