简介 由于架构革新，进入了前后端分离，服务端只需提供RESTful API的时代。而构建RESTful API会考虑到多终端的问题，这样就需要面对多个开发人员甚至多个开发团队。为了减少与其他团队对接的沟通成本，我们通常会写好对应的API接口文档。从最早开始的word文档，到后续的showdoc，都能减少很多沟通成本，但随之带来的问题也比较麻烦。在开发期间接口会因业务的变更频繁而变动，如果需要实时更新接口文档，这是一个费时费力的工作。为了解决上面的问题，Swagger应运而生。他可以轻松的整合进框架，并通过一系列注解生成强大的API文档。他既可以减轻编写文档的工作量，也可以保证文档的实时更新，将维护文档与修改代码融为一体，是目前较好的解决方案。 常用注解 @Api()用于类；表示标识这个类是swagger的资源@ApiOperation()用于方法；表示一个http请求的操作@ApiParam()用于方法，参数，字段说明；表示对参数的添加元数据（说明或是否必填等）@ApiModel()用于类表示对类进行说明，用于参数用实体类接收@ApiModelProperty()用于方法，字段表示对model属性的说明或者数据操作更改@ApiIgnore()用于类，方法，方法参数表示这个方法或者类被忽略@ApiImplicitParam() 用于方法表示单独的请求参数@ApiImplicitParams() 用于方法，包含多个 @ApiImplicitParam 代码示例 @Api @ApiOperation @ApiResponses @ApiImplicitParams @ApiParam @ApiModel 与 @ApiModelProperty @ApiIgnore() 到此这篇关于Java中间件Swagger的使用详解的文章就介绍到这了,更多相关Swagger的使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！