Struct Endpoint 

pub struct Endpoint { /* private fields */ }

Network endpoint for contacting an agent.

Represents a reachable address where an agent can be contacted. Multiple endpoints may be provided for redundancy or protocol flexibility.

Examples

use agent_uri_dht::Endpoint;

let https = Endpoint::new("https", "agent.example.com:443", Some("/v1/agent"));
let grpc = Endpoint::new("grpc", "agent.example.com:50051", None::<&str>);

Implementations

impl Endpoint

pub fn new( protocol: impl Into<String>, address: impl Into<String>, path: Option<impl Into<String>>, ) -> Self

Creates a new endpoint.

Arguments

• protocol - Transport protocol (e.g., “https”, “grpc”, “ws”)
• address - Host and optional port (e.g., “example.com:443”)
• path - Optional path prefix (e.g., “/v1/agent”)

pub fn https(address: impl Into<String>) -> Self

Creates an HTTPS endpoint.

pub fn https_with_path( address: impl Into<String>, path: impl Into<String>, ) -> Self

Creates an HTTPS endpoint with a path.

pub fn grpc(address: impl Into<String>) -> Self

Creates a gRPC endpoint.

pub fn websocket(address: impl Into<String>) -> Self

Creates a WebSocket endpoint.

pub fn protocol(&self) -> &str

Returns the protocol.

pub fn address(&self) -> &str

Returns the address.

pub fn path(&self) -> Option<&str>

Returns the path, if any.

pub fn to_uri(&self) -> String

Returns the full URI representation.

Trait Implementations

impl Clone for Endpoint

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 Endpoint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Endpoint

Available on crate feature serde only.

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

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Endpoint

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

Formats the value using the given formatter.

impl Eq for Endpoint

impl Hash for Endpoint

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 Endpoint

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Endpoint

Available on crate feature serde only.

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 Endpoint