我要评论使用swagger 时，往往会用到类似下面这样的注解
@apiimplicitparam(name = "id", value = "主键", datatype = "int", paramtype = "query")
网上说这里的datatype 类型有string / int两种，其余的都是无用的。
但是如果需要传递的参数是list类型，应该怎么办?
首先直接在浏览器中输入网址，传递参数（xxx?idlist=1,2,3）来测试，是没有问题的
在swagger中如果直接使用int，list<integer> 这样的参数，会导致swagger无法测试接口，如下：
@apiimplicitparam(name = "idlist", value = "id列表", required = true, datatype = "int", paramtype = "query")
后来我的一个复杂的做法是：把list的所有值传一个string类型的参数，用中括号包起来，最后再解析。形如 xxx?idlist=[1,2,3] ，可以实现效果，但是比较麻烦
再后来突然发现一个很简单的解决办法
那就是去掉@apiimplicitparam 注解（注：我的swagger 版本是2.8.0，）
比如：
@apioperation("批量查询课程信息")
public result listxxxbyidlist(@requestparam(value = "idlist") list<long> idlist) {...}
这样以后，测试的时候，就可以添加、删除list参数了，这个参数的类型是array[], 如下图：
可能是因为后来的swagger版本能够自动识别方法中的参数了，这样做的缺点只是没有中文描述而已
当然如果非要加上中文描述也是可以的，那就是使用 @apiparam 注解，如下：
@apioperation("批量查询课程信息")
public result listxxxbyidlist(@requestparam(value = "idlist") @apiparam(value = "id列表") list<long> idlist) {...}
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持移动技术网。
您可能感兴趣的文章:
如您对本文有疑问或者有任何想说的，请点击进行留言回复，万千网友为您解惑！
网友评论