本文介绍: 在实际的项目中很多时候需要用到下载功能,如导excelpdf或者文件下载

快速上手Django(九) –django 上传文件request.FILES,下载文件

一、Django下载文件

在实际的项目中很多时候需要用到下载功能,如导excelpdf或者文件下载。

1. Django下载文件方案和思路

  1. 将文件作为响应返回用户:这是最常用的下载文件方法。你可以编写一个视图函数,在该函数中将文件作为响应返回用户
  2. 使用第三方库,如您需要支持断点续传或并发下载等功能,则 djangodownloadview

常见和主流的下载文件方式是将文件作为响应返回给用户。这种方法简单易行,可以在 Django 中轻松实现,并且可用于绝大多数情况。

2. HttpResponse、StreamingHttpResponse和FileResponse区别选择

Django 提供三种方式实现文件下载功能,分别是:HttpResponse、StreamingHttpResponse和FileResponse

HttpResponse 实现文件下载存在很大弊端,其工作原理是将文件读取并载入内存然后输出到浏览器实现下载功能。如果文件较大,该方法就会占用很多内存对于下载大文件,Django推荐使用StreamingHttpResponse 和FileResponse 方法,这两个法将下载文件分批写入服务器本地磁盘,减少对内存的消耗。

StreamingHttpResponse和FileResponse对象的对比和选择

StreamingHttpResponse对象需要一个生成器函数来按需生成发送数据。FileResponse对象支持直接读取文件并以块的形式生成响应数据

由于FileResponse对象使用Python内置的文件迭代器进行分块传输,因此它对文件大小有一定的限制默认情况下为django.http.response.FILE_CHUNK_SIZE配置)。如果您需要传输超过该限制的文件,则需要使用StreamingHttpResponse对象进行流式传输

使用HttpResponse

使用HttpResponse

import os
from django.http import HttpResponse

def download_file(request):
    file_path = '/path/to/my/file.txt'
    if os.path.exists(file_path):
        with open(file_path, 'rb') as f:
            file_data = f.read()
        response = HttpResponse(file_data, content_type='application/octet-stream')
        response['Content-Disposition'] = 'attachment; filename="{}"'.format(os.path.basename(file_path))
        return response
    else:
        return HttpResponse("Sorry, the file you requested does not exist.")

设置content_type和Content-Disposition头文件以指示浏览器将文件作为附件下载。

使用HttpResponse对象读取整个文件并将其存储内存中的字符串,这意味着对于大型文件可能会消耗大量的内存资源。如果您需要下载大文件,可能需要使用其他更高级技术例如流式传输分块下载。

由于本地文件路径可以注入攻击者恶意代码,因此必须小心处理确保仅允许下载特定目录中的文件

总结:下载大文件时,该方法不太适用!

使用StreamingHttpResponse

使用StreamingHttpResponse对象可以解决使用HttpResponse下载大型文件时内存消耗过高的问题。与HttpResponse不同,StreamingHttpResponse不会一次性将整个文件加载到内存中,而是将数据流传输客户端

import os
from django.http import StreamingHttpResponse

def download_file(request):
    file_path = '/path/to/my/file.txt'
    if os.path.exists(file_path):
        def file_iterator(file_path, chunk_size=8192):
            with open(file_path, 'rb') as f:
                while True:
                    chunk = f.read(chunk_size)
                    if not chunk:
                        break
                    yield chunk

            response = StreamingHttpResponse(file_iterator(file_path))
            response['Content-Disposition'] = 'attachment; filename="{}"'.format(os.path.basename(file_path))

            return response
    else:
        return HttpResponse("Sorry, the file you requested does not exist.")

StreamingHttpResponse 支持数据或文件输出,因此在使用时需要设置响应输出类型方式

我们创建一个名为file_iterator的生成器函数,它将文件分成小块(默认大小为8KB)并以流式方式发送给客户端然后我们使用StreamingHttpResponse对象生成响应,并设置content_type和Content-Disposition头文件以指示浏览器将文件作为附件下载。最后我们返回StreamingHttpResponse对象。

生成器函数

生成器是一种特殊类型函数,在Python中通常用于逐步生成数据序列,而不是一次性生成整个序列

生成器函数与普通函数区别在于它们使用yield语句返回值而不是return语句

一个函数执行yield语句时,它会暂停执行并将结果返回给调用者。下次调用该函数时,它会从上次停止的地方继续执行,直到再次遇到yield语句或函数结束为止。这样可以逐步生成数据,并避免一次性加载大量数据到内存中。

def my_generator():
    for i in range(10):
        yield i * 2

for x in my_generator():
    print(x)

在这个例子中,my_generator()是一个生成器函数,它会生成0到18之间的偶数。在主循环中,我们通过迭代生成器来逐步生成数据并打印每个值。

总结生成器函数是一种能够在需要时逐步生成数据的Python函数。当您需要处理大型文件或数据时,生成器函数非常有用,因为它们可以在需要时按块生成数据,并且可以避免一次性加载大量数据到内存中。

