springdoc 定义全局响应状态码
时间: 2024-06-16 14:05:47 浏览: 127
Springdoc是一个用于生成OpenAPI文档的开源库,它基于Spring Boot和Spring WebFlux。它提供了一种简单的方式来定义全局响应状态码。
要定义全局响应状态码,可以使用`@ApiResponse`注解和`@ApiResponses`注解。`@ApiResponse`注解用于定义单个响应状态码,包括状态码、描述和响应模型等信息。`@ApiResponses`注解用于定义多个响应状态码。
下面是一个示例代码,展示了如何使用Springdoc定义全局响应状态码:
```java
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.responses.ApiResponse;
import io.swagger.v3.oas.annotations.responses.ApiResponses;
@RestController
public class MyController {
@Operation(summary = "Get user by ID")
@ApiResponses(value = {
@ApiResponse(responseCode = "200", description = "Successful operation"),
@ApiResponse(responseCode = "404", description = "User not found"),
@ApiResponse(responseCode = "500", description = "Internal server error")
})
@GetMapping("/users/{id}")
public ResponseEntity<User> getUserById(@PathVariable Long id) {
// Implementation
}
}
```
在上面的示例中,`@ApiResponses`注解包含了三个`@ApiResponse`注解,分别定义了状态码200、404和500的描述信息。
阅读全文