我正在尝试创建一个原型(使用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库一起使用。但是我需要一些入门帮助。