SDK 提供了普通下载接口Download
和流式下载接口DownloadFile
。完整代码详见 Github。
Download
与DownloadFile
方法请求的 US3 API 均为 GetFile,具体详见GetFile API文档。
普通下载
Download 要求传入文件的下载URL,然后把文件下载到 HTTP Body 里面,适用于下载小文件。
示例如下
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
package main
import (
ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
"log"
"os"
"time"
)
const (
ConfigFile = "config.json"
KeyName = "FakeSmallFile.txt"
FilePath = "DlFakeSmallFile.txt"
)
func main() {
// 加载配置,创建请求
config, err := ufsdk.LoadConfig(ConfigFile)
if err != nil {
panic(err.Error())
}
req, err := ufsdk.NewFileRequest(config, nil)
if err != nil {
panic(err.Error())
}
// 可以通过 GetPrivateURL 获取下载URL,第二个参数为URL有效时间
reqUrl := req.GetPrivateURL(KeyName, 3600*time.Second)
// Download 要求传入文件下载URL,文件下载数据存储在 req.LastResponseBody 中
err = req.Download(reqUrl)
if err != nil {
log.Fatalf("下载文件失败!返回错误信息为:%s", err.Error())
}
log.Printf("下载文件成功!数据为:%s", string(req.LastResponseBody))
// 保存到本地文件
file, err := os.OpenFile(FilePath, os.O_CREATE|os.O_WRONLY, 0755)
if err != nil {
log.Fatalf("创建文件失败,错误信息为:%s", err.Error())
}
_, _ = file.WriteString(string(req.LastResponseBody))
_ = file.Close()
}
流式下载
DownloadFile 要求传入一个 io.Writer 接口和KeyName,然后把文件下载到 Writer 里面,适用于下载大文件。
示例如下
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
package main
import (
"bytes"
ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
"log"
"os"
)
const (
ConfigFile = "config.json"
KeyName = "FakeBigFile.txt"
FilePath = "FakeBigFile.txt"
)
func main() {
// 加载配置,创建请求
config, err := ufsdk.LoadConfig(ConfigFile)
if err != nil {
panic(err.Error())
}
req, err := ufsdk.NewFileRequest(config, nil)
if err != nil {
panic(err.Error())
}
// 下载到缓存
var buf bytes.Buffer
err = req.DownloadFile(&buf, KeyName)
if err != nil {
log.Fatalf("流式下载到缓存出错,出错信息为:%s", err.Error())
}
log.Printf("流式下载到缓存成功!数据为:%s", buf.String())
// 下载到本地文件
file, err := os.OpenFile(FilePath, os.O_CREATE|os.O_WRONLY, 0755)
if err != nil {
log.Fatalf("创建文件失败,错误信息为:%s", err.Error())
}
err = req.DownloadFile(file, KeyName)
if err != nil {
log.Fatalf("流式下载到本地文件出错,错误信息为:%s", err.Error())
}
defer file.Close()
log.Printf("流式下载到本地文件成功!")
}
错误码
HTTP 状态码 | RetCode | ErrMsg | 描述 |
---|---|---|---|
400 | -148653 | bucket not exists | 存储空间不存在 |
400 | -15036 | check md5 failed | MD5校验失败 |
401 | -148643 | no authorization found | 上传凭证错误 |
403 | -148643 | invalid signature | API公私钥错误 |
404 | -148654 | file not exist | 文件不存在 |
401 | -148660 | request expired | 下载URL过期 |