使用swagger从jersey生成JSON定义

时间:2014-11-24 18:41:51

标签: jersey-2.0 swagger swagger-ui swagger-maven-plugin

我的目标是从我的泽西资源中生成一个swagger定义like this

为此,我的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>

我还有swagger / jersey依赖:

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

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

我缺少什么

1 个答案:

答案 0 :(得分:2)

你没有遗漏任何东西,它按预期工作。

即使在您提供的链接中,每个资源都有一个文件。 看看这些链接:

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