Определение DTD с помощью OpenAPI

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:
      ...