Springboot 整合 Swagger 3
1:引入依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
2:编写一个swagger 配置类
@Configuration
@EnableWebMvc
@EnableOpenApi
public class SwaggerConfig {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.demotest.controller"))
.paths(PathSelectors.any())
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("程序猿xiaoxia API")
.description("xiaoxia springboot-swagger2 在线借口文档")
.termsOfServiceUrl("https://blog.csdn.net/XikYu")
.version("1.0")
.build();
}
}
3:在controller层中填写一些注解
@RestController
@RequestMapping("/department")
@SuppressWarnings("all")
//@RequiredArgsConstructor(onConstructor = @__(@Autowired))
public class DepartmentController {
@Resource
private DepartmentService departmentService;
@PostMapping("treeDepartment")
@ApiOperation(value = "树形化结构数据")
public Result treeDepartment(){
List<Department> departmentAll = departmentService.findDepartmentAll();
return new Result(ResultCode.SUCCESS,departmentAll);
}
}
4:访问地址:http://localhost:8080/swagger-ui/index.html
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 阿里最新开源QwQ-32B,效果媲美deepseek-r1满血版,部署成本又又又降低了!
· SQL Server 2025 AI相关能力初探
· AI编程工具终极对决:字节Trae VS Cursor,谁才是开发者新宠?
· 开源Multi-agent AI智能体框架aevatar.ai,欢迎大家贡献代码
· Manus重磅发布:全球首款通用AI代理技术深度解析与实战指南