我正在用swagger/swagger-codegen实现我的第二个API。在第一次有了一个非常好的开始之后,我有点陷入了以下问题:我有多种定义,如下所示:
TopIssueReference:
description: Id of a top issue
type: string
example:
itemid: 'd32c1213-4773-442e-9c5f-f5d516358869'
所有这些定义只是字符串类型的别名,有些是日期-时间格式的,有些是裸的,就像上面的那个。
招摇过市的编辑对这些定义很满意。
当我在某个对象定义中的$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生成服务器和客户端,但两者都有相同的问题。
尝试将Bellow代码添加到您的swagger文件中以生成代码。
TopIssueReference:
description: Id of a top issue
type: object
properties:
itemid:
type: string
我希望它对你有用。。。!