Swagger REST API注释不是在接口上工作，而是在实现类上工作

Question

这是我的接口ClassA .java

@Path("/"+Paths.STORIES)
@ApiModel(value = "Name API")
@Api(value = "/stories", description = "Name API")
public interface ClassA {
    @GET
    @Path("/"+Paths.STORYID)
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(value = "Fetch Story by ID", notes = "More notes about this method")
    @ApiResponses(value = {
              @ApiResponse(code = 400, message = "Invalid ID supplied"),
              @ApiResponse(code = 200, message = "Invalid ID supplied"),
            })
    public Response getNameFromID(@PathParam("nameId") String nameId);
}

是我的实现类

@Singleton
@Component
public class ClassB implements ClassA,InitializingBean{
    @Override
    @SuppressWarnings({ "unchecked", "rawtypes" })
    public Response getNameFromID(final String nameId) {
        Map NameResponse = new HashMap<String,Object>();
        NameResponse.put("repsonseCode", "200");
        NameResponse.put("errorCode", "");
        return Response.status(200).entity(NameResponse).build();
    }
}

<<p> Application-context.xml条目/strong>

<bean id="swaggerConfig" class="com.wordnik.swagger.jaxrs.config.BeanConfig">
        <property name="resourcePackage" value="com.razak.sample" />
        <property name="version" value="1.0.0" />
        <property name="basePath" value="http://localhost:8080/api" />
        <property name="title" value="Petstore sample app" />
        <property name="description" value="This is a app." />
        <property name="contact" value="[e-mail]" />
        <property name="license" value="Apache 2.0 License" />
        <property name="licenseUrl"
            value="http://www.apache.org/licenses/LICENSE-2.0.html" />
        <property name="scan" value="true" />
    </bean>

web . xml条目

    <param-name>swagger.version</param-name>
    <param-value>1.1</param-value>
</init-param>
<init-param>
    <param-name>swagger.api.basepath</param-name>
    <param-value>http://localhost:8080/api</param-value>
</init-param>
<init-param>
    <param-name>swagger.security.filter</param-name>
    <param-value>com.wordnik.swagger.sample.util.ApiAuthorizationFilterImpl</param-value>
</init-param>

---

@Api(value = "/stories", description = "Story API") at class level and 
    @GET
    @Path("/"+Paths.STORYID)
    @Produces(MediaType.APPLICATION_JSON)
    @ApiOperation(value = "Fetch Story by ID", notes = "More notes about this method")
    @ApiResponses(value = {
              @ApiResponse(code = 400, message = "Invalid ID supplied"),
              @ApiResponse(code = 200, message = "Invalid ID supplied"),
            })

当我将这些条目从接口移动到实现类时。我可以在swagger中访问其他端点。斯威格在工作。但当我把annotation放到接口本身时。

Answer 1

这是一个开放的问题:https://github.com/wordnik/swagger-core/issues/562

关于如何覆盖默认扫描器也有一个开放的问题:https://github.com/wordnik/swagger-core/issues/513

我还没有尝试过，但我认为这两个问题的解决方案都可以在这个解决方案中找到:https://github.com/wordnik/swagger-core/wiki/Java-Setup-for-Spring---Jersey---JAX-RS

技巧是让Swagger使用ReflectiveJaxrsScanner而不是DefaultJaxrsScanner。

Answer 2

在swagger-core-1.3.10中，@Inherited已经被添加到注释中，所以我相信现在可以工作了