Springboot2.0 整合 Swagger API 接口

关注

原创最新推荐文章于 2026-03-12 10:17:11 发布 3k 阅读 AI 写同款· GEO 优化 ›

Spring Boot与OpenAPI的集成 OpenAPI（以前称为Swagger）是一种用于设计、构建和文档化API的开放标准，它提供了强大的工具和库来简化API的开发和维护。本文详细介绍了如何在Spring Boot项目中集成OpenAPI（Swagger），包括项目初始化、Swagger配置和创建API接口。在Swagger UI中，您可以看到自动生成的API文档，包括每个接口的详细说明、请求参数、响应类型等信息。在上面的配置中，我们启用了Swagger，并指定了扫描的API包路径。首先，创建一个Spring Boot项目，并添加必要的依赖。阅读详情

springboot 版本为：2.0.1.RELEASE

swagger 版本为 2.8.0

1 maven pom.xml 添加以下依赖：

<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.8.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.8.0</version>
</dependency>

2 创建类SwaggerConfig

package com.ganjiangps.wangdaibus.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2
public class SwaggerConfig {

@Bean
public Docket createRestApi(){
System.out.println("=============================================");
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.ganjiangps.wangdaibus.controller.test"))
.apis(RequestHandlerSelectors.basePackage("com.ganjiangps.wangdaibus.controller"))
// .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class)) //只显示加了注解的api
.paths(PathSelectors.any())
.build();
}

private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("管理系统")
.description("powered by By-Health")
.termsOfServiceUrl("http://localhost:8080/swagger-ui.html")
//.contact(contact)
.version("1.0")
.build();
}

}

3 继承WebMvcConfigurationSupport 配置静态资源，注：解决访问404问题

//配置静态资源
@Override
protected void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/");
registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
super.addResourceHandlers(registry);
}

4 新建api测试类：

package com.ganjiangps.wangdaibus.controller.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiOperation;

@Api(value="测试即可",consumes="1212")
@Controller
@RequestMapping("/swagger/test")
public class SwaggerTestController {
@ApiOperation(value="测试接口",notes="根据idid")
@ApiImplicitParam(name = "id", value = "d", required = true, dataType = "String")
@ResponseBody
@GetMapping("/test")
public String test(String id){
return "Hello Word!";
}
}