默认推荐配置中不包含swagger
的支持
param.doc=@io.swagger.annotations.ApiParam#value
param.default.value=@io.swagger.annotations.ApiParam#defaultValue
param.required=@io.swagger.annotations.ApiParam#required
param.ignore=@io.swagger.annotations.ApiParam#hidden
class.doc=@io.swagger.annotations.Api#value
method.doc=@io.swagger.annotations.ApiOperation#value
field.doc=@io.swagger.annotations.ApiModelProperty#value
api.tag=@io.swagger.annotations.ApiOperation#tags
resolve_api_implicit_param=```
def desc = map.value
def allowableValues = map.allowableValues
if(tool.notNullOrBlank(allowableValues)){
desc = desc + "\n允许的值:" + allowableValues
}
def paramType = map.paramType ?: "query"
def required = map.required?:true
if(paramType==""||paramType=="query"){
api.setParam(map.name,map.defaultValue,required,desc)
}else if(paramType=="form"){
api.setFormParam(map.name,map.defaultValue,required,desc)
}else if(paramType=="path"){
api.setPathParam(map.name,map.defaultValue,desc)
}else if(paramType=="header"){
api.setHeader(map.name,map.defaultValue,required,desc)
}
```
export.after[@io.swagger.annotations.ApiImplicitParam]=groovy:```
def map = it.annMap("io.swagger.annotations.ApiImplicitParam")
${resolve_api_implicit_param}
```
export.after[@io.swagger.annotations.ApiImplicitParams]=groovy:```
def maps = it.annMap("io.swagger.annotations.ApiImplicitParams")
for(map in maps.value){
${resolve_api_implicit_param}
}
```
resolve_api_response=```
def desc = "\\n\\n***响应码***:"+map.code+"\\n\\n"
desc += map.message+"\\n\\n"
def response = map.response
if(response!=null){
def responseClass = helper.findClass(response)
if(responseClass!=null){
desc += "响应内容:\\n```json\\n" + responseClass.toJson(true) + "\\n```\\n"
}
}
api.appendDesc(desc)
```
export.after[@io.swagger.annotations.ApiResponse]=groovy:```
def map = it.annMap("io.swagger.annotations.ApiResponse")
${resolve_api_response}
```
export.after[@io.swagger.annotations.ApiResponses]=groovy:```
def maps = it.annMap("io.swagger.annotations.ApiResponses")
for(map in maps.value){
${resolve_api_response}
}
```
export.after[@io.swagger.annotations.ApiResponse]=groovy:```
def map = it.annMap("io.swagger.annotations.ApiResponse")
api.setResponseCode(map.code?:200)
api.appendResponseBodyDesc(map.message)
def responseHeaders = map.responseHeaders
if(responseHeaders!=null){
for(responseHeader in responseHeaders) {
api.setResponseHeader(responseHeader.name,"",true,responseHeader.description)
}
}
def response = map.response
if(response!=null){
api.setResponseBodyClass(response)
}
```