Spring Boot 3.x如何替代`@EnableSwagger2WebMvc`?
时间: 2024-09-25 17:04:11 浏览: 19
Spring Boot 3.x 中, Swagger 相关功能已经集成到了 OpenAPI 的支持里,所以不再直接依赖于 `@EnableSwagger2WebMvc`注解来启用Swagger UI。你可以通过引入 springdoc-openapi 或其他相关的 starter 来替代传统Swing。
1. 首先,添加springdoc-openapi-starters到你的Maven或Gradle构建文件中:
Maven:
```xml
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-ui</artifactId>
</dependency>
```
Gradle:
```gradle
implementation 'org.springdoc:springdoc-openapi-ui'
```
2. 使用`@RestController`或`@GetMapping`等注解标注RESTful API,Springdoc会自动扫描生成API文档。
3. 如果需要更高级的配置,比如自定义路径、标题或版本信息,可以创建一个`Info`对象,并设置在@Configuration类上,例如:
```java
@Configuration
public class SwaggerConfig {
@Bean
public Info info() {
return new Info().title("My API").description("This is my awesome API").version("1.0");
}
}
```
4. 最后,你可以在项目启动后,访问`http://localhost:8080/swagger-ui.html`来查看生成的OpenAPI文档。