Springdoc-openapi: не отображается правильный тег при инициализации

Я использую springdoc-openapi для создания документации по API и использую $ref для ссылки на внешний файл yaml. Вот моя конфигурация:

tags:
  - name: example
    description: 'Description for Example'
paths:
  /example/{id}/{pathParam2}:
    get:
      $ref: './demo-ten-controller/demoTenMethodFunctionCuaApi.yml'

#demoTenMethodFunctionCuaApi.yml
tags:
  - example
summary: 'Swagger Example'
operationId: 'findPetsByStatus'

Но когда я открываю свой swagger-ui, это неправильные теги, как я хочу:

Swagger-ui

И тогда, когда я нажму, чтобы показать детали API, это будет правильно.

Swagger-ui

Помогите, пожалуйста, исправить тег при инициализации.


openapi swagger springdoc springdoc-openapi-ui
person huynhtamhao    schedule 07.12.2020    source источник
comment
Вы не можете использовать $ref под get/post/и т. д., вы можете использовать только $ref под путями, т.е. под /example/{id}/{pathParam2}. Пример   -  person Helen    schedule 07.12.2020
comment
@Helen Спасибо за вашу поддержку. Я это сделал.   -  person huynhtamhao    schedule 07.12.2020
comment
@huynhtamhao, добавьте код Java, который помог вам сгенерировать эти теги.   -  person brianbro    schedule 23.05.2021