Grails 2:是否可以使用摇摇欲坠来记录API?

时间:2018-10-22 19:54:11

标签: grails swagger grails-2.0

我正在尝试创建一个原型(使用Grails 2),在该原型中我们大胆地使用了文档。

因此,我在我们的BuildConfig.groovy中添加了以下内容:

compile "io.swagger:swagger-core:1.5.3"
compile "io.swagger:swagger-jaxrs:1.5.3"  

然后我使用上述依赖项提供的resources.groovy类在BeanConfig中声明了一个bean。最后,我刚刚使用了jaxrs依赖项提供的各种注释来记录控制器及其方法。

一切都很棒,直到我意识到这些是swagger的旧版本(例如,不是OAS 3)。我对如何使用新库完全感到困惑。

遍历文档,我可以在resources.groovy中引入类似的依赖项:

compile "io.swagger.core.v3:swagger-core:2.0.5"  

但是我不知道我可以使用什么类来初始化摇摇欲坠。我在哪里定义需要扫描的软件包?我可以使用哪个类来生成通用的JSON?

我意识到有一些插件(例如swaggydoc),但它们并未维护,因此我宁愿不使用它们。
理想情况下,我将使用swagger自己提供的库。

全部都是Java代码,所以我觉得我应该可以将其与grails 2集成在一起,尤其是因为它可以与旧的swagger库一起使用。但是我需要一些入门帮助。

0 个答案:

没有答案