使用FileResponse

使用FileResponse对象可以有效地传输大型文件,并且它还提供了自动支持断点续传和范围请求等HTTP协议特性

import os
from django.http import FileResponse

def download_file(request):
    file_path = '/path/to/my/file.txt'
    if os.path.exists(file_path):
        response = FileResponse(open(file_path, 'rb'))
        response['Content-Type'] = "application/octet-stream"
        response['Content-Disposition'] = 'attachment; filename="{}"'.format(os.path.basename(file_path))
        return response
    else:
        return HttpResponse("Sorry, the file you requested does not exist.")

设置content_type和Content-Disposition头文件以指示浏览器将文件作为附件下载。

设置了响应内容的 MIME 媒体类型为 “application/octet-stream”。这是一个用于任意二进制数据的二进制文件格式,并且表示响应内容应该被视为原始字节。它被使用是因为返回作为响应的文件可以是任何类型二进制文件,例如图像文档通过内容类型设置为 “application/octet-stream”,浏览器会提示用户保存打开文件,而不是尝试在浏览器窗口显示

使用FileResponse对象时,Django自动检测客户端是否支持范围请求(即断点续传),如果支持,它将启用自动断点续传功能。这意味着当用户暂停或取消下载时,他们可以在后续下载时从上次停止的地方继续。

django 使用FileResponse限制文件下载大小

思路:在创建 FileResponse 实例设置 content_range 参数

file_path = '/path/to/file'
file_size = os.path.getsize(file_path)
max_size = 10 * 1024 * 1024  # 10 MB

if file_size > max_size:
    content_range = 'bytes=0-{0}'.format(max_size - 1)
else:
    content_range = None

response = FileResponse(open(file_path, 'rb'), content_type='application/octet-stream', content_range=content_range)

在上面的代码中,首先获取文件的大小然后最大大小设置为 10 MB。如果文件大小超过了最大大小,就将 content_range 设置为 ‘bytes=0-{max_size-1}’,表示传输前 10 MB 的数据;否则,将 content_range 设置为 None,表示传输整个文件。

3. postman下载文件请求

在这里插入图片描述

在Postman中,”Send按钮和”Send and Download按钮发送的HTTP请求是相同的,它们只有在处理响应时的行为不同

“Send按钮只会在响应窗格中显示响应内容,而”Send and Download按钮会将响应体直接下载到本地计算机

在Postman中,”Send按钮发送请求并在响应窗口显示响应内容,而”Send and Download按钮发送请求并直接下载响应体(如文件)。

如果您使用”Send按钮发送请求,并且响应内容是文件,则该文件的内容将显示在响应面板中。 如果您希望下载该文件以在本地计算机查看处理它,则可以右键单击响应面板中的文件内容,然后选择“Save Response”选项保存该文件。

相比之下**,如果您使用”Send and Download按钮发送请求,则响应体将直接被下载到您的本地计算机,而不会在响应面板显示。这种方法更适合下载大型文件或二进制数据等非文本数据。**

postman报错 Maximum response size reached

遇到了这个错误

Error: Maximum response size reached

这是因为返回的信息太大了,超过了postman设置,

在这里插入图片描述
如上,我们可以把它设置为0,不限制。

二、django 上传文件request.FILES

Django在上传文件数据时,文件数据会被放置在request.FILES中。

注意:request.FILES只有在请求方法为POST,并且提交请求的具有enctype=”multipart/formdata属性时才有效。否则,request.FILES将为空

request.FILES是一个字典对象,包含所有上传文件,字典的Key是表单类的字段默认Key是”file”。

request_file = request.FILES['file']

从request.FILES拿到文件是
classdjango.core.files.uploadedfile.InMemoryUploadedFile 类的实例InMemoryUploadedFile是一个文件对象的包装。您可以使用InMemoryUploadedFile类的file属性访问文件对象。

file_in_memory # <InMemoryUploadedFile: xxx (xxx/xxx)>
file_object = file_in_memory.file

为了避免read()方法一次性读到内存中造成内存不足的问题,使用f.chunks()方式将文件分块处理

三、Django 读取excel里的数据导入数据库表中(使用第三方库openxl)

从Excel表批量导入数据到Django的数据库中一定要注意2条:

django+xlsxwriter导出excel

Xlsxwriter 使用 FileResponse类返回。

四、参考

Django实现excel导入导出
参考URL: https://blog.csdn.net/inteligent7/article/details/119920673
Django导出Excel文件并下载(前后端)
参考URL: https://www.jianshu.com/p/4d085f2e7a44

原文地址:https://blog.csdn.net/inthat/article/details/130470032

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任

如若转载,请注明出处:http://www.7code.cn/show_21162.html

如若内容造成侵权/违法违规/事实不符,请联系代码007邮箱suwngjj01@126.com进行投诉反馈,一经查实,立即删除

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注