Java 招摇与 JaxRS 抛出错误答案

【问题标题】：Java swagger with JaxRS throwing errorsJava 招摇与 JaxRS 抛出错误
【发布时间】：2014-03-06 17:05:31
【问题描述】：

我按照此处找到的指南进行操作： https://github.com/wordnik/swagger-core/wiki/Java-JAXRS-Quickstart

这是我的 POM：

<!--  SWAGGER -->
<dependency>
  <groupId>com.wordnik</groupId>
  <artifactId>swagger-jersey-jaxrs_2.10</artifactId>
  <version>1.3.0</version>
</dependency>

注释很好，所以我假设 POM 工作正常

对于 WEB.xml，我按照指南尝试了多种操作：

 <servlet>
            <servlet-name>jersey-serlvet</servlet-name>
            <servlet-class>
                com.sun.jersey.spi.spring.container.servlet.SpringServlet
            </servlet-class>
            <init-param>
                <param-name>com.sun.jersey.config.property.packages</param-name>
                <param-value>com.thomsonreuters.ips.service;com.wordnik.swagger.jersey.listing</param-value>
            </init-param>
            <load-on-startup>1</load-on-startup>
        </servlet>
        <servlet-mapping>
            <servlet-name>jersey-serlvet</servlet-name>
            <url-pattern>/service/*</url-pattern>
        </servlet-mapping>

<!-- SWAGGER serverlet? -->
<servlet>
          <servlet-name>JerseyJaxrsConfig</servlet-name>
          <servlet-class>com.wordnik.swagger.jersey.config.JerseyJaxrsConfig</servlet-class>
          <init-param>
            <param-name>api.version</param-name>
            <param-value>1.0.0</param-value>
          </init-param>
          <init-param>
            <param-name>swagger.api.basepath</param-name>
            <param-value>http://localhost:8080/{PROJECTNAME}</param-value>
          </init-param>
          <load-on-startup>2</load-on-startup>
        </servlet>

但是当我尝试到达时这会引发一个疯狂的错误：

localhost:8080/{PROJECTNAME}/service/api-docs

HTTP Status 500 - java.lang.NoSuchMethodError: com.wordnik.swagger.annotations.ApiOperation.authorizations()Ljava/lang/String;

接下来我在googleverse周围看到将web.xml修改为以下内容：

<servlet>
        <servlet-name>jersey-serlvet</servlet-name>
        <servlet-class>
            com.sun.jersey.spi.spring.container.servlet.SpringServlet
        </servlet-class>
         <init-param>
            <param-name>api.version</param-name>
            <param-value>2.0</param-value>
          </init-param>
        <init-param>
            <param-name>com.sun.jersey.config.property.packages</param-name>
            <param-value>com.thomsonreuters.ips.service;com.wordnik.swagger.jaxrs;</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>jersey-serlvet</servlet-name>
        <url-pattern>/service/*</url-pattern>
    </servlet-mapping>

注意 api.version 和新的 jaxrs 初始化参数。

当这种情况发生时，我会去

http://localhost:8080/ScholarlyItemService/service/api-docs

我没有收到任何错误，但我确实得到了无用的网页：

{"apiVersion":"0.0","swaggerVersion":"1.2"}

【问题讨论】：

标签： java maven jersey swagger

【解决方案1】：

我想你几乎拥有它。你看到的不是一个无用的网页，而是swagger构建的你的服务的文档作为json文档。您必须按照快速入门指南中的说明注释您的代码。这应该显示在本文档中。

您可能真正想要的是 Swagger UI：http://swagger.wordnik.com/，以便以可读的方式查看此文档。

我花了一点时间，但我让它运行起来了。您必须从这里下载：https://github.com/wordnik/swagger-ui，然后将 dist 文件夹中的内容复制到您的 /webapp 文件夹。然后，您可以在浏览器中打开包含的 index.html。就我而言，我无法直接访问此文档，因此我必须将 dist 的内容放在子文件夹中（例如 /docs），并将其从 web.xml 中的 servlet 映射中排除，如下所述：http://blog.ericdaugherty.com/2010/02/excluding-content-from-url-pattern-in.html。

在 index.html 中更改 url：“http://petstore.swagger.wordnik.com/api/api-docs”，部分到您的 api 端点 http://localhost:8080/ScholarlyItemService/service/api-docs 并且您将在调用 http://localhost:8080/ScholarlyItemService/docs/index.html 时获得您的 api 文档

【讨论】：