枚举 ServerName 

#[non_exhaustive]
pub enum ServerName<'a> {
    DnsName(DnsName<'a>),
    IpAddress(IpAddr),
}

表示客户端获知服务器预期名称的途径。

当前它涵盖知晓服务器的 DNS 名称这一情形，未来将扩展到支持服务器的隐私保护名称（“ECH”）。 因此该枚举被声明为 non_exhaustive。

Making one

如果你拥有一个 &str 形式的 DNS 名称，该类型实现了 TryFrom<&str>， 因此你可以这样使用：

ServerName::try_from("example.com").expect("invalid DNS name");

If you have an owned String, you can use TryFrom directly:

let name = "example.com".to_string();
#[cfg(feature = "alloc")]
ServerName::try_from(name).expect("invalid DNS name");

which will yield a ServerName<'static> if successful.

or, alternatively…

let x: ServerName = "example.com".try_into().expect("invalid DNS name");

变体 (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

DnsName(DnsName<'a>)

服务器通过 DNS 名称标识。该名称通过 TLS 的 Server Name Indication (SNI) extension（服务器名称指示扩展）发送。

IpAddress(IpAddr)

服务器通过 IP 地址标识，不发送 SNI。

实现

impl ServerName<'_>

pub fn to_owned(&self) -> ServerName<'static>

从一个（可能为借用的）ServerName 产生一个 owned 的 ServerName。

pub fn to_str(&self) -> Cow<'_, str>

返回该 ServerName 的字符串表示形式。

对于 ServerName::DnsName 实例，此函数返回一个借用的 str。 对于 ServerName::IpAddress 实例，它返回一个分配而来的 String。

trait 实现

impl<'a> Clone for ServerName<'a>

fn clone(&self) -> ServerName<'a>

返回该值的一个副本。更多信息

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

Performs copy-assignment from source. 更多信息

impl Debug for ServerName<'_>

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

使用给定的格式化器格式化该值。更多信息

impl<'a> From<DnsName<'a>> for ServerName<'a>

fn from(dns_name: DnsName<'a>) -> Self

将该输入类型转换为此类型。

impl From<IpAddr> for ServerName<'_>

fn from(addr: IpAddr) -> Self

将该输入类型转换为此类型。

impl From<IpAddr> for ServerName<'_>

Available on crate feature std only.

fn from(addr: IpAddr) -> Self

将该输入类型转换为此类型。

impl From<Ipv4Addr> for ServerName<'_>

fn from(v4: Ipv4Addr) -> Self

将该输入类型转换为此类型。

impl From<Ipv4Addr> for ServerName<'_>

Available on crate feature std only.

fn from(v4: Ipv4Addr) -> Self

将该输入类型转换为此类型。

impl From<Ipv6Addr> for ServerName<'_>

fn from(v6: Ipv6Addr) -> Self

将该输入类型转换为此类型。

impl From<Ipv6Addr> for ServerName<'_>

Available on crate feature std only.

fn from(v6: Ipv6Addr) -> Self

将该输入类型转换为此类型。

impl<'a> Hash for ServerName<'a>

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

将该值送入给定的 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<'a> PartialEq for ServerName<'a>

fn eq(&self, other: &ServerName<'a>) -> bool

测试 self 与 other 值是否相等，供 == 使用。

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<'a> TryFrom<&'a [u8]> for ServerName<'a>

type Error = InvalidDnsNameError

The type returned in the event of a conversion error.

fn try_from(value: &'a [u8]) -> Result<Self, Self::Error>

执行转换。

impl<'a> TryFrom<&'a str> for ServerName<'a>

尝试将一个字符串解析为 DNS 名称或 IP 地址以构造 ServerName。

type Error = InvalidDnsNameError

The type returned in the event of a conversion error.

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

执行转换。

impl TryFrom<String> for ServerName<'static>

Available on crate feature alloc only.

type Error = InvalidDnsNameError

The type returned in the event of a conversion error.

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

执行转换。

impl<'a> Eq for ServerName<'a>

impl<'a> StructuralPartialEq for ServerName<'a>