Проблема с созданием документации при использовании повторно используемых перечислений - PullRequest
0 голосов
/ 13 октября 2019

Проблема с созданием документации при использовании повторно используемых перечислений. Мой файл yaml выглядит следующим образом

openapi: 3.0.2 components:   schemas:
    Countries:
      type: string
      enum:
        - Unknown
        - Afghanistan
        - Albania
        - Algeria
        - American Samoa
        - "\u00c5landIslands"
        - NotOtherwiseSpecified

, когда я компилирую его, он правильно создает классы java, однако не создает документацию, а просто даетя:

Страны - и больше ничего не отображается для этой конкретной схемы. Для других схем отображаются опции enum и т. Д. Можете ли вы помочь мне с этой проблемой? Это вопрос чванства или я где-то ошибаюсь. Пример на веб-сайте Swagger и мой код соответствуют тем же правилам: https://swagger.io/docs/specification/data-models/enums/. Я также разместил здесь аналогичный вопрос: https://community.smartbear.com/t5/SwaggerHub/Issue-with-creating-a-documentation-when-using-re-usable-enums/m-p/191938

PS Я думал, что проблема идет из-за специального символа,но это не так. Я пытался без этой конкретной записи enum, а также у меня есть другой похожий способ многократного использования enum, который ведет себя так же.

...