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 时，它仍然 returns 相同：

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

我的端点资源在正确的包内。我做错了什么？

谢谢。

Answer 1

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

Swagger is not generating @Api resources