java - 如何将Swagger相关的静态文件添加到Spring Boot + Jersey应用程序中？

Question

我正在尝试将 Swagger 支持添加到我的 REST API，但我很困惑如何将 Swagger 相关的静态内容(HTML、JS)文件添加到我的 Spring Boot 应用程序中。

我使用以下依赖项:

• spring-boot-starter-parent:2.0.1.RELEASE
• spring-boot-starter-jersey:2.0.1.RELEASE
• swagger-jersey2-jaxrs:1.5.18

这是我的 Swagger 配置:

@Configuration
public class SwaggerConfig {
    @Bean
    public BeanConfig swaggerConfiguration() {
        final BeanConfig beanConfig = new BeanConfig();
        beanConfig.setResourcePackage("a.b.c");
        beanConfig.setScan(true);
        beanConfig.setPrettyPrint(true);
        return beanConfig;
    }
}

Jersey 配置:

@Component
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        register(ImageResource.class);
        register(io.swagger.jaxrs.listing.ApiListingResource.class);
        register(io.swagger.jaxrs.listing.SwaggerSerializers.class);
    }
}

当我打开 http://localhost:8090/swagger.json 时，这部分就像魅力一样。然后我就可以看到预期的 Swagger JSON 内容。

但我不知道如何将 Swagger 相关的静态 HTML 内容添加到我的应用程序中。我可以看到此内容位于 springfox-swagger-ui.jar 中，我可以将其作为 Maven 依赖项添加到我的项目中，但如何从该 jar 中解压内容？

用静态 Swagger 文件中的 URL 覆盖默认 swagger.json URL 的正确方法是什么，以便在我打开 swagger-ui.html 时 Swagger 立即显示我的 REST API。

Answer 1

<dependency>
  <groupId>org.webjars</groupId>
  <artifactId>swagger-ui</artifactId>
  <version>${swagger-ui.version}</version>
</dependency>

请不要包含 springfox-swagger-ui.jar，它旨在与 Spring 的 RestController 配合使用。