Enum qiniu_http_client::Endpoint

#[non_exhaustive]
pub enum Endpoint {
    DomainWithPort(DomainWithPort),
    IpAddrWithPort(IpAddrWithPort),
}

终端地址

该类型是枚举类型，表示一个域名和端口号，或 IP 地址和端口号

Variants (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.

DomainWithPort(DomainWithPort)

域名和端口号

IpAddrWithPort(IpAddrWithPort)

IP 地址和端口号

Implementations

impl Endpoint

pub fn new_from_domain(domain: impl Into<String>) -> Self

基于域名创建终端地址

Examples found in repository

src/regions/endpoints_provider/endpoints.rs (line 43)

        static DEFAULT_UC_ENDPOINTS: Lazy<Endpoints> = Lazy::new(|| {
            Endpoints::builder(Endpoint::new_from_domain("uc.qbox.me"))
                .add_preferred_endpoint(Endpoint::new_from_domain("kodo-config.qiniuapi.com"))
                .add_preferred_endpoint(Endpoint::new_from_domain("api.qiniu.com"))
                .build()
        });

pub fn new_from_domain_with_port(domain: impl Into<String>, port: u16) -> Self

基于域名和端口号创建终端地址

pub const fn new_from_ip_addr(ip_addr: IpAddr) -> Self

基于 IP 地址创建终端地址

IP 地址可以是 IPv4 地址或 IPv6 地址

pub fn new_from_socket_addr(addr: SocketAddr) -> Self

基于套接字地址创建终端地址

套接字地址可以是 IPv4 地址加端口号，或 IPv6 地址加端口号

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

如果终端地址包含域名，则获得域名

pub fn ip_addr(&self) -> Option<IpAddr>

如果终端地址包含 IP 地址，则获得域名

pub fn port(&self) -> Option<NonZeroU16>

获得端口号

Trait Implementations

impl Clone for Endpoint

fn clone(&self) -> Endpoint

Returns a copy 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

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

fn get_endpoints<'e>(
    &'e self,
    _services: GetOptions<'_>
) -> ApiResult<Cow<'e, Endpoints>>

获取终端地址列表

fn async_get_endpoints<'a>(
    &'a self,
    options: GetOptions<'a>
) -> Pin<Box<dyn Future<Output = ApiResult<Cow<'a, Endpoints>>> + Send + 'a>>

Available on crate feature async only.

异步获取终端地址列表

impl Extend<Endpoint> for EndpointsBuilder

fn extend<T: IntoIterator<Item = Endpoint>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'a> From<&'a str> for Endpoint

fn from(domain: &'a str) -> Self

Converts to this type from the input type.

impl From<(Box<str, Global>, NonZeroU16)> for Endpoint

fn from(domain_with_port: (Box<str>, NonZeroU16)) -> Self

Converts to this type from the input type.

impl From<(Box<str, Global>, u16)> for Endpoint

fn from(domain_with_port: (Box<str>, u16)) -> Self

Converts to this type from the input type.

impl From<(String, NonZeroU16)> for Endpoint

fn from(domain_with_port: (String, NonZeroU16)) -> Self

Converts to this type from the input type.

impl From<(String, u16)> for Endpoint

fn from(domain_with_port: (String, u16)) -> Self

Converts to this type from the input type.

impl From<Authority> for Endpoint

fn from(authority: Authority) -> Self

Converts to this type from the input type.

impl From<Box<str, Global>> for Endpoint

fn from(domain: Box<str>) -> Self

Converts to this type from the input type.

impl From<DomainWithPort> for Endpoint

fn from(domain_with_port: DomainWithPort) -> Self

Converts to this type from the input type.

impl From<IpAddr> for Endpoint

fn from(ip_addr: IpAddr) -> Self

Converts to this type from the input type.

impl From<IpAddrWithPort> for Endpoint

fn from(ip_addr_with_port: IpAddrWithPort) -> Self

Converts to this type from the input type.

impl From<Ipv4Addr> for Endpoint

fn from(ip_addr: Ipv4Addr) -> Self

Converts to this type from the input type.

impl From<Ipv6Addr> for Endpoint

fn from(ip_addr: Ipv6Addr) -> Self

Converts to this type from the input type.

impl From<SocketAddr> for Endpoint

fn from(socket_addr: SocketAddr) -> Self

Converts to this type from the input type.

impl From<SocketAddrV4> for Endpoint

fn from(socket_addr: SocketAddrV4) -> Self

Converts to this type from the input type.

impl From<SocketAddrV6> for Endpoint

fn from(socket_addr: SocketAddrV6) -> Self

Converts to this type from the input type.

impl From<String> for Endpoint

fn from(domain: String) -> Self

Converts to this type from the input type.

impl FromIterator<Endpoint> for Endpoints

fn from_iter<T: IntoIterator<Item = Endpoint>>(iter: T) -> Self

Creates a value from an iterator.

impl FromIterator<Endpoint> for EndpointsBuilder

fn from_iter<T: IntoIterator<Item = Endpoint>>(iter: T) -> Self

Creates a value from an iterator.

impl FromStr for Endpoint

type Err = EndpointParseError

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

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Endpoint

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Endpoint

impl StructuralEq for Endpoint

impl StructuralPartialEq for Endpoint