Swagger 没有生成 @Api 资源

Question

我正在尝试集成 Swagger 来记录我的 REST API。我已逐字阅读本教程：http://jakubstas.com/spring-jersey-swagger-configuration/，它可以正常工作。我明白了：

{
    apiVersion: "1.0",
    swaggerVersion: "1.2"
}

现在，我想注册一个端点：

@Path("endpoint")
@Api(value = "/endpoint", description = "My first documented endpoint")
public class MyEndpoint {
  //METHODS
}

但是当我导航到api-doc URL 时，它仍然返回相同的：

{
    apiVersion: "1.0",
    swaggerVersion: "1.2"
}

我的端点资源位于正确的包中。我做错了什么？

谢谢。

Answer 1

解决了。我在我的@GET 方法上添加了一个@ApiOperation，它现在正在工作。至少需要一个操作，以便 Swagger 可以记录它。