java - swagger-codegen 缺少简单模型

Question

我正在使用 swagger/swagger-codegen 实现我的第二个 API。在有了第一个良好的开端之后，我有点陷入以下问题:我有多个定义，如下所示:

TopIssueReference:
  description: Id of a top issue
  type: string
  example:
    itemid: 'd32c1213-4773-442e-9c5f-f5d516358869'

所有这些定义都只是字符串类型的别名，有些具有日期时间格式，有些像上面的那样赤裸裸。

swagger 编辑器可以很好地处理这些定义。

当我在某个对象定义的 $ref 子句中使用其中之一时，生成器会生成对名称与我的定义类似的类的引用，在本例中为 TopIssueReference。

生成的 TopIssueReference 类如下(在 java 中):

@ApiModel(description = "Id of a top issue")
public class TopIssueReference  {
  @Override
  public String toString()  {
    StringBuilder sb = new StringBuilder();
    sb.append("class TopIssueReference {");
    sb.append("}");
    return sb.toString();
  }
}

这并不是真正有用。

有人知道这里出了什么问题吗？生成器是否应该生成对字符串的引用，或者至少使 TopIssueReference 从字符串派生(无论这可能有用)？

对于其中一些定义，生成器根本不生成任何类 - 但引用仍然存在，因此生成的代码甚至无法编译。

我尝试使用 java 和 python 生成服务器和客户端，两者都遇到相同的问题。

Answer 1

尝试在您的 swagger 文件中添加以下代码来生成代码。

TopIssueReference:
    description: Id of a top issue
    type: object
    properties:
      itemid:
        type: string

我希望它对你有用......!