如何使用springfox和JAX-RS重定位swagger-ui.html？

Question

我使用JAX-RS和Spring Boot和springfox从注释生成swagger-ui。

目前这些文档位于http：//localhost:8080/swagger-ui.html

但是，我现在需要将其移动到http://localhost:8080/api/index.html

@Configuration
public class SwaggerUIConfig extends WebMvcConfigurerAdapter {

  @Override
  public void addViewControllers(ViewControllerRegistry registry) {
    registry.addRedirectViewController("/documentation/v2/api-docs", "/v2/api-docs");
    registry.addRedirectViewController("/documentation/configuration/ui", "/configuration/ui");
    registry.addRedirectViewController("/documentation/configuration/security", "/configuration/security");
    registry.addRedirectViewController("/documentation/swagger-resources", "/swagger-resources");
  }

  @Override
  public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry
      .addResourceHandler("/documentation/**")
      .addResourceLocations("classpath:/META-INF/resources/");
  }

}

如果我为文档API找到/替换上面的代码，我就有另一个问题，因为我的servlet已经在/api中定义了。

@SpringBootApplication
@EnableSwagger2
public class SpringApplication extends SpringBootServletInitializer {

  @Bean
  public ServletRegistrationBean api() {
    ServletRegistrationBean registration = new ServletRegistrationBean(new ServletContainer(),"/api/*");
    registration.addInitParameter(ServletProperties.JAXRS_APPLICATION_CLASS, SwaggerResourceConfig.class.getName());
    registration.setName("api");
    return registration;
  }
}

public class SwaggerResourceConfig extends ResourceConfig {

  public SwaggerResourceConfig() {
    register(ApiListingResource.class);
    register(SwaggerSerializers.class);
  }

}

我如何将swagger-ui移动到我的servlet根而不是我的上下文根？

Answer 1

我为你做了变通。首先，我创建了带有方法的控制器，该方法将指向索引。

@Controller
public class SwaggerUIRedirectController {

    @RequestMapping("/index")
    public String uiRedirectLink() {
        return "index";
    }

}

现在创建src/main/resources/templates文件index.html,并将此文件https://github.com/sikynko/swaggerworkaround/blob/master/index.html中的内容复制到您的文件中。

现在在src/main/resources/statig/springfox.js下创建并从

var urlMatches = /(.*)\/swagger-ui.html.*/.exec(window.location.href);

var urlMatches = /(.*)\/(.*).*/.exec(window.location.href);