swagger入门
pom依赖
不用专门导入swagger 因为springboot已经将它集成了
org.springframework.boot spring-boot-starter com.github.xiaoymin knife4j-spring-boot-starter
Swagger配置类
@Configuration
public class SwaggerConfig {
// 创建并配置Docket Bean,用于生成Swagger文档
@Bean
public Docket docket() {
// 创建API信息对象
ApiInfo apiInfo = new ApiInfoBuilder()
.title("我不饿外卖项目接口文档") // 设置文档标题
.version("2.0") // 设置文档版本号
.description("我不饿项目接口文档") // 设置文档描述
.build();
// 创建Docket对象
Docket docket = new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo) // 设置API信息
.select()
.apis(RequestHandlerSelectors.basePackage("com.sky.controller")) // 扫描指定包下的Controller类
.paths(PathSelectors.any()) // 匹配所有路径
.build();
return docket; // 返回配置好的Docket对象
}
/**
* 设置静态资源映射
* @param registry
*/
// 重写addResourceHandlers方法,用于配置Swagger静态资源映射
@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
// 添加映射规则,将/doc.html映射到classpath:/META-INF/resources/目录下
registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");
// 添加映射规则,将/webjars/**映射到classpath:/META-INF/resources/webjars/目录下
registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
}
}
注解效果