你是否也被没有文档的项目折磨?你是否也因为项目需要写文档而头疼?你是否也被年久失修的文档坑害?少年,吃下我这发安利吧!通过部署 Swagger,这些问题都将远离你,精美、易读、可测试、时效性高的文档,不想试试么?
效果展示
闲言少叙,我们直接来看最终的效果,黑喂狗!
step1.给接口添加注释
注释语句的语法后续有机会再讨论,这里不做赘述。
step2.查看根据注释自动生成的 Json 结构
step3.根据Json结构自动生成文档
step4.可以通过文档进行接口调用测试