文件下载

SDK 提供了普通下载接口Download和流式下载接口DownloadFile。完整代码详见 Github

DownloadDownloadFile方法请求的 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过期