dtd - 使用 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:
      ...