Django Rest swagger 文档显示选择文件作为字符串

Question

我正在使用 djangorest 框架 djangorestswagger 创建简单的 swagger 文档。

Python: 3.6
Django: 3.0.3
django-rest-swagger: 2.2.0
djangorestframework: 3.11.0

这是Models.py

class Image(models.Model):
    file = models.ImageField(upload_to='photos', null=True, blank=True)
    is_active = models.BooleanField(default=False, null=True, blank=True)
    created_at = models.DateTimeField(default=timezone.now)

    class Meta:
        db_table = 'image'

    def __str__(self):
        return self.file.name

我创建了serializers.py

class ImageSerializer(serializers.ModelSerializer):

    class Meta:
        model = Image
        fields = ('id', 'file', 'created_at')

这里还有image_view.py

from rest_framework import generics
from rest_framework.parsers import FormParser, MultiPartParser, FileUploadParser

from api.serializers import ImageSerializer
from api.models import Image


class ImageView(generics.CreateAPIView):
    serializer_class = ImageSerializer
    parser_classes = (FileUploadParser, )

    def post(self, request, *args, **kwargs):
        """
           Image Moodel
           ---
           parameters:
               - name: file
                 type: file
           responseMessages:
               - code: 201
                 message: Created
       """
        file = request.data.get('file')
        image = Image(file=file, name=file.name)
        return self.create(request, *args, **kwargs)

图像上传显示为字符串。

如何解决这个问题？

Answer 1

快速查阅 Swagger 文档，看起来这取决于您所针对的 OpenAPI 版本，这是正确的行为。OpenAPI 规范的版本 3 不支持文件类型的概念，而 v2 则支持文件格式的概念。考虑到定义 JSON 的 RFC RFC7159具有有限的被视为有效 JSON 一部分的值类型列表，这是有道理的。

更多信息可以在这里找到

附录：我不能直接谈论您用来生成文档的框架，但对于图像/文件上传，该format属性可用于指定文件的上传方式，即二进制、base64 编码。您可以在此处找到有关文件上传和 OpenAPI 规范的更多信息

查看您的框架文档，它似乎还针对较旧的 Swagger 1.2/OpenAPI v2 规范，在这种情况下，这仍然是正确的行为，如 OpenAPI v2 有关数据类型的详细信息