Какова цель Springdoc.group-configs[_].display-name, если вместо этого пользовательский интерфейс Swagger получает отобр ⇐ JAVA

[Anonymous]

Я пытаюсь понять связь между группами и URL-адресами в Springdoc.
Например, у нас может быть следующая конфигурация Springdoc:

Код: Выделить всё

springdoc.swagger-ui.urls[0].url=${springdoc.swagger-ui.url}/myapp-api.yaml
springdoc.swagger-ui.urls[0].name=randomName
springdoc.group-configs[0].display-name=MyApp API
springdoc.group-configs[0].group=myapp-api.yaml
springdoc.group-configs[0].paths-to-match=${paths.to.match}

Я не понимаю назначения Springdoc.group-configs[0].display-name, если он нигде не используется. Где оно должно отображаться? В пользовательском интерфейсе этим управляет другое свойство. В частности, объекты SwaggerUrl используются для создания displayName группы в пользовательском интерфейсе. Следующий отрывок из AbstractSwaggerUiConfigProperties иллюстрирует это:

Код: Выделить всё

public SwaggerUrl(String group, String url, String displayName) {
Objects.requireNonNull(group, GROUP_NAME_NOT_NULL);
this.url = url;
this.name = group;
this.displayName = StringUtils.defaultIfEmpty(displayName, this.name);
}

В результате окончательное отображаемое имя — это просто имя URL-адреса («randomName» вместо «MyApp API»), то есть Springdoc.swagger-ui.urls[0].name, если не установлено общее отображаемое имя для всех URL-адресов. Такое поведение кажется необычным, поскольку для всех URL-адресов существует только одно свойство displayName, что означает, что его нельзя настроить индивидуально для каждого из них.
Итак, какова цель свойства Springdoc.group-configs[0].display-name и где оно на самом деле используется или отображается, учитывая, что пользовательский интерфейс Swagger вместо этого получает отображаемое имя группы из конфигурации SwaggerUrl?
В более общем плане, какова связь между URL-адреса и группы?

Подробнее здесь: https://stackoverflow.com/questions/799 ... ger-ui-der