springdoc-openapi-common 使用get请求参数是实体类 但swagger识别到是一个个参数 如何通过自定义注解的形式让swagger识别为一个个的参数
时间: 2023-11-28 14:47:52 浏览: 75
express-jsdoc-swagger:Swagger OpenAPI 3.x生成器
可以通过使用 `@ApiImplicitParams` 与 `@ApiImplicitParam` 注解来实现 Swagger 对于 GET 请求参数以实体类形式的支持。具体实现如下:
```java
@GetMapping("/example")
@ApiOperation(value = "示例接口")
@ApiImplicitParams({
@ApiImplicitParam(name = "param1", value = "参数1", dataType = "String", paramType = "query"),
@ApiImplicitParam(name = "param2", value = "参数2", dataType = "Integer", paramType = "query")
})
public ExampleResponse example(@ModelAttribute ExampleRequest request) {
// 处理请求,返回响应
}
```
在上述代码中,我们使用了 `@ModelAttribute` 注解来将 GET 请求的参数映射为实体类 `ExampleRequest`。同时,我们在方法上使用 `@ApiImplicitParams` 注解来指定多个参数,并使用 `@ApiImplicitParam` 注解来指定每个参数的名称、描述、类型和位置。这样,Swagger 就会将 GET 请求的参数识别为一个个的参数而非一个实体类。
阅读全文