UnabletorenderthisdefinitionTheprovideddefinitiondoesnotspecifyavalidversionfield.PleaseindicateavalidSwaggerorOpenAPIversionfield.Supportedversionf

!(https://oscimg.oschina.net/oscnet/f059f6725a8720bd14f78fdd13beb455b7e.gif)!(https://oscimg.oschina.net/oscnet/e03ceca65483920656e7521ed8998988943.gif)SpringbootjpaMySQLswa

1、用惯了idea，会觉得Eclipse质感较low。webstrom和idea界面美感和功能真香。下面先介绍几个自己也在用的插件，留名备份1.1lombok与swagger插件setting—plugins搜索lombok,安装重启。pom文件添加依赖就能用了。<dependency

@Api：用在请求的类上，表示对类的说明2tags"说明该类的作用，可以在UI界面上看到的注解"3value"该参数没什么意义，在UI界面上也看到，所以不需要配置"45@ApiOperation：用在请求的方法上，说明方法的用途、作用6value"说明

本文分享自天翼云开发者社区@《》，作者:才开始学技术的小白0.引言之前写过一篇关于swagger（实际上是springfox）的使用指南（https://www.ctyun.cn/developer/article/371704742199365），涵盖了

harbor提供restapi，官方文档地址如下：https://github.com/vmware/harbor/edit/master/docs/swagger.yaml(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fgithub.com%2Fvmware%2Fharbor

\TOC\!Xnip20190102_160757(https://ssl.aicode.cc/Xnip20190102_160757.jpg)作为一名phper，在使用Lumen框架开发微服务的时候，API文档的书写总是少不了的，比较流行的方式是使用swagger来写API文档，但是与Java语言原生支持annotatio

Swagger(https://www.oschina.net/action/GoToLink?urlhttp%3A%2F%2Fswagger.io%2F)是我目前用过的最优秀的ApiDoc协议没有之一。它与其他ApiDoc协议（如apidocjs(https://www.oschina.net/action/GoToLink?url

前言      我前面为了自己的业务开发也写了一套SpringBootmybatis整合的自动代码生成工具，并实现了lombok的使用(https://my.oschina.net/bianxin/blog/1615120)，与swagger(https://my.oschina.net/bianxin/blog/1615980)的整

enum是规范中用来定义枚举类型的一种方式。它允许开发者在API文档中明确列出该接口的参数、返回值或请求体中可接受的枚举值。通过使用Swaggerenum，开发者可以更清晰地描述API的输入和输出，提高API文档的可读性和可维护性。enum使用场景在以下情