使用 Play 2.4 配置 Swagger api

Question

在使用 play 2.4 框架配置 swagger api 时遇到问题。

点击此网址进行配置：https://github.com/swagger-api/swagger-play/tree/master/play-2.4/swagger-play2

配置后出现编译时错误消息“类型 ApiHelpController 不是包控制器的成员”，因为此 ApiHelpController.scala 文件存在于 app/controllers 包中。

有谁知道我错过了什么。

Answer 1

不确定您缺少什么，但让我向您展示一个替代 swagger play 2.4 集成的替代方案

与您尝试使用的那个不同，这个不需要注释，您可以直接在路由文件中编写 swagger 规范作为注释。这种方法有几个好处：

1. 控制器保持清洁
2. 不需要重复路径和参数
3. 您无需学习其他 API（注解 API）

它还从案例类反射生成招摇定义。

检查一下： https://github.com/iheartradio/play-swagger

Answer 2

不确定 swagger-jaxrs，但 swagger-play2 包对我有用。可以参考http://swagger.io/playing-with-swagger-using-swagger-and-swagger-ui-with-the-play-framework/