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网址时，它仍会返回相同的内容：

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

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

感谢。

Answer 1

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