spring boot Swagger2(version=2.7.0) 注解@ApiImplicitParam的属性dataType值为”自定义泛型“应用
注解:
@ApiImplicitParams
@ApiImplicitParam
name="需注解的API输入参数",
value="接收参数的意义描述",
paramType="参数存放位置",
dataType="参数类型,可传基本类型、类、泛型类等",
required="输入参数是否必传"
其它属性暂时忽略,具体可查看官网等资源。
敲重点:属性“dataType”基本类型、类按照正常来赋值,自定义泛型类应该按照如下格式来赋值:
例如:dataType = "demo«ArrayList«demo1»»",重点是符号“«»”。
以下摘自swagger2源码(各位看官请自行体会):
fieldName |
typeName |
qualifiedTypeName |
genericByteArray |
GenericType«Array«byte»» |
springfox.documentation.schema.GenericType<byte[]> |
genericCategoryArray |
GenericType«Array«Category»» |
springfox.documentation.schema.GenericType<springfox.documentation.schema.Category[]> |
示例:
@ApiImplicitParams(value = {@ApiImplicitParam(name = "input", value = "接收参数的意义描述", paramType = "body", dataType = "demo«ArrayList«demo1»»", required = true), @ApiImplicitParam(name = "index", value = "接收参数的意义描述", paramType = "query", dataType = "String", required = true)})
效果图:
相关文章
- spring 4.2.0后jdbcTemplate中不用queryForLong了(之系统升级发现)
- Spring Boot 缓存技术:Spring Boot
- Spring Boot 基础概述与相关约定配置
- spring整合cxf 使用jax-ws规范实现webservice功能
- Spring Boot 2.0(五):Docker Compose + Spring Boot + Nginx + Mysql 实践
- SpringBoot 源码解析 (二)----- Spring Boot精髓:启动流程源码分析
- Spring Boot 实现定时任务的 4 种方式
- Spring Boot整合 Thymeleaf 模板引擎
- spring 之 spring-mvc
- 从spring boot 启动过程看apollo的初始化过程( 二)
- Spring IOC 初始化刷新流程一:prepareRefresh()
- Spring_AOP动态代理详解(转)
- spring boot 使用@ConfigurationProperties
- Spring Boot 2.0的属性绑定
- Spring+quartz集群配置,Spring定时任务集群,quartz定时任务集群
- Spring Boot 环境变量读取 和 属性对象的绑定
- spring boot admin
- 记: Spring Data Jpa @OneToMany 级联查询被动触发的问题
- Spring Boot「15」统一异常处理
- Spring Boot2 系列教程(三十)Spring Boot 整合 Ehcache
- parallelStream与Spring事务相遇?不是冤家不聚头~
- Spring事务管理详解