java - Swagger如何注释嵌套的REST资源？

我正在使用Jersey 1.x的swagger 1.3.0。我正尝试为我的资源方法添加草率文档，如下所示：

@Api(.....)
class RootResource{

  @GET
  @Path("/")
  @ApiOperation(....)
  @ApiResponse(....)
  public Response get(){} // i am able to get this method's swagger doc

  @Path("/nestedResource")
  public NestedResource getNestedResource(){
    return new NestedResource();
  }

}

class NestedResource{

  @GET
  @ApiOperation(....)
  @ApiResponse(....)
  public Response getNestedResource(){} // i am NOT able to get this method's swagger doc

}

请理解上面的代码只是一个模板，而不是一个完整的工作版本。

请让我知道如何为Nested Resources添加swagger文档。我在这里先向您的帮助表示感谢 ：）

最佳答案

我终于通过注释NestedResource使其工作，如下所示：

 /* Yes,i left the value attribute as blank so that path will be constructed
 as "/NestedResource" */
@Api(basePath="/",value="")
class NestedResource{

    @GET
    @ApiOperation(....)
    @ApiResponse(....)
    public Response getNestedResource(){}

}

关于java - Swagger如何注释嵌套的REST资源？，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/44181308/