我对Java Web Services的开发非常陌生，对API规范有一个基本的问题。
我正在考虑2种格式：RAML或openapi（Swagger）。我目前有的问题：
使用RAML的常用方法是什么？我们编写一个RAML标记，然后静态生成实现规范和文档的源文件？
对于Swagger，我们实际上写什么？据我所知，我们为其余端点实现了一个函数，并用import io.swagger.annotations.*;对其进行了注释。我认为注释import io.swagger.annotations.*;的目的仅是文档吗？
我对大张旗鼓的用法的主要担心是，我们仅出于文档目的将依赖项添加到代码中。在我看来这很奇怪。
RAML vs Swagger单击下面的链接