Struct qiniu_http_client::EndpointsBuilder

pub struct EndpointsBuilder { /* private fields */ }

终端地址列表构建器

Implementations

impl EndpointsBuilder

pub fn add_preferred_endpoint(&mut self, endpoint: Endpoint) -> &mut Self

添加一个主要终端地址

Examples found in repository

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

        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 add_alternative_endpoint(&mut self, endpoint: Endpoint) -> &mut Self

添加一个备选终端地址

pub fn add_preferred_endpoints(
    &mut self,
    endpoints: impl IntoIterator<Item = Endpoint>
) -> &mut Self

添加多个主要终端地址

pub fn add_alternative_endpoints(
    &mut self,
    endpoints: impl IntoIterator<Item = Endpoint>
) -> &mut Self

添加多个备选终端地址

pub fn build(&mut self) -> Endpoints

构建终端地址列表

Examples found in repository

src/regions/endpoints_provider/mod.rs (line 85)

    fn get_endpoints<'e>(&'e self, _services: GetOptions<'_>) -> ApiResult<Cow<'e, Endpoints>> {
        Ok(Cow::Owned(Endpoints::builder(self.to_owned()).build()))
    }

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

        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()
        });
        &DEFAULT_UC_ENDPOINTS
    }

    /// 创建只包含一个主要终端地址的终端地址列表
    #[inline]
    pub fn new(endpoint: Endpoint) -> Self {
        Self::builder(endpoint).build()
    }

    /// 返回主要终端地址列表
    #[inline]
    pub fn preferred(&self) -> &[Endpoint] {
        &self.preferred
    }

    /// 返回备选终端地址列表
    #[inline]
    pub fn alternative(&self) -> &[Endpoint] {
        &self.alternative
    }

    /// 对比两组终端地址列表是否相似
    ///
    /// 相似指的是，两个终端地址列表内主要终端地址列表中的域名相同，备选终端地址列表中的域名也相同，但顺序可能不同
    #[inline]
    pub fn similar(&self, other: &Self) -> bool {
        self.md5() == other.md5()
    }

    fn from_region(region: &Region, services: &[ServiceName]) -> Self {
        let mut builder = EndpointsBuilder {
            preferred: vec![],
            alternative: vec![],
        };

        for service in services {
            let e = match service {
                ServiceName::Up => region.up(),
                ServiceName::Io => region.io(),
                ServiceName::Uc => region.uc(),
                ServiceName::Rs => region.rs(),
                ServiceName::Rsf => region.rsf(),
                ServiceName::Api => region.api(),
                ServiceName::S3 => region.s3(),
            };
            builder.preferred.extend_from_slice(e.preferred());
            builder.alternative.extend_from_slice(e.alternative());
        }
        builder.build()
    }

Trait Implementations

impl Clone for EndpointsBuilder

fn clone(&self) -> EndpointsBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for EndpointsBuilder

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

Formats the value using the given formatter.

impl Default for EndpointsBuilder

fn default() -> EndpointsBuilder

Returns the “default value” for a type.

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

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

Creates a value from an iterator.