快速使用

快速使用

下载安装

环境要求

  • Golang 版本1.7及1.7以上

SDK下载

配置文件

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)
}