![](https://img-blog.csdnimg.cn/20201014180756922.png?x-oss-process=image/resize,m_fixed,h_64,w_64)
接口开发
weixin_45863786
这个作者很懒,什么都没留下…
展开
-
Spring-Boot + Api2Doc自动生成API接口文档
本文介绍一个非常好用的自动化生成 Restful API 文档的工具——Api2Doc它基于 SpringBoot ,原理类似于 Swagger2,但比 Swagger2 要简单好用。目录项目背景 Api2Doc 简介 引入 Api2Doc 依赖 启用 Api2Doc 服务 给 Controller 类上添加文档注解 @Api2Doc 注解详述 @ApiComment 注解详述 @ApiError 注解详述 给文档菜单项排序 补充自定义文档 定制文档的欢迎页 定制文档的标题及原创 2020-05-12 19:52:12 · 1774 阅读 · 2 评论 -
Swagger2 中 paramType使用
接口代码@GetMapping("/user")@ApiOperation(value = "根据用户获取参数")@ApiImplicitParams({ @ApiImplicitParam(name = "username", value = "用户名", required = true, dataType = "String", paramType = "path")})paramType:表示参数放在哪个地方header-->请求参数的获取:@Re...原创 2020-05-12 19:43:34 · 985 阅读 · 0 评论 -
Spring-Boot + Swagger2 自动生成API接口文档
spring-boot作为当前最为流行的Java web开发脚手架,相信越来越多的开发者会使用其来构建企业级的RESTFul API接口。这些接口不但会服务于传统的web端(b/s),也会服务于移动端。在实际开发过程中,这些接口还要提供给开发测试进行相关的白盒测试,那么势必存在如何在多人协作中共享和及时更新API开发接口文档的问题。假如你已经对传统的wiki文档共享方式所带来的弊端深恶痛绝,那么尝试一下Swagger2 方式,一定会让你有不一样的开发体验:功能丰富 :支持多种注解,自动生成接口文档界面原创 2020-05-12 19:37:48 · 660 阅读 · 0 评论