Gin框架文件下载的两种方式

好奇的菜鸟

于 2024-09-04 09:20:33 发布

阅读量241

点赞数 9

分类专栏： Gin 文章标签： gin

本文链接：https://blog.csdn.net/qq_29752857/article/details/141884071

版权

Gin 专栏收录该内容

13 篇文章 0 订阅

订阅专栏

Gin是一个用Go（Golang）编写的Web框架，以其高性能和简洁的API而闻名。在Web开发中，文件下载是一个常见需求。Gin框架提供了两种主要的方式来处理文件下载：直接响应文件和前后端分离模式下的文件下载。下面将详细介绍这两种方式。

1. 直接响应文件

在这种方式下，后端直接处理文件下载请求，设置响应头，使得浏览器能够识别并触发下载行为。

设置响应头

为了确保浏览器将响应作为文件下载而不是直接显示，我们需要设置一些特定的响应头：

Content-Type 设置为 application/octet-stream，这告诉浏览器这是一个二进制文件流。
Content-Disposition 设置为 attachment; filename="文件名"，这指定了下载文件的默认文件名。
Content-Transfer-Encoding 设置为 binary，这确保了文件在传输过程中不会因编码问题而损坏。

示例代码

package main

import (
	"github.com/gin-gonic/gin"
	"net/url"
)

func main() {
	router := gin.Default()

	router.GET("download", func(c *gin.Context) {
		c.Header("Content-Type", "application/octet-stream")
		c.Header("Content-Disposition", "attachment; filename="+url.QueryEscape("demo01.png"))
		c.Header("Content-Transfer-Encoding", "binary")
		c.File("./static/demo01.png")
	})
	router.Run(":8080")
}

注意事项

文件下载时，浏览器可能会使用缓存，这可能会导致用户下载的是旧版本的文件。可以通过设置合适的缓存策略来解决这个问题。
文件名需要进行URL编码，以避免特殊字符导致的问题。

2. 前后端分离模式下的文件下载

在前后端分离的架构中，后端通常只负责提供文件数据，而前端负责触发下载行为。

后端设置

后端需要将文件数据作为响应体发送，并在响应头中包含文件名和其他相关信息。

func downloadFile(c *gin.Context) {
    c.Header("fileName", "xxx.png")
    c.Header("msg", "文件下载成功")
    c.File("uploads/12.png")
}

前端处理

前端通过发送请求到后端获取文件数据，然后使用JavaScript创建一个下载链接并触发点击事件来实现下载。

async function downloadFile(row) {
    const response = await this.$http({
        method: 'post',
        url: 'file/upload',
        data: postData,
        responseType: 'blob'
    });
    const res = response.data;
    let blob = new Blob([res], { type: 'application/png' });
    let downloadElement = document.createElement("a");
    let href = window.URL.createObjectURL(blob);
    downloadElement.href = href;
    downloadElement.download = response.headers["fileName"];
    document.body.appendChild(downloadElement);
    downloadElement.click();
    document.body.removeChild(downloadElement);
    window.URL.revokeObjectURL(href);
}