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可以记录它。