当前位置: 首页 > 知识库问答 >
问题:

swagger 2 spring boot生成yml文件

耿玄裳
2023-03-14

我对招摇、合同和Spring启动(gradle)项目不熟悉,我们刚刚开始处理合同。我用过grails,喜欢你如何把field def放在域中,它通过堆栈继承。

一个具体的问题,也许还有一个背着猪的八卦问题。

如何从标准控制器类生成YAML文件的基本存根?

我知道我应该创建一个[Name]-v1-0。目录controller\src\test\resources

我已经实现了大摇大摆的用户界面。项目中的html和一个非常酷的交互式网页出现,显示请求的结束点和内容。使用类swagggerconfig扩展WebMVCConfigureAdapter,它可以在ui json文档网页中发布接口。

我相信大家的理解是,test resources目录中的yml文件将是“契约”的固定一代,并用于某种gradle测试方法中,以确保API签名和契约点没有改变,比如基本的junit风格的接口测试。(是/否?)

我懒得在这里想,为什么我要手工破解这个愚蠢的文件?可以从控制器/模型细节为我生成一个yaml文档骨架吗?

例如,页面上有一个YML文件,用户界面友好页面:http://editor.swagger.io/#/

在那个页面上有一个非常好的“优步”示例YAML文件,我真的需要写吗,我已经写了控制器,javadoc,注释,各种很酷的东西,应该能够生成至少一个相当好的YAML起始存根,(我责怪你grails不想破解这个!)当然,这是在放置SpringFox注释之前,这些注释做了更多很酷的事情,并真正去镇上推动更多的测试合同保证。

仅供参考:“spring boot starter web”spring boot starter测试“springfox swagger ui”,版本:“2.4.0”

共有2个答案

隗翰海
2023-03-14

有一个功能要求提供规格的yaml表示:https://github.com/springfox/springfox/issues/651

除了进展情况外,目前尚不可用

邴俊达
2023-03-14

我拿到了。很简单,为什么我没有看到这个地方。:)

复制/粘贴浏览器中的资源路径:

http://localhost:8095/v2/api-docs?group=full-api

选择生成的内容并复制到剪贴板。

在浏览器中打开Swagger编辑器:

http://editor.swagger.io

从文件菜单中选择粘贴JSON。

粘贴生成的Swagger JSON内容,然后单击导入。

 类似资料:
  • 我有一个简单的服务描述文件open-api.json: 我在我的Spring webflux项目中使用springdoc openapi webflux ui: 是否可以显示现有文件而不是生成的文件?任何帮助,谢谢!

  • 使用 Hexo 生成静态文件快速而且简单。 $ hexo generate 监视文件变动 Hexo 能够监视文件变动并立即重新生成静态文件,在生成时会比对文件的 SHA1 checksum,只有变动的文件才会写入。 $ hexo generate --watch 完成后部署 您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。 $ hexo generate

  • 我正在尝试将一个网站从Heroku迁移到AWS,但在代码构建方面遇到了麻烦。源代码在GitHub上,我使用的是CodePipeline-CodeBuild-Elastic Beanstalk。管道运行良好,代码似乎正在向Elastic Beanstalk过渡。然而,我被困在代码构建步骤。(buildspec.yml如下所示) 日志似乎可以很好地运行命令,但是当我将构建输出到S3存储桶时,没有构建文

  • 我的第一个疑惑是yml和yaml有什么区别?我应该用哪一个。此外,我必须把我的标签在yml文件,并加载它们。所以我不知道该怎么做。这方面的任何例子或教程都会非常有帮助。

  • 嗨,我是NetBeans IDE的新手,我正在使用NetBeans GUI构建器创建我的GUI。我正在创建新文件,方法是右键单击包,单击new然后单击new JFrame Form。它工作得很好。但是我有一个带有JFrame的java文件,我可以通过编码手动创建它,我可以将它导入到GUI构建器中,这样我就可以拖放和创建GUI了。如果是,我该怎么做?(在eclipse中,我们可以右键单击该文件,然后