如何使用openapi ui和承载令牌（jwt）在swagger ui中激活授权按钮？

Question

我的任务是在swagger-ui站点中启用授权按钮。我做了REST-Controller的留档，带有来自springdoc-openapi-ui-依赖项的@操作或@Api响应等注释。现在我应该在昂首阔步的表面启用授权按钮。

我有以下介绍：https://www.baeldung.com/spring-boot-swagger-jwt但在这里我必须包括springfox到我的maven依赖，但当我这样做，我得到遵循例外：

17.11.2020 19:15:46,664 ERROR [o.s.boot.SpringApplication] (main) Application run 
failed
java.lang.NoClassDefFoundError: org/springframework/data/rest/webmvc/mapping/Associations
at java.base/java.lang.Class.getDeclaredConstructors0(Native Method)
at java.base/java.lang.Class.privateGetDeclaredConstructors(Class.java:3137)
at java.base/java.lang.Class.getDeclaredConstructors(Class.java:2357)
(....)

另外，介绍中使用了apikey，但我们在应用程序中不使用apikey，我不知道如何使用它们。

然后，我发现了以下问题，这似乎是我的问题：springdoc openapi ui中用于承载令牌身份验证（JWT）的启用授权按钮

因此，我实现了上面答案中的代码：

import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.util.StringUtils;

@Configuration
public class OpenApiConfiguration {

  private final String moduleName;
  private final String apiVersion;

  public OpenApiConfiguration(
      @Value("${module-name}") String moduleName,
      @Value("${api-version}") String apiVersion) {
    this.moduleName = moduleName;
    this.apiVersion = apiVersion;
  }

  @Bean
  public OpenAPI customOpenAPI() {
    final String securitySchemeName = "bearerAuth";
    final String apiTitle = String.format("%s API", StringUtils.capitalize(moduleName));

    return new OpenAPI().addSecurityItem(new SecurityRequirement().addList(securitySchemeName))
        .components(new Components().addSecuritySchemes(securitySchemeName,
            new SecurityScheme().name(securitySchemeName)
                .type(SecurityScheme.Type.HTTP)
                .scheme("bearer")
                .bearerFormat("JWT")))
        .info(new Info().title(apiTitle)
            .version(apiVersion));
  }

}

但我得到了以下例外：

17.11.2020 19:21:00,215 ERROR [o.s.boot.SpringApplication] (main) Application run failed
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'openApiConfiguration' defined in file [<PATH>/configuration/OpenApiConfiguration.class]: Unexpected exception during bean creation; nested exception is java.lang.IllegalArgumentException: Could not resolve placeholder 'module-name' in value "${module-name}"
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:530)
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:323)
(....)

有人能解释一下占位符和@Value是如何工作的吗？也许有人有更好的方法解决我的问题？我对这个话题很陌生

最好的问候和抱歉我的英语不好

可爱的猫

Answer 1

关于问题：无法解决占位符'模块名称'中的值"${模块名称}"

也许我误解了这个问题，但这不只是缺少该配置的值吗？它的工作原理，如果你只是使用字符串常量？

尝试在类路径上添加一个属性文件 /yaml这两个属性，它应该可以工作：模块名称=xxx api-version=xxx