Struct Authority 

pub struct Authority {
    pub host: String,
    pub port: u16,
}

Host and port extracted from HTTP request targets (RFC 9110 §7.2).

Represents the authority component of a URI, containing the host (domain name or IP address) and port number. Used for routing proxy requests to origin servers.

Fields

host: String

Hostname or IP literal (without brackets for IPv6).

port: u16

Port number.

Implementations

impl Authority

pub fn new(host: String, port: u16) -> Self

Creates an authority from host and port components.

pub fn from_authority_uri(uri: &Uri) -> Result<Self>

Parses an authority-form request target (RFC 9110 §7.1).

Authority-form is used with CONNECT requests: host:port with no scheme or path.

Errors

Returns an error if the URI contains a scheme, path, or lacks a port.

pub fn from_absolute_uri(uri: &Uri) -> Result<Self>

Parses an absolute-form request target (RFC 9110 §7.1).

Absolute-form includes scheme, host, and optional port: http://host:port/path. If no port is specified, defaults to 80 for HTTP or 443 for HTTPS.

Errors

Returns an error if the URI lacks an authority or has an unsupported scheme without an explicit port.

pub fn from_authority_str(s: &str) -> Result<Self>

Parses an authority-form string (host:port).

See from_authority_uri for details.

pub fn from_absolute_uri_str(s: &str) -> Result<Self>

Parses an absolute-form URI string.

See from_absolute_uri for details.

Trait Implementations

impl Clone for Authority

fn clone(&self) -> Authority

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Authority

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

Formats the value using the given formatter.

impl Display for Authority

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

Formats the value using the given formatter.

impl FromStr for Authority

type Err = AnyError

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 Authority

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 Ord for Authority

fn cmp(&self, other: &Authority) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Authority

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

fn partial_cmp(&self, other: &Authority) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for Authority

impl StructuralPartialEq for Authority