spring - 在 Spring Boot 中更改 swagger ui 基本路径

Question

在我的 Spring Boot 应用程序中，我使用了 swagger用于文档。我需要更改默认值 http://localhost:8080/swagger-ui.html路径 http://localhost:8080/docs/swagger-ui.html因为我有以下 Controller 与默认的 swagger-ui 路径冲突。

 @RequestMapping("/{coll}")
    public List<Map> getData(@PathVariable String coll){

        ....
        return list;
 }

我搜索了很多资源(例如: https://github.com/springfox/springfox/issues/1443 )并提出了很多解决方案，但没有对我有用。由于这是 Swagger 中非常基本的要求，因此更改 swagger-ui.html 的最佳方法是什么？自定义路径的默认路径？

Answer 1

您可以使用以下代码更改它。 备注 我正在使用 Apache CXF。所以如果你是 Jersey ，请相应地进行更改。基本上，您需要在配置中设置 basePath 和 Host。

        @Bean
        public Server rsServer() {
            JAXRSServerFactoryBean endpoint = new JAXRSServerFactoryBean();
            endpoint.setBus(bus);
            endpoint.setAddress("/gbservice");
            endpoint.setServiceBeans(Arrays.<Object>asList(new HelloResourceImpl()));
            endpoint.setFeatures(Arrays.asList(swagger2Feature()));
            endpoint.setProvider(jsonProvider());
            return endpoint.create();
        }
        @Bean("swagger2Feature")
        public Feature swagger2Feature() {
            Swagger2Feature result = new Swagger2Feature();
            result.setTitle("Spring Boot + CXF + Swagger Example");
            result.setDescription("Spring Boot + CXF + Swagger Example description");
            result.setBasePath("/gb");
            result.setHost("http://localhost:8080/");
            result.setVersion("v1");
            result.setContact("Gaurao Burghate");
            result.setSchemes(new String[] { "http", "https" });
            result.setPrettyPrint(true);
            return result;
        }

所以早些时候我的网址是 http://localhost:8080/services/swagger.json ，更改以上配置后，URL变为 http://localhost:8080/services/gb/swagger.json

备注 您必须需要配置主机，而且您的上下文根不应为空。