Swagger定义API返回Map处理姿势

一般都是定义的对象作为出入参。只是对接别人接口发现，是动态参数，比如返回字段是xx01、xx02这种，可能会有N个字段。于是只能返回Map，但同时又想让Swagger给出基本的出参定义比如xx01系列的说明。

1. 定了一个类A extends ModelAndView，放入一批字段和动态字段的第一个，然后继承ModelAndView,之后把，继承出来的字段屏蔽掉，加上如下代码：

@ApiModelProperty(hidden = true)
@Override
public Map<String, Object> getModel() {
    return super.getModel();
}
@ApiModelProperty(hidden = true)
@Override
public boolean isEmpty() {
    return super.isEmpty();
}

@ApiModelProperty(hidden = true)
@Override
public ModelMap getModelMap() {
    return super.getModelMap();
}
@ApiModelProperty(hidden = true)
@Override
public boolean isReference() {
    return super.isReference();
}
@ApiModelProperty(hidden = true)
@Override
public HttpStatus getStatus() {
    return super.getStatus();
}
@ApiModelProperty(hidden = true)
@Override
public View getView() {
    return super.getView();
}
@ApiModelProperty(hidden = true)
@Override
public String getViewName() {
    return super.getViewName();
}

2.Controller中定义两个函数c1、c2，其中一个返回的就是c1返回的就是A,不过里面直接转发return new A("转发到c2"). c2方法返回Map,里面写具体内容即可。给c2加上

@ApiOperation(hidden = true)隐藏掉即可

这样既可以swagger文档既可以输出静态参数，同时调用又可以返回动态参数内容