Enum Endpoint 

pub enum Endpoint {
    Udp(Addr, Port),
    Tcp(Addr, Port),
    Tls(Addr, Port),
    Quic(Addr, Port),
    Http(Url),
    Https(Url),
    Ws(Url),
    Wss(Url),
    Unix(PathBuf),
}

Endpoint defines generic network endpoints for karyon.

Transport schemes (TCP, UDP, TLS, QUIC, Unix) carry just address + port. URL schemes (HTTP, HTTPS, WS, WSS) carry a full Url so path, query, and other URL semantics are preserved.

Example

use std::net::SocketAddr;

use karyon_net::Endpoint;

let endpoint: Endpoint = "tcp://127.0.0.1:3000".parse().unwrap();

let socketaddr: SocketAddr = "127.0.0.1:3000".parse().unwrap();
let endpoint = Endpoint::new_udp_addr(socketaddr);

let endpoint: Endpoint = "http://example.com:8080/rpc".parse().unwrap();

Variants

Udp(Addr, Port)

Tcp(Addr, Port)

Tls(Addr, Port)

Quic(Addr, Port)

Http(Url)

Https(Url)

Ws(Url)

Wss(Url)

Unix(PathBuf)

Implementations

impl Endpoint

pub fn new_tcp_addr(addr: SocketAddr) -> Endpoint

Creates a new TCP endpoint from a SocketAddr.

pub fn new_udp_addr(addr: SocketAddr) -> Endpoint

Creates a new UDP endpoint from a SocketAddr.

pub fn new_tls_addr(addr: SocketAddr) -> Endpoint

Creates a new TLS endpoint from a SocketAddr.

pub fn new_quic_addr(addr: SocketAddr) -> Endpoint

Creates a new QUIC endpoint from a SocketAddr.

pub fn new_unix_addr(addr: &Path) -> Endpoint

Creates a new Unix endpoint from a UnixSocketAddr.

pub fn is_tcp(&self) -> bool

Checks if the Endpoint is of type Tcp.

pub fn is_tls(&self) -> bool

Checks if the Endpoint is of type Tls.

pub fn is_ws(&self) -> bool

Checks if the Endpoint is of type Ws.

pub fn is_wss(&self) -> bool

Checks if the Endpoint is of type Wss.

pub fn is_quic(&self) -> bool

Checks if the Endpoint is of type Quic.

pub fn is_udp(&self) -> bool

Checks if the Endpoint is of type Udp.

pub fn is_http(&self) -> bool

Checks if the Endpoint is of type Http.

pub fn is_https(&self) -> bool

Checks if the Endpoint is of type Https.

pub fn is_unix(&self) -> bool

Checks if the Endpoint is of type Unix.

pub fn port(&self) -> Result<Port>

Returns the port of the endpoint. For URL-family endpoints the scheme’s default port is returned if the URL omits a port.

pub fn addr(&self) -> Result<Addr>

Returns the address of the endpoint.

Trait Implementations

impl Clone for Endpoint

fn clone(&self) -> Endpoint

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 Display for Endpoint

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

Formats the value using the given formatter.

impl From<Endpoint> for String

fn from(endpoint: Endpoint) -> String

Converts to this type from the input type.

impl FromStr for Endpoint

type Err = Error

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 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: &Endpoint) -> 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 ToEndpoint for Endpoint

fn to_endpoint(&self) -> Result<Endpoint>

impl TryFrom<Endpoint> for PathBuf

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Endpoint> for SocketAddr

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Endpoint> for SocketAddr

Available on crate feature unix and target_family=unix only.

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<Endpoint> for Url

type Error = Error

The type returned in the event of a conversion error.

fn try_from(ep: Endpoint) -> Result<Self>

Performs the conversion.

impl TryFrom<Url> for Endpoint

type Error = Error

The type returned in the event of a conversion error.

fn try_from(url: Url) -> Result<Self>

Performs the conversion.

impl Eq for Endpoint

impl StructuralPartialEq for Endpoint