Struct qiniu_http_client::Region

pub struct Region { /* private fields */ }

七牛存储区域

提供七牛不同服务的终端地址列表

use qiniu_http_client::Region;

let region = Region::builder("z0")
    .add_uc_preferred_endpoint("uc.qbox.me".parse()?)
    .add_up_preferred_endpoint("upload.qiniup.com".parse()?)
    .add_up_preferred_endpoint("up.qiniup.com".parse()?)
    .add_up_alternative_endpoint("up.qbox.me".parse()?)
    .add_rs_preferred_endpoint("rs.qbox.me".parse()?)
    .add_rsf_preferred_endpoint("rsf.qbox.me".parse()?)
    .add_api_preferred_endpoint("api.qiniu.com".parse()?)
    .build();

Implementations

impl Region

pub fn region_id(&self) -> &str

获取区域 ID

pub fn s3_region_id(&self) -> &str

获取 S3 区域 ID

pub fn up_preferred_endpoints(&self) -> &[Endpoint]

获取上传服务主要终端列表

与 up().preferred() 等效

pub fn up_alternative_endpoints(&self) -> &[Endpoint]

获取上传服务备选终端列表

与 up().alternative() 等效

pub fn io_preferred_endpoints(&self) -> &[Endpoint]

获取下载服务主要终端列表

与 io().preferred() 等效

pub fn io_alternative_endpoints(&self) -> &[Endpoint]

获取下载服务备选终端列表

与 io().alternative() 等效

pub fn uc_preferred_endpoints(&self) -> &[Endpoint]

获取存储空间管理服务主要终端列表

与 uc().preferred() 等效

pub fn uc_alternative_endpoints(&self) -> &[Endpoint]

获取存储空间管理服务备选终端列表

与 uc().alternative() 等效

pub fn rs_preferred_endpoints(&self) -> &[Endpoint]

获取元数据管理服务主要终端列表

与 rs().preferred() 等效

pub fn rs_alternative_endpoints(&self) -> &[Endpoint]

获取元数据管理服务备选终端列表

与 rs().alternative() 等效

pub fn rsf_preferred_endpoints(&self) -> &[Endpoint]

获取元数据列举服务主要终端列表

与 rsf().preferred() 等效

pub fn rsf_alternative_endpoints(&self) -> &[Endpoint]

获取元数据列举服务备选终端列表

与 rsf().alternative() 等效

pub fn api_preferred_endpoints(&self) -> &[Endpoint]

获取 API 入口服务主要终端列表

与 api().preferred() 等效

pub fn api_alternative_endpoints(&self) -> &[Endpoint]

获取 API 入口服务备选终端列表

与 api().alternative() 等效

pub fn s3_preferred_endpoints(&self) -> &[Endpoint]

获取 S3 入口服务主要终端列表

与 s3().preferred() 等效

pub fn s3_alternative_endpoints(&self) -> &[Endpoint]

获取 S3 入口服务备选终端列表

与 s3().alternative() 等效

pub fn up(&self) -> &Endpoints

获取上传服务终端地址列表

Examples found in repository

src/regions/region.rs (line 63)

    pub fn up_preferred_endpoints(&self) -> &[Endpoint] {
        self.up().preferred()
    }

    /// 获取上传服务备选终端列表
    ///
    /// 与 `up().alternative()` 等效
    #[inline]
    pub fn up_alternative_endpoints(&self) -> &[Endpoint] {
        self.up().alternative()
    }

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

    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()
    }

pub fn io(&self) -> &Endpoints

获取下载服务终端地址列表

Examples found in repository

src/regions/region.rs (line 79)

    pub fn io_preferred_endpoints(&self) -> &[Endpoint] {
        self.io().preferred()
    }

    /// 获取下载服务备选终端列表
    ///
    /// 与 `io().alternative()` 等效
    #[inline]
    pub fn io_alternative_endpoints(&self) -> &[Endpoint] {
        self.io().alternative()
    }

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

    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()
    }

pub fn uc(&self) -> &Endpoints

获取存储空间管理服务终端地址列表

Examples found in repository

