9 releases
0.2.4 | Dec 26, 2023 |
---|---|
0.2.3 | May 23, 2023 |
0.2.2 | Dec 23, 2022 |
0.2.1 | Nov 1, 2022 |
0.1.2 | Jun 9, 2022 |
#74 in HTTP client
Used in 2 crates
(via qiniu-sdk)
1MB
22K
SLoC
Qiniu-Download-Manager
概览
基于 qiniu-apis
提供针对七牛对象的下载功能 (同时提供阻塞客户端和异步客户端,异步客户端则需要启用 async
功能)。
安装
不启用异步接口,推荐使用 ureq
[dependencies]
qiniu-download-manager = { version = "0.2.1", features = ["ureq"] }
启用 Isahc 异步接口
[dependencies]
qiniu-download-manager = { version = "0.2.1", features = ["async", "isahc"] }
启用 Reqwest 异步接口
[dependencies]
qiniu-download-manager = { version = "0.2.1", features = ["async", "reqwest"] }
其他功能
c_ares
启用 c-ares
库作为 DNS 解析器
trust_dns
启用 trust-dns
库作为 DNS 解析器
dns-over-https
启用 trust-dns
库作为 DNS 解析器,并使用 DOH 协议
dns-over-tls
启用 trust-dns
库作为 DNS 解析器,并使用 DOT 协议
代码示例
阻塞代码示例
下载私有空间的对象到指定路径
use qiniu_download_manager::{apis::credential::Credential, DownloadManager, StaticDomainsUrlsGenerator, UrlsSigner};
let bound_domain = "my-domain.com"; // 直接设置绑定的空间域名
let object_name = "test-object";
let download_manager = DownloadManager::new(UrlsSigner::new(
Credential::new("abcdefghklmnopq", "1234567890"),
StaticDomainsUrlsGenerator::builder(bound_domain)
.use_https(false)
.build(), // 设置为 HTTP 协议
));
download_manager
.download(object_name)?
.to_path("/home/qiniu/test.png")?;
异步代码示例
下载私有空间的对象到指定路径
use qiniu_download_manager::{
apis::{credential::Credential, http_client::BucketDomainsQueryer},
DownloadManager, EndpointsUrlGenerator, UrlsSigner,
};
let bucket_name = "test-bucket"; // 查询空间绑定的域名
let object_name = "test-object";
let credential = Credential::new("abcdefghklmnopq", "1234567890");
let download_manager = DownloadManager::new(UrlsSigner::new(
credential.to_owned(),
EndpointsUrlGenerator::builder(BucketDomainsQueryer::new().query(credential, bucket_name))
.use_https(false)
.build(), // 设置为 HTTP 协议
));
download_manager
.async_download(object_name)
.await?
.async_to_path("/home/qiniu/test.png")
.await?;
最低支持的 Rust 版本(MSRV)
1.70.0
联系我们
- 如果需要帮助,请提交工单(在portal右侧点击咨询和建议提交工单,或者直接向 support@qiniu.com 发送邮件)
- 如果有什么问题,可以到问答社区提问,问答社区
- 更详细的文档,见官方文档站
- 如果发现了bug, 欢迎提交 Issue
- 如果有功能需求,欢迎提交 Issue
- 如果要提交代码,欢迎提交 Pull Request
- 欢迎关注我们的微信 微博,及时获取动态信息。
代码许可
This project is licensed under the MIT license.
Dependencies
~14–33MB
~566K SLoC