最近一直在捣鼓Swagger的事情,起初使用Swagger1可以配个 swagger-springmvc成功,但是它配合SpringMVC项目如果是一个上传文件就不太友好了,无法展示上传文件的按钮,所以有上传文件,图片的api就无法使用了!!!!
百度了好一阵子,在万能的stackoverflow上终于得到答案,国内的搜索网站贴吧这点儿真的有些逊色了,没有关于这方面的解决方案,还是靠我微薄的英语知识搜索到的,原来 swagger-springmvc1.0.2(最新的)已经过时了,已经被springfox取代了 !!!!!!!!
好吧,伐开心!好不容易熬了几个通宵配置起来的swagger就这样夭折了。
那就继续研究springfox的swagger配置;
现在时刻的当前版本是springfox2.6.1;果断maven下来
<dependency>
<groupId>io.springfoxgroupId>
<artifactId>springfox-swagger2artifactId>
<version>${springfox.version}version>
dependency>
<dependency>
<groupId>io.springfoxgroupId>
<artifactId>springfox-swagger-uiartifactId>
<version>${springfox.version}version>
dependency>
在然后写配置:
@Configuration // 配置注解
@EnableWebMvc // 启用Mvc //非springboot框架需要引入注解@EnableWebMvc
@EnableSwagger2 // 启用Swagger2,毕竟SpringFox的核心依旧是Swagger
// @ComponentScan(basePackages = "com.june.controller.back.common.*")//然而并没有卵用
public class SwaggerConfig extends WebMvcConfigurerAdapter {
@Bean
public Docket customDocket() {
return new Docket(DocumentationType.SWAGGER_2).select()// 选择哪些路径和API会生成document
.apis(RequestHandlerSelectors.any())// 对所有api进行监控
.paths(PathSelectors.any())// 对所有路径进行监控
.build().apiInfo(apiInfo());
}// */
private ApiInfo apiInfo() {
return new ApiInfo(PROJ, DESC, VERS, SERV, new Contact(NAME, URL, CONT), LICS, L_URL);
}
}
小弟的所有配置都是参考了这位CSDN的仁兄的博客
好吧开开心心的(其实并不开心,工作好好的,就今天公司说辞就辞,把一位一起工作的同事给辞掉了,很震惊也很愤怒,更为自己考虑考虑),
然后运行,心想这个应该不会有问题了,因为以前的swagger1已经配置的very very good了,至少运行是没有任何问题的,结果呵呵哒!
352198 [localhost-startStop-1] DEBUG o.s.b.f.s.DisposableBeanAdapter - Invoking destroy method 'close' on bean with name 'dataSource'
352207 [localhost-startStop-1] ERROR o.s.web.context.ContextLoader - Context initialization failed
org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is com.google.common.util.concurrent.ExecutionError: java.lang.StackOverflowError
at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:176)
at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:51)
at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:346)
at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:149)
at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:112)
at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:852)
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:541)
at org.springframework.web.context.ContextLoader.configureAndRefreshWebApplicationContext(ContextLoader.java:444)
at org.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:326)
at org.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:107)
at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:4853)
at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5314)
at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:145)
at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1408)
at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1398)
at java.util.concurrent.FutureTask.run(FutureTask.java:266)
at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
at java.lang.Thread.run(Thread.java:745)
Caused by: com.google.common.util.concurrent.ExecutionError: java.lang.StackOverflowError
at com.google.common.cache.LocalCache$Segment.get(LocalCache.java:2201)
at com.google.common.cache.LocalCache.get(LocalCache.java:3937)
at com.google.common.cache.LocalCache.getOrLoad(LocalCache.java:3941)
at com.google.common.cache.LocalCache$LocalLoadingCache.get(LocalCache.java:4824)
at com.google.common.cache.LocalCache$LocalLoadingCache.getUnchecked(LocalCache.java:4830)
at springfox.documentation.spring.web.scanners.CachingOperationReader.read(CachingOperationReader.java:57)
at springfox.documentation.spring.web.scanners.ApiDescriptionReader.read(ApiDescriptionReader.java:66)
at springfox.documentation.spring.web.scanners.ApiListingScanner.scan(ApiListingScanner.java:89)
at springfox.documentation.spring.web.scanners.ApiDocumentationScanner.scan(ApiDocumentationScanner.java:70)
at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.scanDocumentation(DocumentationPluginsBootstrapper.java:85)
at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.start(DocumentationPluginsBootstrapper.java:127)
at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:173)
... 18 common frames omitted
Caused by: java.lang.StackOverflowError: null
at com.fasterxml.classmate.TypeBindings.equals(TypeBindings.java:221)
at com.fasterxml.classmate.ResolvedType.equals(ResolvedType.java:278)
at com.fasterxml.classmate.types.ResolvedRecursiveType.equals(ResolvedRecursiveType.java:157)
at com.fasterxml.classmate.TypeBindings.equals(TypeBindings.java:221)
at com.fasterxml.classmate.ResolvedType.equals(ResolvedType.java:278)
at com.fasterxml.classmate.types.ResolvedRecursiveType.equals(ResolvedRecursiveType.java:157)
at com.fasterxml.classmate.TypeBindings.equals(TypeBindings.java:221)
at com.fasterxml.classmate.ResolvedType.equals(ResolvedType.java:278)
这个问题废了两天也没解决掉,是因为国内研究springfox太少的缘故么,至少网上搜索的时候发现大部分有关springfox的介绍都是2016年底的文章,看来又到我发挥英语的时候啦,注意下面的关键词,在百度输入:“swagger2.6.0 can not work well with springmvc ”,蓝后搜索,还是万能的stackoverflow
给力了,
解决问题,在这个贴最后发现一位仁兄这样总结的:
a work around is to rollback to springfox-swagger2 2.5.0 .
呵呵,现在正在研究 spring2.5.0了……有成果了在了分享!