jersey-2.0 - 使用 swagger 从球衣生成 JSON 定义

Question

我的目标是从我的 Jersey 资源中生成一个像这样的招摇定义。

为了得到这个，我的 pom.xml 看起来像：

 <plugin>
            <groupId>com.github.kongchen</groupId>
            <artifactId>swagger-maven-plugin</artifactId>
            <version>2.3.1</version>
            <configuration>
                <apiSources>
                    <apiSource>
                        <locations>com.rest.resources</locations>
                        <apiVersion>1.0</apiVersion> 
                       <swaggerDirectory>${basedir}/src/main/webapp/docs</swaggerDirectory>
                    </apiSource>
                </apiSources>
            </configuration>
        </plugin>

我也有招摇/球衣依赖：

    <dependency>
        <groupId>com.wordnik</groupId>
        <artifactId>swagger-jaxrs_2.10</artifactId>
        <version>1.3.10</version>
        <scope>compile</scope>
    </dependency>

json 生成良好，但我为我的每个资源获取一个 json 文件，而不是只有一个

我错过了什么

Answer 1

你什么都没有错过，它按预期工作。

即使在您提供的链接中，每个资源也有一个文件。查看这些链接：

http://petstore.swagger.wordnik.com/api/api-docs/pet

http://petstore.swagger.wordnik.com/api/api-docs/user

http://petstore.swagger.wordnik.com/api/api-docs/store