Java揮舞着JaxRS拋出錯誤

Question

我遵循了在這里找到的指南： 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>

發現注釋很好，所以我假設P​​OM運行正常

對於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>

但這在我嘗試達到以下目標時會引發錯誤：

本地主機：8080 / {PROJECTNAME} /服務/ API-文檔

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 init參數。

當發生這種情況，我去

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

我沒有錯誤，但是我確實得到了無用的網頁：

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

Answer 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/ exclude-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文檔。