9

我正在使用 django、django drf 和 drf-yasg 来生成编写我的 BE 并生成文档。

我有一个名为 User 的模型和一个用于用户的序列化程序：

class UserSerializer(serializers.ModelSerializer):

    class Meta:
        model = users_models.User
        fields = (users_models.User.first_name.field_name,
                  users_models.User.last_name.field_name,)

我有一些方法 Foo 可以获得两个用户。这是请求的序列化程序的样子：

class FooRequestSerializer(serializers.ModelSerializer):
      first_user = UserSerializer(help_text="first user")
      second_user = UserSerializer(help_text="second user")

当我为此生成一个swagger json方案时，我查看了json和redoc，我看到了：

  1. first_user 和 second_user 具有相同的引用名称 ($ref)
  2. second_user 和 redoc 的描述为“第一个用户”而不是第二个用户。这是因为描述取自具有第一个用户描述的 $ref。

我注意到，如果我确保引用名称是不同的，那么 redoc 就可以很好地读取，因为 first_user 和 second_user 得到了他们自己的描述。问题来了，因为我还希望以后能够使用 swagger codegen 创建 Java 存根，所以解决方案和据我所知，每个不同的 ref 名称都有一个不同的类。理想情况下，我会看到对 foo 的调用类似于

Foo(User first_user, User second_user)

这让我想到了一个问题：

  • 如果 first_user 和 second_user 具有相同的 ref 名称，则 redoc 读取错误并且第二个用户具有第一个用户描述。

  • 如果 first_user 和 second_user 具有不同的引用名称，那么 redoc 可以工作，但我会生成两个不同的类，比如

    Foo(FirstUser first_user, SecondUser second_user)

我需要做什么才能使重做和生成的类都按预期工作？

4

1 回答 1

11

根据此处的 drf-yasg 文档，您可以在序列化程序的 Meta 类中指定 ref_name。因此，这样的事情应该可以工作（虽然不是很干净的解决方案）：

class UserSerializer(serializers.ModelSerializer):

    class Meta:
        model = users_models.User
        fields = (users_models.User.first_name.field_name,
                  users_models.User.last_name.field_name,)


class FirstUserSerializer(UserSerializer):
    class Meta:
        ref_name = "User 1"


class SecondUserSerializer(UserSerializer):
    class Meta:
        ref_name = "User 2"


class FooRequestSerializer(serializers.ModelSerializer):
      first_user = FirstUserSerializer(help_text="first user")
      second_user = SecondUserSerializer(help_text="second user")
于 2020-01-23T19:21:20.720 回答