之前一直使用的2.9.2版本的+低版本的springboot,一直用着么问题。最近在高版本的springboot项目中引入了swagger出现了无法使用的情况,查询得知是因为版本更新的问题。这里只记录一下新的swagger的配置使用。
一、引入maven依赖
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
这个是新版本的依赖,相当于之前的
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</dependency>
现在只要引入一个就可以了。
二、加入swagger的配置文件
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanPostProcessor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.util.ReflectionUtils;
import org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping;
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.spring.web.plugins.WebMvcRequestHandlerProvider;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
import java.lang.reflect.Field;
import java.util.List;
import java.util.stream.Collectors;
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
.paths(PathSelectors.any())
.build();
}
public ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("Quartz定时任务")
.description("测试swagger配置定时任务")
// .termsOfServiceUrl("https://www.baidu.com/")
.version("1.0")
.build();
}
@Bean
public static BeanPostProcessor springfoxHandlerProviderBeanPostProcessor() {
return new BeanPostProcessor() {
@Override
public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
if (bean instanceof WebMvcRequestHandlerProvider) {
customizeSpringfoxHandlerMappings(getHandlerMappings(bean));
}
return bean;
}
private <T extends RequestMappingInfoHandlerMapping> void customizeSpringfoxHandlerMappings(
List<T> mappings) {
List<T> copy = mappings.stream().filter(mapping -> mapping.getPatternParser() == null)
.collect(Collectors.toList());
mappings.clear();
mappings.addAll(copy);
}
@SuppressWarnings("unchecked")
private List<RequestMappingInfoHandlerMapping> getHandlerMappings(Object bean) {
try {
Field field = ReflectionUtils.findField(bean.getClass(), "handlerMappings");
field.setAccessible(true);
return (List<RequestMappingInfoHandlerMapping>) field.get(bean);
}
catch (IllegalArgumentException | IllegalAccessException e) {
throw new IllegalStateException(e);
}
}
};
}
}
三、添加注解
在控制层的外面添加
@Api(value = “定时任务管理入口”, tags = “开启定时任务”)
在控制层的方法上添加
@ApiOperation(value = “获取住院病人基本信息”, notes = “获取住院病人基本信息”, httpMethod = “GET”)
请求体外面可以添加
@ApiModel
字段上添加
@ApiModelProperty(value = “任务名称” , required = false)
当字段不需要在前端显示的时候可以增加一个 hidden = true 属性
这些东西都和之前的老版本的一样使用就行了
四、启动测试
之前的swagger访问的地址是后面加上 /swagger-ui.html
现在的为 /swagger-ui/index.html
![在这里插入图片描述](https://img-blog.csdnimg.cn/db6384f3b2544cbe911ce13872269723.png)
输入网址就可以访问到了。
这个文章仅作个人使用记录swagger。