我在这里找到了这个很好的问题/答案,但是没有提到如何让“宠物”类抽象化。
这里的家伙表示这只在3.0规范中是可能的。虽然这里的这个似乎已经在Swagger 2.0中实现了抽象类,并且只是在注释方面遇到了问题。
这在Swagger 2.0规范中是否可能?如果是,我需要在规范中使用哪些标签才能让Swagger 2.0生成抽象父类?
OpenAPI规范(fka Swagger规范)与语言无关,没有抽象类的概念。将模式定义转换为最合适的语言结构取决于工具实现。
例如,工具可以选择将所有“基本”模式作为抽象类处理(如本文所述)。
或者工具可以使用x-
扩展,例如x-抽象
,来指示抽象类:
AbstractClass:
type: object
x-abstract: true # <---
properties:
...
x-抽象
至少支持以下两个工具:
https://github.com/AphelionApps/SwaggerParser
https://github.com/Automatic/Manual
底线:这取决于特定工具如何处理OpenAPI定义。