如何在OpenAPI3 Springboot应用程序中拥有Swagger URL的自定义上下文路径

Question

我在SpringFoot项目中从Springfox迁移到OpenAPI3，因为我们需要使用2.7.0版升级到最新的Springboot，

配置自定义上下文路径

我需要为Dev -dev -href =“ https：// qa） 。 swagger.com/dev/api/myapp/swagger-ui/index.html“ rel =“ nofollow noreferrer”> https://qa.swagger.com/dev/dev/api/myapp/myapp/swagper/swagper/swagger/swagger-ui/index.html

qa- https://qa.swagger.com/api/api/api/ myApp/swagger-ui/index.html

uat- https://uat.swagger.com/api/myapp/swagper/swagger/index.html#/

// pom.xml

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.0</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>

<dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-ui</artifactId>
            <version>1.6.8</version>
        </dependency>

        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-webmvc-core</artifactId>
            <version>1.6.8</version>
        </dependency>

// swaggerconfig class

@Configuration
@Profile({ "local", "dev", "qat", "uat" })
public class SwaggerConfig {

@Bean
    public OpenAPI openAPI() {

        return new OpenAPI().info(info());
    }
    
    private Info info() {
         return new Info()
        .title(title)
        .version(version)
        .license(new License().name(licenseName).url(licenseUrl));
        }
}

//application.properties，

spring.application.name=myApp
server.servlet.context-path=/api/${spring.application.name}

带有上述配置，我能够使用以下URL进行招摇，并从控制器API中获取所有必需的响应 http：// localhost：8082/api/myapp/swagger-ui/index.html＃/

如下

@Component
public class SwaggerListener implements ApplicationListener<ApplicationPreparedEvent> {

    final ApplicationPreparedEvent event = null;

    @Override
    public void onApplicationEvent(final ApplicationPreparedEvent event) {

        ConfigurableEnvironment environment = event.getApplicationContext().getEnvironment();

        Properties properties = new Properties();
        properties.put("springdoc.swagger-ui.path", swaggerPath(event));
        environment.getPropertySources().addFirst(new PropertiesPropertySource("programmatically", properties));

    }

    private String swaggerPath(final ApplicationPreparedEvent event) {
        String basePath = null;
        String swagger = "swagger-ui/index.html";
        ConfigurableEnvironment environment = event.getApplicationContext().getEnvironment();
        String[] profilesList = environment.getActiveProfiles();
        List<String> profiles = Arrays.asList(profilesList);
        String contextPath = environment.getProperty("server.servlet.context-path");
        if (profiles != null && (profiles.contains("local"))) {
            basePath = swagger;
        } else if (profiles != null && profiles.contains("dev")) {
            basePath = "/dev/api/myApp/" + swagger;
        } else if (profiles != null && (profiles.contains("qat") || profiles.contains("uat"))) {
            basePath = "/api/myApp/";

        }
        return basePath;
    }

}

用于为其他环境配置Swagger URL，我尝试创建一个侦听器配置类， 类

@SpringBootApplication(scanBasePackages = { "com.myApp.controller" })
@OpenAPIDefinition
public class myApi {

    public static void main(String[] args) {
        SpringApplication springApplication = new SpringApplication(myApi.class);
        springApplication.addListeners(new SwaggerListener());      
        springApplication.run(args);

    }

}

上述侦听器配置不起作用 谁能在这里帮助我，让我知道我在这里想念什么？

Answer 1

我一直在看一样。该文档对我有帮助：

启用多个OpenAPI定义的支持，一种类型的豆
需要定义groupEdopenapi。

对于以下组定义（基于软件包路径），OpenAPI
描述URL将是：/v3/api-docs/stores

@Bean
public GroupedOpenApi storeOpenApi() {
   String paths[] = {"/store/**"};
   return GroupedOpenApi.builder().group("stores").pathsToMatch(paths)
         .build();
}

对于以下组定义（基于软件包名称），
OpenAPI描述URL将为：/v3/api-docs/users

@Bean
public GroupedOpenApi userOpenApi() {
   String packagesToscan[] = {"test.org.springdoc.api.app68.api.user"};
   return GroupedOpenApi.builder().group("users").packagesToScan(packagesToscan)
         .build();
}

对于以下组定义（基于路径），OpenAPI
描述URL将是：/v3/api-docs/pets

@Bean
public GroupedOpenApi petOpenApi() {
   String paths[] = {"/pet/**"};
   return GroupedOpenApi.builder().group("pets").pathsToMatch(paths)
         .build();
}

对于以下组定义（基于软件包名称和路径），
OpenAPI描述URL将为：/v3/api-docs/groups

@Bean
public GroupedOpenApi groupOpenApi() {
   String paths[] = {"/v1/**"};
   String packagesToscan[] = {"test.org.springdoc.api.app68.api.user", "test.org.springdoc.api.app68.api.store"};
   return GroupedOpenApi.builder().group("groups").pathsToMatch(paths).packagesToScan(packagesToscan)
         .build();
}

来源： sprindoc