2016-05-24 9 views
0

Ich habe die Swagger-Dokumentation durchgelesen und entsprechend der Dokumentation konfiguriert.swagger.json wird nicht in Jersey + Spring + Tomcat Umgebung generiert

Wenn ich http://localhost:8080/rest/api-docs Seite anfordern, Swagger zeigt alle Informationen korrekt, aber es swagger.json nicht erzeugen, so http://localhost:8080/rest/swagger.json kehrt 404.

Mein Endpunkt http://localhost:8080/rest/test auch funktioniert.

Hier ist meine web.xml:

<web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> 
<listener> 
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> 
</listener> 

<servlet> 
    <servlet-name>jersey</servlet-name> 
    <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class> 
    <init-param> 
     <param-name>javax.ws.rs.Application</param-name> 
     <param-value>com.test.JerseyConfig</param-value> 
    </init-param> 
    <load-on-startup>1</load-on-startup> 
</servlet> 
<servlet-mapping> 
    <servlet-name>jersey</servlet-name> 
    <url-pattern>/*</url-pattern> 
</servlet-mapping> 

<!-- Swagger Config --> 
<servlet> 
    <servlet-name>Jersey2Config</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/rest/</param-value> 
    </init-param> 
    <load-on-startup>2</load-on-startup> 
</servlet> 

JerseyConfig Klasse:

public class JerseyConfig extends ResourceConfig { 
    public JerseyConfig() { 
     register(Test.class); 
     //.... 
     // Swagger 
     register(com.wordnik.swagger.jersey.listing.ApiListingResource.class); 
     register(com.wordnik.swagger.jersey.listing.ApiListingResourceJSON.class); 
     register(com.wordnik.swagger.jersey.listing.JerseyApiDeclarationProvider.class); 
     register(com.wordnik.swagger.jersey.listing.JerseyResourceListingProvider.class); 
    } 
} 

Test.class ein einfacher Endpunkt ist, mit Anmerkungen versehen mit Swagger @Api.

@Path("/test") 
@Api(value = "/test", description = "tttttt") 
public class TestResource { 

    @GET 
    @ApiOperation(value = "Checks server") 
    @ApiResponses(@ApiResponse(code = 200, message = "Server is available")) 
    public Response check() { 
     return Response.ok().build(); 
    } 
} 

Die App wird in Tomcat bereitgestellt.


Nach Jersey ResourceModel, die nur von Swagger erstellt Endpunkte sind:

GET  /api-docs 
    GET  /api-docs/{route: .+} 

Antwort

0

Die swagger.json Lage ist die empfohlene Position für die Prahlerei Definition, es ist jedoch nicht der nur Ort es sein kann, erzeugt. Bitte versuchen Sie es mit dem api-docs Standort in Ihrem Swagger-Ui und es sollte gut funktionieren.