Struct qiniu_http_client::RegionBuilder

pub struct RegionBuilder { /* private fields */ }

区域构建器

use qiniu_http_client::RegionBuilder;

let region = RegionBuilder::new("z0")
    .add_uc_preferred_endpoint("10.11.0.178:10221".parse()?) // 添加一个终端地址
    .add_uc_preferred_endpoint("10.11.0.180:10221".parse()?)
    .add_up_preferred_endpoint("10.11.0.178:5010".parse()?)
    .add_up_preferred_endpoint("10.11.0.180:5010".parse()?)
    .add_io_preferred_endpoint("10.11.0.178:5000".parse()?)
    .add_io_preferred_endpoint("10.11.0.180:5000".parse()?)
    .add_rs_preferred_endpoints(["10.11.0.178:9433".parse()?, "10.11.0.180:9433".parse()?]) // 添加多个终端地址
    .add_rsf_preferred_endpoints(["10.11.0.178:7913".parse()?, "10.11.0.180:7913".parse()?])
    .build();

Implementations

impl RegionBuilder

pub fn new(region_id: impl Into<String>) -> Self

创建新的区域，传入终端 ID

Examples found in repository

src/regions/region.rs (line 215)

    pub fn builder(region_id: impl Into<String>) -> RegionBuilder {
        RegionBuilder::new(region_id.into())
    }

pub fn s3_region_id(&mut self, s3_region_id: impl Into<String>) -> &mut Self

设置 S3 区域 ID

Examples found in repository

src/regions/regions_provider/structs.rs (line 95)

    fn try_from(body: RegionResponseBody) -> Result<Self, Self::Error> {
        let RegionResponseBody {
            region,
            io,
            up,
            uc,
            rs,
            rsf,
            api,
            s3,
            ..
        } = body;
        let mut builder = Self::builder(region);

        macro_rules! push_to_builder {
            ($service_name:expr, $add_to_preferred_endpoint:ident, $add_to_alternative_endpoint:ident) => {
                for preferred_domain in $service_name.preferred.iter() {
                    let endpoint: Endpoint = preferred_domain.as_ref().parse()?;
                    builder.$add_to_preferred_endpoint(endpoint);
                }
                if let Some(alternative_domains) = &$service_name.alternative {
                    for alternative_domain in alternative_domains.iter() {
                        let endpoint: Endpoint = alternative_domain.as_ref().parse()?;
                        builder.$add_to_alternative_endpoint(endpoint);
                    }
                }
            };
        }
        push_to_builder!(io, add_io_preferred_endpoint, add_io_alternative_endpoint);
        push_to_builder!(up, add_up_preferred_endpoint, add_up_alternative_endpoint);
        push_to_builder!(uc, add_uc_preferred_endpoint, add_uc_alternative_endpoint);
        push_to_builder!(rs, add_rs_preferred_endpoint, add_rs_alternative_endpoint);
        push_to_builder!(rsf, add_rsf_preferred_endpoint, add_rsf_alternative_endpoint);
        push_to_builder!(api, add_api_preferred_endpoint, add_api_alternative_endpoint);
        push_to_builder!(s3, add_s3_preferred_endpoint, add_s3_alternative_endpoint);
        if let Some(s3_region_id) = s3.s3_region_id {
            builder.s3_region_id(s3_region_id);
        }

        Ok(builder.build())
    }

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

添加访问终端地址到上传服务主要终端地址列表

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

添加多个访问终端地址到上传服务主要终端地址列表

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

添加访问终端地址到上传服务备选终端地址列表

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

添加多个访问终端地址到上传服务备选终端地址列表

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

添加访问终端地址到下载服务主要终端地址列表

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

添加多个访问终端地址到下载服务主要终端地址列表

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

添加访问终端地址到下载服务备选终端地址列表

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

添加多个访问终端地址到下载服务备选终端地址列表

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

添加访问终端地址到存储空间管理服务主要终端地址列表

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

添加多个访问终端地址到存储空间管理服务主要终端地址列表

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

添加访问终端地址到存储空间管理服务备选终端地址列表

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

添加多个访问终端地址到存储空间管理服务备选终端地址列表

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

添加访问终端地址到元数据管理服务主要终端地址列表

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

添加多个访问终端地址到元数据管理服务主要终端地址列表

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

添加访问终端地址到元数据管理服务备选终端地址列表

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

添加多个访问终端地址到元数据管理服务备选终端地址列表

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

添加访问终端地址到元数据列举服务主要终端地址列表

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

添加多个访问终端地址到元数据列举服务主要终端地址列表

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

添加访问终端地址到元数据列举服务备选终端地址列表

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

添加多个访问终端地址到元数据列举服务备选终端地址列表

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

添加访问终端地址到 API 入口服务主要终端地址列表

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

添加多个访问终端地址到 API 入口服务主要终端地址列表

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

添加访问终端地址到 API 入口服务备选终端地址列表

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

添加多个访问终端地址到 API 入口服务备选终端地址列表

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

添加访问终端地址到 S3 入口服务主要终端地址列表

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

添加多个访问终端地址到 S3 入口服务主要终端地址列表

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

添加访问终端地址到 S3 入口服务备选终端地址列表

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

添加多个访问终端地址到 S3 入口服务备选终端地址列表

pub fn build(&mut self) -> Region

构建区域

Examples found in repository

src/regions/regions_provider/structs.rs (line 98)

    fn try_from(body: RegionResponseBody) -> Result<Self, Self::Error> {
        let RegionResponseBody {
            region,
            io,
            up,
            uc,
            rs,
            rsf,
            api,
            s3,
            ..
        } = body;
        let mut builder = Self::builder(region);

        macro_rules! push_to_builder {
            ($service_name:expr, $add_to_preferred_endpoint:ident, $add_to_alternative_endpoint:ident) => {
                for preferred_domain in $service_name.preferred.iter() {
                    let endpoint: Endpoint = preferred_domain.as_ref().parse()?;
                    builder.$add_to_preferred_endpoint(endpoint);
                }
                if let Some(alternative_domains) = &$service_name.alternative {
                    for alternative_domain in alternative_domains.iter() {
                        let endpoint: Endpoint = alternative_domain.as_ref().parse()?;
                        builder.$add_to_alternative_endpoint(endpoint);
                    }
                }
            };
        }
        push_to_builder!(io, add_io_preferred_endpoint, add_io_alternative_endpoint);
        push_to_builder!(up, add_up_preferred_endpoint, add_up_alternative_endpoint);
        push_to_builder!(uc, add_uc_preferred_endpoint, add_uc_alternative_endpoint);
        push_to_builder!(rs, add_rs_preferred_endpoint, add_rs_alternative_endpoint);
        push_to_builder!(rsf, add_rsf_preferred_endpoint, add_rsf_alternative_endpoint);
        push_to_builder!(api, add_api_preferred_endpoint, add_api_alternative_endpoint);
        push_to_builder!(s3, add_s3_preferred_endpoint, add_s3_alternative_endpoint);
        if let Some(s3_region_id) = s3.s3_region_id {
            builder.s3_region_id(s3_region_id);
        }

        Ok(builder.build())
    }

Trait Implementations

impl Clone for RegionBuilder

fn clone(&self) -> RegionBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RegionBuilder

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

Formats the value using the given formatter.

impl Default for RegionBuilder

fn default() -> RegionBuilder

Returns the “default value” for a type.

impl PartialEq<RegionBuilder> for RegionBuilder

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

impl StructuralEq for RegionBuilder

impl StructuralPartialEq for RegionBuilder