
swagger
古良道
这个作者很懒,什么都没留下…
展开
专栏收录文章
- 默认排序
- 最新发布
- 最早发布
- 最多阅读
- 最少阅读
-
Swagger文档无法生成部分实体类
原因低版本的spring-web(小于5.1.0-RELEASE), HandlerMethodParameter没有重写getParameterAnnotations方法,导致无法向上层解析参数的注解信息。案例api定义如下:@Api( value = "测试的Api", tags = {"TApi"})@RequestMapping({"/tApi"})public interface TApi { @ApiOperation( value = "测原创 2021-03-20 22:34:42 · 777 阅读 · 0 评论 -
同时使用@JsonProperty和@ApiModelProperty时,在接口文档上属性名该是啥???
文章目录场景collectAll_addFieldsfindNameForDeserialization总结场景由于想在接口文档上显示属性的描述,于是使用了如下代码@JsonProperty(value = "aaBB")@ApiModelProperty(value = "描述内容")private Integer cc;可是打开接口文档一看,原来的cc属性不见了,只剩下aaBB。...原创 2020-01-20 18:48:12 · 3344 阅读 · 4 评论 -
springfox相关记录
1.springboot为1.5.13版本时,springfox为2.6.0,难以生成正确的swagger文档,升级springfox为2.7.0即可2.@ApiImplicitParam的dataType,需要是小写开头,不能是大写!!!想要实现返回值是数组或者list,加上allowMultiple=true即可。3.本地项目生成swagger-ui页面,只要3个配置。启动类加@Enabl...原创 2019-11-04 10:47:27 · 355 阅读 · 0 评论 -
记:通过Swagger-ui 生成json
自己搭建了一个springboot项目,用swagger生成api文档。结果显示如下:但是此时需要json格式的内容。我发现了两种方法。1.替换访问路径此时访问的url为http://localhost:8080/swagger-ui.html# ,只需要将url中swagger-ui.html#替换成右上角的/v2/api-docs即可。访问http://localhost:8080/v...原创 2019-09-05 09:31:06 · 4254 阅读 · 0 评论 -
swagger-codegen 生成代码原理
文章目录概述:一.命令行入口二.web调用三.总指挥官1.生成models2.生成apis3.生成支持文件概述:swagger-codegen可以通过命令行生成代码(v2.1.5 /Swagger格式),也可以通过web服务生成代码(v3.0.11/OpenAPI格式)。两者只是入口不一样,但实际都是调用的DefaultGenerator.generate()来生成代码。在整个生成代码的过程...原创 2019-09-18 16:15:47 · 4632 阅读 · 1 评论 -
使用swagger-codegen生成代码,始终删除不了gradle-wrapper.jar
最近依赖swagger-codegen生成java客户端代码,发现始终删除不了gradle-wrapper.jar。一开始以为是自己压缩过程流没有关闭,发现是源码有问题???原创 2019-09-19 09:27:03 · 354 阅读 · 0 评论