最近遇到了一个下载静态html报表的需求,需要以提供压缩包的形式完成下载功能,实现的过程中发现相关文档非常杂,故总结一下自己的实现。
开发环境:
系统环境:MacOS + Chrome
框架:beego
压缩功能:tar + gzip
目标压缩文件:自带数据和全部包的静态html文件
首先先提一下http server文件下载的实现,其实就是在后端返回前端的数据包中,将数据头设置为下载文件的格式,这样前端收到返回的响应时,会直接触发下载功能(就像时平时我们在chrome中点击下载那样)
数据头设置格式如下:
func (c *Controller)Download() { //...文件信息的产生逻辑 // //rw为responseWriter rw := c.Ctx.ResponseWriter //规定下载后的文件名 rw.Header().Set("Content-Disposition", "attachment; filename="+"(文件名字)") rw.Header().Set("Content-Description", "File Transfer") //标明传输文件类型 //如果是其他类型,请参照:https://www.runoob.com/http/http-content-type.html rw.Header().Set("Content-Type", "application/octet-stream") rw.Header().Set("Content-Transfer-Encoding", "binary") rw.Header().Set("Expires", "0") rw.Header().Set("Cache-Control", "must-revalidate") rw.Header().Set("Pragma", "public") rw.WriteHeader(http.StatusOK) //文件的传输是用byte slice类型,本例子中:b是一个bytes.Buffer,则需调用b.Bytes() http.ServeContent(rw, c.Ctx.Request, "(文件名字)", time.Now(), bytes.NewReader(b.Bytes())) }
这样,beego后端就会将在头部标记为下载文件的数据包发送给前端,前端收到后会自动启动下载功能。
然而这只是最后一步的情况,如何将我们的文件先进行压缩再发送给前端提供下载呢?
如果需要下载的不只一个文件,需要用tar打包,再用gzip进行压缩,实现如下:
//最内层用bytes.Buffer来进行文件的存储 var b bytes.Buffer //嵌套tar包的writter和gzip包的writer gw := gzip.NewWriter(&b) tw := tar.NewWriter(gw) dataFile := //...文件的产生逻辑,dataFile为File类型 info, _ := dataFile.Stat() header, _ := tar.FileInfoHeader(info, "") //下载后当前文件的路径设置 header.Name = "report" + "/" + header.Name err := tw.WriteHeader(header) if err != nil { utils.LogErrorln(err.Error()) return } _, err = io.Copy(tw, dataFile) if err != nil { utils.LogErrorln(err.Error()) } //...可以继续添加文件 //tar writer 和 gzip writer的关闭顺序一定不能反 tw.Close() gw.Close()
最后和中间步骤完成了,我们只剩File文件的产生逻辑了,由于是静态html文件,我们需要把所有html引用的依赖包全部完整的写入到生成的文件中的<script>和<style>标签下。此外,在本例子中,报告部分还需要一些静态的json数据来填充表格和图像,这部分数据是以map存储在内存中的。当然可以先保存成文件再进行上面一步的打包压缩,但是这样会产生并发的问题,因此我们需要先将所有的依赖包文件和数据写入一个byte.Buffer中,最后将这个byte.Buffer转回File格式。
Golang中并没有写好的byte.Buffer转文件的函数可以用,于是我们需要自己实现。
实现如下:
type myFileInfo struct { name string data []byte } func (mif myFileInfo) Name() string { return mif.name } func (mif myFileInfo) Size() int64 { return int64(len(mif.data)) } func (mif myFileInfo) Mode() os.FileMode { return 0444 } // Read for all func (mif myFileInfo) ModTime() time.Time { return time.Time{} } // Return whatever you want func (mif myFileInfo) IsDir() bool { return false } func (mif myFileInfo) Sys() interface{} { return nil } type MyFile struct { *bytes.Reader mif myFileInfo } func (mf *MyFile) Close() error { return nil } // Noop, nothing to do func (mf *MyFile) Readdir(count int) ([]os.FileInfo, error) { return nil, nil // We are not a directory but a single file } func (mf *MyFile) Stat() (os.FileInfo, error) { return mf.mif, nil }
依赖包和数据的写入逻辑:
func testWrite(data map[string]interface{}, taskId string) http.File { //最后生成的html,打开html模版 tempfileP, _ := os.Open("views/traffic/generatePage.html") info, _ := tempfileP.Stat() html := make([]byte, info.Size()) _, err := tempfileP.Read(html) // 将data数据写入html var b bytes.Buffer // 创建Json编码器 encoder := json.NewEncoder(&b) err = encoder.Encode(data) if err != nil { utils.LogErrorln(err.Error()) } // 将json数据添加到html模版中 // 方式为在html模版中插入一个特殊的替换字段,本例中为{Data_Json_Source} html = bytes.Replace(html, []byte("{Data_Json_Source}"), b.Bytes(), 1) // 将静态文件添加进html // 如果是.css,则前后增加<style></style>标签 // 如果是.js,则前后增加<script><script>标签 allStaticFiles := make([][]byte, 0) // jquery 需要最先进行添加 tempfilename := "static/report/jquery.min.js" tempfileP, _ = os.Open(tempfilename) info, _ = os.Stat(tempfilename) curFileByte := make([]byte, info.Size()) _, err = tempfileP.Read(curFileByte) allStaticFiles = append(allStaticFiles, []byte("<script>")) allStaticFiles = append(allStaticFiles, curFileByte) allStaticFiles = append(allStaticFiles, []byte("</script>")) //剩下的所有静态文件 staticFiles, _ := ioutil.ReadDir("static/report/") for _, tempfile := range staticFiles { if tempfile.Name() == "jquery.min.js" { continue } tempfilename := "static/report/" + tempfile.Name() tempfileP, _ := os.Open(tempfilename) info, _ := os.Stat(tempfilename) curFileByte := make([]byte, info.Size()) _, err := tempfileP.Read(curFileByte) if err != nil { utils.LogErrorln(err.Error()) } if isJs, _ := regexp.MatchString(`\.js$`, tempfilename); isJs { allStaticFiles = append(allStaticFiles, []byte("<script>")) allStaticFiles = append(allStaticFiles, curFileByte) allStaticFiles = append(allStaticFiles, []byte("</script>")) } else if isCss, _ := regexp.MatchString(`\.css$`, tempfilename); isCss { allStaticFiles = append(allStaticFiles, []byte("<style>")) allStaticFiles = append(allStaticFiles, curFileByte) allStaticFiles = append(allStaticFiles, []byte("</style>")) } tempfileP.Close() } // 转成http.File格式进行返回 mf := &MyFile{ Reader: bytes.NewReader(html), mif: myFileInfo{ name: "report.html", data: html, }, } var f http.File = mf return f }
OK! 目前为止,后端的文件生成->打包->压缩都已经做好啦,我们把他们串起来:
func (c *Controller)Download() { var b bytes.Buffer gw := gzip.NewWriter(&b) tw := tar.NewWriter(gw) // 生成动态report,并添加进压缩包 // 调用上文中的testWrite方法 dataFile := testWrite(responseByRules, strTaskId) info, _ := dataFile.Stat() header, _ := tar.FileInfoHeader(info, "") header.Name = "report_" + strTaskId + "/" + header.Name err := tw.WriteHeader(header) if err != nil { utils.LogErrorln(err.Error()) return } _, err = io.Copy(tw, dataFile) if err != nil { utils.LogErrorln(err.Error()) } tw.Close() gw.Close() rw := c.Ctx.ResponseWriter rw.Header().Set("Content-Disposition", "attachment; filename="+"report_"+strTaskId+".tar.gz") rw.Header().Set("Content-Description", "File Transfer") rw.Header().Set("Content-Type", "application/octet-stream") rw.Header().Set("Content-Transfer-Encoding", "binary") rw.Header().Set("Expires", "0") rw.Header().Set("Cache-Control", "must-revalidate") rw.Header().Set("Pragma", "public") rw.WriteHeader(http.StatusOK) http.ServeContent(rw, c.Ctx.Request, "report_"+strTaskId+".tar.gz", time.Now(), bytes.NewReader(b.Bytes())) }
后端部分已经全部实现了,前端部分如何接收呢,本例中我做了一个按钮嵌套<a>标签来进行请求:
<a href="/traffic/download_indicator" rel="external nofollow" > <button style="font-family: 'SimHei';font-size: 14px;font-weight: bold;color: #0d6aad;text-decoration: underline;margin-left: 40px;" type="button" class="btn btn-link">下载报表</button> </a>
这样,当前端页面中点击下载报表按钮之后,会自动启动下载,下载我们后端传回的report.tar.gz文件。
《魔兽世界》大逃杀!60人新游玩模式《强袭风暴》3月21日上线
暴雪近日发布了《魔兽世界》10.2.6 更新内容,新游玩模式《强袭风暴》即将于3月21 日在亚服上线,届时玩家将前往阿拉希高地展开一场 60 人大逃杀对战。
艾泽拉斯的冒险者已经征服了艾泽拉斯的大地及遥远的彼岸。他们在对抗世界上最致命的敌人时展现出过人的手腕,并且成功阻止终结宇宙等级的威胁。当他们在为即将于《魔兽世界》资料片《地心之战》中来袭的萨拉塔斯势力做战斗准备时,他们还需要在熟悉的阿拉希高地面对一个全新的敌人──那就是彼此。在《巨龙崛起》10.2.6 更新的《强袭风暴》中,玩家将会进入一个全新的海盗主题大逃杀式限时活动,其中包含极高的风险和史诗级的奖励。
《强袭风暴》不是普通的战场,作为一个独立于主游戏之外的活动,玩家可以用大逃杀的风格来体验《魔兽世界》,不分职业、不分装备(除了你在赛局中捡到的),光是技巧和战略的强弱之分就能决定出谁才是能坚持到最后的赢家。本次活动将会开放单人和双人模式,玩家在加入海盗主题的预赛大厅区域前,可以从强袭风暴角色画面新增好友。游玩游戏将可以累计名望轨迹,《巨龙崛起》和《魔兽世界:巫妖王之怒 经典版》的玩家都可以获得奖励。