使用OpenAPI定义“DTD”

Question

我想定义一个模式，并能够生成存根来解析它。我正在研究OpenAPI和Swagger Codegen。我前段时间写了一个测试XSD并为它生成了Java绑定。这个模式只是一些POJO。我用其他工具知道其他语言，但它没有Swagger Codegen那么广泛。

我已经将OpenAPI用于其他项目。对于这种情况，我不需要定义服务，只需要定义组件。我的想法是为每个未来版本提供一个模式，并从中生成存根。

我也考虑过SWIG，但是需要一个C ++实现，它会产生更少的语言。此外，编辑YAML比编写自己的C ++实现更具吸引力。

关于仅为组件使用OpenAPI的任何意见？非常感谢。

Answer 1

paths部分是可选的，因此您可以使用只有模式的OpenAPI定义。

openapi: 3.0.2
info:
  title: Components
  version: 1.0.0

paths: {}  # <--- No endpoint definitions

components:
  schemas:
    Schema1:
      ...
    Schema2:
      ...