Struct PeerEndpoint 

pub struct PeerEndpoint(/* private fields */);

A scheme-less host:port advertising the tsoracle service address of a peer node.

Contract (enforced at construction):

• No http:// / https:// prefix. The TLS client silently drops scheme-bearing leader hints (rejects_plaintext_hint) to refuse a transport downgrade, so a scheme-bearing endpoint would make its owner unreachable via follower redirect — a silent prod trap. (See tsoracle_server::fence::endpoint_is_scheme_less for the historical runtime guard this newtype subsumes.)
• Non-empty.
• Includes an explicit :port with a numeric port in 1..=65535.
• Bracketed IPv6 supported ([::1]:50051).

Consumers that need to dial this endpoint prepend http:// / https:// at dial time based on their TLS configuration (see e.g. tsoracle_client::channel_pool); the endpoint itself is transport-agnostic.

Implementations

impl PeerEndpoint

pub fn as_str(&self) -> &str

Borrow the underlying host:port string.

pub fn into_inner(self) -> String

Consume self, returning the underlying String.

Trait Implementations

impl AsRef<str> for PeerEndpoint

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for PeerEndpoint

fn clone(&self) -> PeerEndpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PeerEndpoint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PeerEndpoint

Available on crate feature serde only.

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for PeerEndpoint

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

Formats the value using the given formatter.

impl Eq for PeerEndpoint

impl FromStr for PeerEndpoint

type Err = PeerEndpointError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for PeerEndpoint

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PeerEndpoint

fn eq(&self, other: &PeerEndpoint) -> 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 PeerEndpoint

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PeerEndpoint

impl TryFrom<&str> for PeerEndpoint

type Error = PeerEndpointError

The type returned in the event of a conversion error.

fn try_from(s: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for PeerEndpoint

type Error = PeerEndpointError

The type returned in the event of a conversion error.

fn try_from(endpoint: String) -> Result<Self, Self::Error>

Performs the conversion.