Struct qiniu_download::RangeReaderBuilder

pub struct RangeReaderBuilder { /* fields omitted */ }

对象范围下载构建器

Implementations

impl RangeReaderBuilder

pub fn new(
    bucket: impl Into<String>,
    key: impl Into<String>,
    credential: Credential,
    io_urls: Vec<String>
) -> Self

创建对象范围下载构建器

Arguments

• bucket - 存储空间
• key - 对象名称
• credential - 存储空间所在账户的凭证
• io_urls - 七牛 IO 服务器 URL 列表

pub fn uc_urls(self, urls: Vec<String>) -> Self

设置七牛 UC 服务器 URL 列表

pub fn monitor_urls(self, urls: Vec<String>) -> Self

设置七牛监控服务器 URL 列表

pub fn io_tries(self, tries: usize) -> Self

设置对象下载最大尝试次数

pub fn uc_tries(self, tries: usize) -> Self

设置 UC 查询的最大尝试次数

pub fn dot_tries(self, tries: usize) -> Self

设置打点记录上传的最大尝试次数

pub fn update_interval(self, interval: Duration) -> Self

设置 UC 查询的频率

pub fn punish_duration(self, duration: Duration) -> Self

设置域名访问失败后的惩罚时长

pub fn base_timeout(self, timeout: Duration) -> Self

设置域名访问的基础超时时长

pub fn max_punished_times(self, max_times: usize) -> Self

设置失败域名的最大重试次数

一旦一个域名的被惩罚次数超过限制，则域名选择器不会选择该域名，除非被惩罚的域名比例超过上限，或惩罚时长超过指定时长

pub fn max_punished_hosts_percent(self, percent: u8) -> Self

设置被惩罚的域名最大比例

域名选择器在搜索域名时，一旦被跳过的域名比例大于该值，则下一个域名将被选中，不管该域名是否也被惩罚。一旦该域名成功，则惩罚将立刻被取消

pub fn use_getfile_api(self, use_getfile_api: bool) -> Self

设置是否使用 getfile API 下载

pub fn normalize_key(self, normalize_key: bool) -> Self

设置是否对 key 进行格式化

pub fn private_url_lifetime(
    self,
    private_url_lifetime: Option<Duration>
) -> Self

设置私有空间下载 URL 有效期，如果为 None，则使用公开空间下载 URL

pub fn dot_interval(self, dot_interval: Duration) -> Self

设置打点记录上传频率

pub fn max_dot_buffer_size(self, max_dot_buffer_size: u64) -> Self

设置打点记录本地缓存文件尺寸上限

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

设置是否使用 HTTPS 协议来访问 IO 服务器

pub fn build(self) -> RangeReader

构建范围下载器

pub fn from_config(key: impl Into<String>, config: &Config) -> Self

从配置创建范围下载构建器

Arguments

• key - 对象名称
• config - 下载配置

pub fn from_env(key: impl Into<String>) -> Option<Self>

从环境变量创建范围下载构建器

Arguments

• key - 对象名称

Trait Implementations

impl Debug for RangeReaderBuilder

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

Formats the value using the given formatter.