src/regions/region.rs (line 95)

    pub fn uc_preferred_endpoints(&self) -> &[Endpoint] {
        self.uc().preferred()
    }

    /// 获取存储空间管理服务备选终端列表
    ///
    /// 与 `uc().alternative()` 等效
    #[inline]
    pub fn uc_alternative_endpoints(&self) -> &[Endpoint] {
        self.uc().alternative()
    }

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

    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()
    }

pub fn rs(&self) -> &Endpoints

获取元数据管理服务终端地址列表

Examples found in repository

src/regions/region.rs (line 111)

    pub fn rs_preferred_endpoints(&self) -> &[Endpoint] {
        self.rs().preferred()
    }

    /// 获取元数据管理服务备选终端列表
    ///
    /// 与 `rs().alternative()` 等效
    #[inline]
    pub fn rs_alternative_endpoints(&self) -> &[Endpoint] {
        self.rs().alternative()
    }

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

    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()
    }

pub fn rsf(&self) -> &Endpoints

获取元数据列举服务终端地址列表

Examples found in repository

src/regions/region.rs (line 127)

    pub fn rsf_preferred_endpoints(&self) -> &[Endpoint] {
        self.rsf().preferred()
    }

    /// 获取元数据列举服务备选终端列表
    ///
    /// 与 `rsf().alternative()` 等效
    #[inline]
    pub fn rsf_alternative_endpoints(&self) -> &[Endpoint] {
        self.rsf().alternative()
    }

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

    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()
    }

pub fn api(&self) -> &Endpoints

获取 API 入口服务终端地址列表

Examples found in repository

src/regions/region.rs (line 143)

    pub fn api_preferred_endpoints(&self) -> &[Endpoint] {
        self.api().preferred()
    }

    /// 获取 API 入口服务备选终端列表
    ///
    /// 与 `api().alternative()` 等效
    #[inline]
    pub fn api_alternative_endpoints(&self) -> &[Endpoint] {
        self.api().alternative()
    }

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

    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()
    }

pub fn s3(&self) -> &Endpoints

获取 S3 入口服务终端地址列表

Examples found in repository

src/regions/region.rs (line 159)

    pub fn s3_preferred_endpoints(&self) -> &[Endpoint] {
        self.s3().preferred()
    }

    /// 获取 S3 入口服务备选终端列表
    ///
    /// 与 `s3().alternative()` 等效
    #[inline]
    pub fn s3_alternative_endpoints(&self) -> &[Endpoint] {
        self.s3().alternative()
    }

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

    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()
    }

pub fn builder(region_id: impl Into<String>) -> RegionBuilder

创建区域构建器

Examples found in repository

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

    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 Region

fn clone(&self) -> Region

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Region

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Region

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Extend<Region> for GotRegions

fn extend<T: IntoIterator<Item = Region>>(&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 Extend<Region> for StaticRegionsProvider

fn extend<T: IntoIterator<Item = Region>>(&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 From<GotRegion> for Region

fn from(result: GotRegion) -> Self

Converts to this type from the input type.

impl From<Region> for GotRegion

fn from(region: Region) -> Self

Converts to this type from the input type.

impl From<Region> for StaticRegionsProvider

fn from(region: Region) -> Self

Converts to this type from the input type.

impl FromIterator<Region> for GotRegions

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

Creates a value from an iterator.

impl FromIterator<Region> for StaticRegionsProvider

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

Creates a value from an iterator.

impl PartialEq<Region> for Region

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

fn get(&self, _opts: GetOptions) -> ApiResult<GotRegion>

返回七牛区域信息

fn get_all(&self, opts: GetOptions) -> ApiResult<GotRegions>

返回多个七牛区域信息

fn async_get(&self, opts: GetOptions) -> BoxFuture<'_, ApiResult<GotRegion>>

Available on crate feature async only.

异步返回七牛区域信息

fn async_get_all(&self, opts: GetOptions) -> BoxFuture<'_, ApiResult<GotRegions>>

Available on crate feature async only.

异步返回多个七牛区域信息

impl Serialize for Region

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 Region

impl StructuralEq for Region

impl StructuralPartialEq for Region