Swagger를 사용하는 Jersey Rest API 문서

Question

Swagger를 사용하여 API 문서에서 저지 서비스 메서드 목록을 보려고합니다. GitHub 사이트에서 제공되는 몇 가지 예제/샘플을 살펴 보았습니다. 하지만 여전히 컨텍스트 루트 링크에 ​​액세스하려고 할 때 서비스 방법을 나열 할 수 없습니다. 404 서비스를 찾을 수 없습니다.

의 pom.xml :

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
<groupId>com.danfoss.des</groupId> 
<artifactId>SampleRestProject</artifactId> 
<packaging>war</packaging> 
<version>0.0.1-SNAPSHOT</version> 
<name>SampleRestProject Maven Webapp</name> 
<url>http://maven.apache.org</url> 
<dependencies> 
    <dependency> 
     <groupId>junit</groupId> 
     <artifactId>junit</artifactId> 
     <version>3.8.1</version> 
     <scope>test</scope> 
    </dependency> 
    <dependency> 
     <groupId>com.sun.jersey</groupId> 
     <artifactId>jersey-server</artifactId> 
     <version>1.9</version> 
    </dependency> 
    <dependency> 
     <groupId>com.sun.jersey</groupId> 
     <artifactId>jersey-client</artifactId> 
     <version>1.9</version> 
    </dependency> 
    <dependency> 
     <groupId>com.sun.jersey</groupId> 
     <artifactId>jersey-json</artifactId> 
     <version>1.9</version> 
    </dependency> 
    <dependency> 
     <groupId>io.swagger</groupId> 
     <artifactId>swagger-jersey-jaxrs</artifactId> 
     <version>1.5.0</version> 
    </dependency> 
    <!-- <dependency> 
     <groupId>com.wordnik</groupId> 
     <artifactId>swagger-jaxrs_2.9.1</artifactId> 
     <version>1.2.0</version> 
     <scope>compile</scope> 
    </dependency> --> 
</dependencies> 
<build> 
    <finalName>SampleRestProject</finalName> 
</build> 

web.xml을

<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd" > 

<web-app> 
    <display-name>Archetype Created Web Application</display-name> 

    <servlet> 
     <servlet-name>helloworld</servlet-name> 
     <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class> 
     <init-param> 
      <param-name>com.sun.jersey.config.property.packages</param-name> 
      <param-value>io.swagger.jaxrs.listing,com.danfoss.des</param-value> 
     </init-param> 
     <init-param> 
      <param-name>com.sun.jersey.api.json.POJOMappingFeature</param-name> 
      <param-value>true</param-value> 
     </init-param> 
     <!-- <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:8081/SampleRestProject/</param-value> 
     </init-param> --> 
     <load-on-startup>1</load-on-startup> 
    </servlet> 
    <servlet> 
     <servlet-name>JerseyJaxrsConfig</servlet-name> 
     <servlet-class>io.swagger.jersey.config.JerseyJaxrsConfig</servlet-class> 
     <init-param> 
      <param-name>api.version</param-name> 
      <param-value>1.0</param-value> 
     </init-param> 
     <init-param> 
      <param-name>swagger.api.basepath</param-name> 
      <param-value>http://localhost:8081/SampleRestProject/rest</param-value> 
     </init-param> 
     <load-on-startup>2</load-on-startup> 
    </servlet> 
    <servlet-mapping> 
     <servlet-name>helloworld</servlet-name> 
     <url-pattern>/rest/*</url-pattern> 
    </servlet-mapping> 
    <!-- <welcome-file-list> 
     <welcome-file>index.html</welcome-file> 
    </welcome-file-list> --> 

</web-app> 

서비스 자바 클래스 :

package com.danfoss.des; 

import javax.ws.rs.Consumes; 
import javax.ws.rs.GET; 
import javax.ws.rs.POST; 
import javax.ws.rs.Path; 
import javax.ws.rs.PathParam; 
import javax.ws.rs.Produces; 
import javax.ws.rs.core.MediaType; 
import javax.ws.rs.core.Response; 

import com.danfoss.model.Track; 

import io.swagger.annotations.Api; 
import io.swagger.annotations.ApiOperation; 


@Path("/helloWorld") 
@Api(value="helloWorld", description="Sample hello world swagger service") 
public class RESTfulHelloWorld 
{ 
    @GET 
    @Produces("text/html") 
    @Path("/startingPage") 
    @ApiOperation(value="Starting of the swagger service") 
    public Response getStartingPage() 
    { 
     String output = "Staring method is invoked"; 
     return Response.status(200).entity(output).build(); 
    } 
} 

My Project structure

누군가가 나에게 아무것도를 잃었 경우 정확히 잘못 가거나하고있는 곳을 찾을 수 있도록 도와 주시겠습니까 : 6,

는 링크 목록을 볼에 접근하는 것을 시도하고있다.

Answer 1

JerseyJaxrsConfig 클래스는 swagger-jersey2-jaxrs 라이브러리의 일부이므로, swagger-jersey-jaxrs과 저지 1.9를 조합하여 사용하고 있기 때문에 webapp를 배포 할 때 사용할 수 없습니다 (좋은 방법입니다).

단순히 올바른 구성 클래스를 사용하고 다시 http://localhost:8081/SampleRestProject/rest/swagger.json 접근 시도

<servlet-class>io.swagger.jaxrs.config.DefaultJaxrsConfig</servlet-class>

와

<servlet-class>io.swagger.jaxrs.config.JerseyJaxrsConfig</servlet-class>

를 교체합니다.

또한 Swagger의 기본 경로를 상대 경로로 정의하여 다른 포트에 webapp를 배포 할 수 있습니다.

<init-param> 
    <param-name>swagger.api.basepath</param-name> 
    <param-value>/SampleRestProject/rest</param-value> 
</init-param>