背景 最近往自己的框架里集成swagger，发现一个奇怪的问题，当我的tag是中文的时候。发现点击展开不生效，只能点击全部展开，这就十分不方便了。如下图只能点击expand operations。 解决方案 第一种方案：如果说我们将tags改为英文，那么发现界面展开好使。 第二种方案 ...

Swagger常用注解 在Java类中添加Swagger的注解即可生成Swagger接口，常用Swagger注解如下： @Api：修饰整个类，描述Controller的作用 @ApiOperation：描述一个类的一个方法，或者说一个接口 @ApiParam：单个参数描述 ...

必要字段！Swagger规范版本，必须填2.0，否则该YAML将不能用于Swagger其他组件 swagger: '2.0' 必要字段！描述API接口信息的元数据 info: 接口标题 title: swagger说明文档　 接口文档的描述 description: 学习 ...

目前来说，在 Java 领域使用 Springboot 构建微服务是比较流行的，在构建微服务时，我们大多数会选择暴漏一个 REST API 以供调用。又或者公司采用前后端分离的开发模式，让前端和后端的工作由完全不同的工程师进行开发完成。不管是微服务还是这种前后端分离开发，维持一份完整的及时更新 ...

前言： @Api，@ApiOperation，@ApiImplicitParam，@ApiModelProperty，@ApiIgnore 正文： 一，Controller层 @Api：作用在类上，用来标注该类具体实现内容。 参数： 1，tags：该类的名称 ...

一、相关注解解读1. @Api用在类上，说明该类的作用@Api(value = "UserController", description = "用户相关api")2. @ApiOperation用在方法上，说明方法的作用@ApiOperation(value = "查找用户", notes ...

@ 目录 Swagger-注解： Controller 控制器 @Api @ApiOperation @ApiParam @ApiResponse @ApiResponses @ResponseHeader ...

API详细说明 注释汇总 作用范围 API 使用位置 对象属性 @ApiModelProperty 用在出入参数对象的字段上 协议集描述 ...