Jersey JAX-RS,swagger-geting Swagger.json生成，但没有UI

Question

我在加载Swagger UI/启用UIendpoint时遇到了一个问题。Maven项目，Jersey版本-2.12，Swagger版本-1.5.1-m2

我有一个通过编程配置的jersey web应用程序。在我的ResourceConfig（扩展）中，我为Swagger设置了以下内容：

    beanConfig = new BeanConfig();
    beanConfig.setVersion("1.0.0");
    beanConfig.setHost("http:localhost:8080");
    beanConfig.setBasePath("/app/v1");
    beanConfig.setResourcePackage("com.app.features");
    beanConfig.setScan(true);
    

    register(beanConfig);

    register(new ApiListingResourceJSON());
    register(new SwaggerSerializers());

public class Bootstrap extends HttpServlet {

  @Override
  public void init(ServletConfig config) throws ServletException {
    Info info = new Info()
            .title("Swagger Sample App")
            .description("Desc")
            .termsOfService("http://helloreverb.com/terms/")
            .contact(new Contact()
                    .email("[e-mail]"))
            .license(new License()
                    .name("Apache 2.0")
                    .url("http://www.apache.org/licenses/LICENSE-2.0.html"));

    ServletContext context = config.getServletContext();
    Swagger swagger = new Swagger().info(info);
    context.setAttribute("swagger", swagger);
  }
}

<welcome-file-list>
    <welcome-file>index.html</welcome-file>
  </welcome-file-list>

  <servlet>
    <servlet-name>Bootstrap</servlet-name>
    <servlet-class>com.app.Bootstrap</servlet-class>
    <load-on-startup>2</load-on-startup>
  </servlet>

我已经将Swagger UI dist的内容复制到我的web应用程序文件夹中。

当我点击http://localhost:8080/app/v1/swagger.json上的api jsonendpoint时，我确实得到了json代码，例如：

{"swagger":"2.0","info":{"version":"1.0.0"},"host":"http:localhost:8080","basePath":"/app/v1"}

但是，我似乎没有在我期望的路径上看到昂首阔步的UI（http://localhost:8080/app/v1或http://localhost:8080/app/v1/app/v1/index.html)。

Answer 1

您需要下载swagger-ui web project，并将其放在web目录中，然后在index.html中配置api地址，

index.html:

  <script type="text/javascript">
    $(function () {
      var url = window.location.search.match(/url=([^&]+)/);
      if (url && url.length > 1) {
        url = decodeURIComponent(url[1]);
      } else {
        url = "http://petstore.swagger.io/v2/swagger.json"; //your api address
      }
      window.swaggerUi = new SwaggerUi({
        url: url,

现在您可以通过访问http://ip:port/path/swagger-ui/index.html来访问swagger-ui。