# 云开发存储：实现留言本附件上传
## API说明
官方文档：[微信云开发存储文档](https://developers.weixin.qq.com/minigame/dev/wxcloud/reference-http-api/storage/)，主要提供了三个API(上传，下载，删除)，可以先分别看下参数

在这一节中主要利用到了sdk中的附件上传和下载的方法，方法如下：
```go
func (tcb *Tcb) UploadFile(env, path string) (*UploadFileRes, error) {
func (tcb *Tcb) BatchDownloadFile(env string, fileList []*DownloadFile) (*BatchDownloadFileRes, error) {
```

返回对应的返回结果在这里可以查看，[UploadFileRes](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#UploadFileRes)，[BatchDownloadFileRes](https://pkg.go.dev/github.com/silenceper/wechat/tcb?tab=doc#BatchDownloadFileRes)

<a name="264b81c5"></a>
## 接收附件上传内容
1、保存index.html中form表单中使用的是post方法并且enctype为 `multipart/form-data` :

```html
    <form action="/feedback" method="post" enctype="multipart/form-data">
```
2、在main.go中的feedback方法中获取上传的文件

```go
//2、文件上传
	fileHeader, err := c.FormFile("file")
	if err != nil && err != http.ErrMissingFile {
		showError(c, err)
		return
	}
```

<a name="186268da"></a>
## 将附件保存在云开发中
在feedbackService中创建 `UploadFile` 方法，调用sdk中文件上传方法实现对文件的上传：<br />UploadFile 第一个参数为云开发环境，第二个参数为需要附件需要保存的路径
> 注意，这里path应该为相对路径。不能为绝对路径比如 /guestbook 应该为 guestbook 否则会报错。


```go

//UploadFile 上传文件
func (svc *FeedbackService) UploadFile(path string, file io.Reader) (string, error) {
	//获取文件上传链接
	uploadRes, err := getTcb().UploadFile(getConfig().TcbEnv, path)
	if err != nil {
		return "", err
	}

	data := make(map[string]io.Reader)
	data["key"] = strings.NewReader(path)
	data["Signature"] = strings.NewReader(uploadRes.Authorization)
	data["x-cos-security-token"] = strings.NewReader(uploadRes.Token)
	data["x-cos-meta-fileid"] = strings.NewReader(uploadRes.CosFileID)
	data["file"] = file

	//上传文件
	_, err = goutils.PostFormWithFile(&http.Client{}, uploadRes.URL, data)
	return uploadRes.FileID, err
}
```

其中 `PostFormWithFile` 方法是对 `mime/multipart` 方法的一个封装，用于将附件内容上传到指定的url中，在 `github.com/silenceper/goutils` 包中。

并在main.go中feedback方法调用并将返回的field和Filename保存在db中

```go
	//2、文件上传
	fileHeader, err := c.FormFile("file")
	if err != nil && err != http.ErrMissingFile {
		showError(c, err)
		return
	}
	feedbackService := NewFeedbackService()
	if fileHeader != nil {
		path := fmt.Sprintf("guestbook/%s", fileHeader.Filename)
		file, err := fileHeader.Open()
		if err != nil {
			showError(c, err)
			return
		}

		fileID, err := feedbackService.UploadFile(path, file)
		if err != nil {
			showError(c, err)
			return
		}
		feedback.FilePath = fileHeader.Filename
		feedback.FileID = fileID
	}
```

最终附件可以在index方法通过数据库查询在html中展示出来

<a name="786a132e"></a>
## 附件下载
这里创建一个单独的路由，用于对附件进行下载，通过在get参数中传入fileId，定位到附件，并打开附件路径：

```go
	r.GET("/file", downloadFile)
```

```go
//附件下载
func downloadFile(c *gin.Context) {
	fileID := c.Query("id")
	if fileID == "" {
		showError(c, fmt.Errorf("fileID为空"))
		return
	}
	downLoadURL, err := NewFeedbackService().DownloadFile(fileID)
	if err != nil {
		showError(c, err)
		return
	}
	c.Redirect(http.StatusMovedPermanently, downLoadURL)
}
```

在feedbackService中创建DownloadFile方法，返回真实下载路径，并跳转:

```go

//DownloadFile 获取下载链接
func (svc *FeedbackService) DownloadFile(id string) (string, error) {
	files := []*tcb.DownloadFile{&tcb.DownloadFile{
		FileID: id,
		MaxAge: 100,
	}}
	res, err := getTcb().BatchDownloadFile(getConfig().TcbEnv, files)
	if err != nil {
		return "", err
	}
	if len(res.FileList) >= 1 {
		return res.FileList[0].DownloadURL, nil
	}
	return "", nil
}
```

这里BatchDownloadFile方法第一个参数是云开发环境，第二个参数接收的 `tcb.DownloadFile` 数组，指定fileID和下载链接的有效期。

最终完成的效果如下：<br />![image.png](https://cdn.nlark.com/yuque/0/2020/png/748713/1580025839031-8efea9fe-3ce0-4a4b-a8cd-0ad2120c1a9e.png#align=left&display=inline&height=666&name=image.png&originHeight=1332&originWidth=2256&size=112605&status=done&style=none&width=1128)


本文中所有代码都上传在 [https://github.com/go-demo/guestbook](https://github.com/go-demo/guestbook)