使用 OpenAPI 定义“DTD”答案

【问题标题】：Defining "DTD" with OpenAPI使用 OpenAPI 定义“DTD”
【发布时间】：2019-03-04 23:40:03
【问题描述】：

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

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

我也考虑过 SWIG，但需要 C++ 实现，并且生成的语言更少。此外，编辑 YAML 比编写自己的 C++ 实现更有吸引力。

对于只为组件使用 OpenAPI 有什么意见吗？非常感谢。

【问题讨论】：

标签： dtd openapi openapi-generator

【解决方案1】：

paths 部分是可选的，因此您可以使用仅包含架构的 OpenAPI 定义。

openapi: 3.0.2
info:
  title: Components
  version: 1.0.0

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

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

【讨论】：

谢谢！现在它验证了。