Struct qiniu_http_client::BucketDomainsQueryerBuilder

pub struct BucketDomainsQueryerBuilder { /* private fields */ }

存储空间绑定域名查询构建器

Implementations

impl BucketDomainsQueryerBuilder

pub fn new() -> Self

创建存储空间绑定域名查询构建器

Examples found in repository

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

    pub fn builder() -> BucketDomainsQueryerBuilder {
        BucketDomainsQueryerBuilder::new()
    }

    /// 创建存储空间绑定域名查询器
    #[inline]
    pub fn new() -> BucketDomainsQueryer {
        BucketDomainsQueryerBuilder::new().build()
    }

pub fn http_client(&mut self, http_client: HttpClient) -> &mut Self

设置 HTTP 客户端

Examples found in repository

src/regions/endpoints_provider/bucket_domains_provider.rs (line 147)

    pub fn use_https(&mut self, use_https: bool) -> &mut Self {
        self.http_client(HttpClient::build_default().use_https(use_https).build())
    }

pub fn use_https(&mut self, use_https: bool) -> &mut Self

是否启用 HTTPS 协议

默认为 HTTPS 协议

pub fn uc_endpoints(&mut self, uc_endpoints: impl Into<Endpoints>) -> &mut Self

设置存储空间管理终端地址列表

pub fn cache_lifetime(&mut self, cache_lifetime: Duration) -> &mut Self

缓存时长

pub fn shrink_interval(&mut self, shrink_interval: Duration) -> &mut Self

清理间隔时长

pub fn load_or_create_from(
    &mut self,
    path: impl AsRef<Path>,
    auto_persistent: bool
) -> BucketDomainsQueryer

从文件系统加载或构建存储空间绑定域名查询器

可以选择是否启用自动持久化缓存功能

pub fn build(&mut self) -> BucketDomainsQueryer

从默认文件系统路径加载或构建存储空间绑定域名查询器，并启用自动持久化缓存功能

Examples found in repository

src/regions/endpoints_provider/bucket_domains_provider.rs (line 93)

    pub fn new() -> BucketDomainsQueryer {
        BucketDomainsQueryerBuilder::new().build()
    }

pub fn default_load_or_create_from(
    &mut self,
    auto_persistent: bool
) -> BucketDomainsQueryer

从默认文件系统路径加载或构建存储空间绑定域名查询器

可以选择是否启用自动持久化缓存功能

Examples found in repository

src/regions/endpoints_provider/bucket_domains_provider.rs (line 113)

    fn default() -> Self {
        Self::builder().default_load_or_create_from(true)
    }
}

impl Default for BucketDomainsQueryerBuilder {
    #[inline]
    fn default() -> Self {
        Self {
            http_client: None,
            uc_endpoints: None,
            cache_lifetime: DEFAULT_CACHE_LIFETIME,
            shrink_interval: DEFAULT_SHRINK_INTERVAL,
        }
    }
}

impl BucketDomainsQueryerBuilder {
    /// 创建存储空间绑定域名查询构建器
    #[inline]
    pub fn new() -> Self {
        Self::default()
    }

    /// 设置 HTTP 客户端
    #[inline]
    pub fn http_client(&mut self, http_client: HttpClient) -> &mut Self {
        self.http_client = Some(http_client);
        self
    }

    /// 是否启用 HTTPS 协议
    ///
    /// 默认为 HTTPS 协议
    pub fn use_https(&mut self, use_https: bool) -> &mut Self {
        self.http_client(HttpClient::build_default().use_https(use_https).build())
    }

    /// 设置存储空间管理终端地址列表
    #[inline]
    pub fn uc_endpoints(&mut self, uc_endpoints: impl Into<Endpoints>) -> &mut Self {
        self.uc_endpoints = Some(uc_endpoints.into());
        self
    }

    /// 缓存时长
    #[inline]
    pub fn cache_lifetime(&mut self, cache_lifetime: Duration) -> &mut Self {
        self.cache_lifetime = cache_lifetime;
        self
    }

    /// 清理间隔时长
    #[inline]
    pub fn shrink_interval(&mut self, shrink_interval: Duration) -> &mut Self {
        self.shrink_interval = shrink_interval;
        self
    }

    /// 从文件系统加载或构建存储空间绑定域名查询器
    ///
    /// 可以选择是否启用自动持久化缓存功能
    pub fn load_or_create_from(&mut self, path: impl AsRef<Path>, auto_persistent: bool) -> BucketDomainsQueryer {
        let owned = take(self);
        BucketDomainsQueryer {
            cache: EndpointsCache::load_or_create_from(
                path.as_ref(),
                auto_persistent,
                owned.cache_lifetime,
                owned.shrink_interval,
            ),
            http_client: owned.http_client.unwrap_or_default(),
            uc_endpoints: owned
                .uc_endpoints
                .unwrap_or_else(|| Endpoints::public_uc_endpoints().to_owned()),
        }
    }

    /// 从默认文件系统路径加载或构建存储空间绑定域名查询器，并启用自动持久化缓存功能
    #[inline]
    pub fn build(&mut self) -> BucketDomainsQueryer {
        self.default_load_or_create_from(true)
    }

pub fn in_memory(&mut self) -> BucketDomainsQueryer

构建存储空间绑定域名查询器

不启用文件系统持久化缓存

Trait Implementations

impl Clone for BucketDomainsQueryerBuilder

fn clone(&self) -> BucketDomainsQueryerBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BucketDomainsQueryerBuilder

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

Formats the value using the given formatter.

impl Default for BucketDomainsQueryerBuilder

fn default() -> Self

Returns the “default value” for a type.