Django 如何使用 Django Rest API 上传文件

在本文中，我们将介绍如何使用 Django Rest API 实现文件上传功能。Django Rest Framework 是一个强大的工具集，可以帮助我们轻松地构建 Web API。文件上传是一个常见的功能需求，我们将使用 Django Rest Framework 提供的功能来实现这个功能。

阅读更多：Django 教程

创建 Django 项目和应用

首先，我们需要创建一个 Django 项目和应用。打开终端，执行以下命令：

$ django-admin startproject file_upload
$ cd file_upload
$ python manage.py startapp api

这样我们就创建了一个名为 file_upload 的项目，并在项目中创建了一个名为 api 的应用。

配置 Django Rest Framework

接下来，我们需要配置 Django Rest Framework。打开 settings.py 文件，在 INSTALLED_APPS 中添加以下应用：

INSTALLED_APPS = [
    ...
    'rest_framework',
    'api',
]

然后，在 urls.py 文件中添加以下代码：

from django.urls import path, include

urlpatterns = [
    ...
    path('api/', include('api.urls')),
]

这样我们就配置好了 Django Rest Framework。

创建文件上传 API

在 api 应用的文件夹中，创建一个名为 urls.py 的文件，并添加以下代码：

from django.urls import path
from .views import FileUploadView

urlpatterns = [
    path('upload/', FileUploadView.as_view(), name='upload'),
]

然后，在 api 应用的文件夹中创建一个名为 views.py 的文件，并添加以下代码：

from rest_framework.views import APIView
from rest_framework.parsers import MultiPartParser
from rest_framework.response import Response

class FileUploadView(APIView):
    parser_classes = [MultiPartParser]

    def post(self, request, format=None):
        file_obj = request.FILES['file']
        # 处理文件上传逻辑
        return Response({'message': '文件上传成功'})

在这段代码中，我们创建了一个名为 FileUploadView 的类视图，继承自 APIView。我们使用 MultiPartParser 解析请求数据，确保可以处理包含文件的请求。在 post 方法中，我们通过 request.FILES 获取到上传的文件对象 file_obj。然后，我们可以根据需要处理文件上传的逻辑，并返回上传成功的消息。

测试文件上传 API

现在，我们已经完成了文件上传 API 的开发。我们可以启动开发服务器，并使用工具（如 Postman）测试 API 是否正常工作。

执行以下命令启动开发服务器：

$ python manage.py runserver

然后，使用工具发起一个 POST 请求到 http://localhost:8000/api/upload/，并选择一个文件进行上传。如果一切正常，你将会收到一个响应，内容为 {"message": "文件上传成功"}。

总结

在本文中，我们介绍了如何使用 Django Rest API 实现文件上传功能。我们首先创建了一个 Django 项目和应用，然后配置了 Django Rest Framework。接着，我们创建了一个文件上传 API，并使用 MultiPartParser 来处理包含文件的请求。最后，我们测试了文件上传 API 是否正常工作。使用 Django Rest Framework，我们可以轻松地实现文件上传功能，并提供强大的 API 接口用于文件管理。