快速使用
下载安装
环境要求
- Golang 版本1.7及1.7以上
SDK下载
- 快速安装:go get github.com/ufilesdk-dev/ufile-gosdk
- 历史版本下载
配置文件
- 进入目录 github.com/ufilesdk-dev/ufile-gosdk 下,按说明填写 config.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"说明1":"管理 bucket 创建和删除必须要公私钥,如果只做文件上传和下载用 TOEKN 就够了,为了安全,强烈建议只使用 TOKEN 做文件管理",
"public_key":"",
"private_key":"",
"说明2":"以下两个参数是用来管理文件用的。对应的是 file.go 里面的接口,file_host 是不带 bucket 名字的。比如:北京地域的host填cn-bj.ufileos.com,而不是填 bucketname.cn-bj.ufileos.com。如果是自定义域名,请直接带上 http 开头的 URL。如:http://example.com,而不是填 example.com。",
"bucket_name":"",
"file_host":"",
"说明3":"以下参数是用来管理 bucket 用的。对应的是 bucket.go 里面的接口。直接填写 api.ucloud.cn 即可",
"bucket_host": "api.ucloud.cn",
"说明4":"verify_upload_md5 用于数据完整性校验,默认不开启,若要开启请置为true",
"verfiy_upload_md5": false
}
文件基本操作
示例程序
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
package main
import (
ufsdk "github.com/ufilesdk-dev/ufile-gosdk"
"log"
"os"
"time"
)
const (
ConfigFile = "./config.json"
FilePath = "test.txt"
KeyName = "test.txt"
MimeType = ".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())
}
// 创建测试文件
f, err := os.OpenFile(FilePath, os.O_RDWR|os.O_CREATE, 0755)
if err != nil {
panic("创建测试文件失败,失败信息为:" + err.Error())
}
defer f.Close()
_, err = f.WriteString("I am a test file!!!")
if err != nil {
panic("创建测试文件失败,失败信息为:" + err.Error())
}
// 上传文件
err = req.PutFile(FilePath, KeyName, MimeType)
if err != nil {
log.Fatalf("%s\n", err.Error())
}
log.Println("文件上传成功!!")
log.Println("公有空间文件下载 URL 是:", req.GetPublicURL(KeyName))
log.Println("私有空间文件下载 URL 是:", req.GetPrivateURL(KeyName, 24*60*60 * time.Second)) //过期时间为一天
// 获取文件的基本信息
err = req.HeadFile(KeyName)
if err != nil {
log.Fatalf("查询文件信息失败,具体错误详情:%s", err.Error())
}
log.Println("查询文件信息成功,文件基本信息:", req.LastResponseHeader)
// 下载文件
err = req.Download(req.GetPrivateURL(KeyName, 24*60*60 * time.Second))
if err != nil {
log.Fatalf("下载文件失败!返回错误信息为:%s", err.Error())
}
log.Println("下载文件成功!数据为:", string(req.LastResponseBody))
// 正在秒传文件
err = req.UploadHit(FilePath, "UploadHit" + KeyName)
if err != nil {
log.Println("文件秒传失败,错误信息为:", err.Error())
} else {
log.Println("秒传文件成功")
}
// 拷贝文件
err = req.Copy("Copy" + KeyName, config.BucketName, KeyName)
if err != nil {
log.Println("文件拷贝失败,错误信息为:", err.Error())
} else {
log.Printf("文件拷贝成功,拷贝文件返回的信息是:%s\n", req.LastResponseBody)
}
// 获取文件列表
list, err := req.PrefixFileList(KeyName, "", 10)
if err != nil {
log.Fatalf("获取文件列表失败,错误信息为:%s", err.Error())
}
log.Printf("获取文件列表返回的信息是:\n%s\n", list)
// 获取目录文件列表
listV2, err := req.ListObjects(KeyName, "", "/", 10)
if err != nil {
log.Fatalf("获取目录文件列表失败,错误信息为:%s", err.Error())
}
log.Printf("获取目录文件列表返回的信息是:\n%s\n", listV2)
// 重命名文件
err = req.Rename(KeyName, "Rename" + KeyName, "true")
if err != nil {
log.Println("文件重命名失败,错误信息为:", err.Error())
} else {
log.Println("文件重命名成功,重命名文件返回的信息是:", req.LastResponseHeader)
}
// 删除文件
err = req.DeleteFile("Rename" + KeyName)
if err != nil {
log.Fatalf("删除文件失败,错误信息为:%s", err.Error())
}
log.Println("删除文件成功")
_ = req.DeleteFile("Copy" + KeyName)
_ = req.DeleteFile("UploadHit" + KeyName)
}