最近研究swagger,网上也搜了不少与springmvc 集成的方式,但是发现最终都有问题。
比如:http://javatech.wang/index.php/archives/74/,这篇文章写的已经很详细了。
但是按照文章上的做,可能还会出现注入失败的问题,其实原因并不再集成里面,而是和你的项目环境有关。
我整合的时候也发生了注入失败的问题,后来看了SpringSwaggerConfig类的源码,发现它依赖了一些其他的类,实际上它依赖的这些类有一些是在spring mvc的容器中的(不知道这里大家有没有看明白)
整合过spring 与 spring mvc的童鞋应该都知道,spring容器与springmvc的容器其实是两个容器,既父容器和子容器,如果在他们两个集成时,没有指定扫描注解,那么spring管理的bean会被创建两次。通常我们集成的时候是这样配置的:
<!-- SpringMvc配置文件,只扫描Controller和ControllerAdvice标记的注解 -->
<context:component-scan base-package="com.xxx.**.controller" use-default-filters="false">
<context:include-filter type="annotation"
expression="org.springframework.stereotype.Controller" />
<context:include-filter type="annotation"
expression="org.springframework.web.bind.annotation.ControllerAdvice" />
</context:component-scan>
<!-- Spring配置文件,排除Controller和ControllerAdvice标记的注解,扫描其他任何注解 -->
<context:component-scan base-package="com.xxx">
<context:exclude-filter type="annotation"
expression="org.springframework.stereotype.Controller" />
<context:exclude-filter type="annotation"
expression="org.springframework.web.bind.annotation.ControllerAdvice" />
</context:component-scan>
通过上面配置不知道大家有没有明白?问题出在哪里?
在看SpringSwaggerConfig源码,它里面实际上依赖了springmvc 子容器的类,想象一下,假设我们写的代码里,service层依赖controller层能注入进去么?这个就好比是这种情况。因为SpringSwaggerConfig它是由spring容器管理的,而不是spring mvc的容器,所以在spring容器创建它的过程中,有一些类实际上是在springmvc子容器中的。好了不在啰嗦了。
最终解决方案(修改spring的配置文件,不让他管理SpringSwaggerConfig)
<!-- Spring配置文件,排除Controller,ControllerAdvice,EnableSwagger标记的注解,扫描其他任何注解 -->
<context:component-scan base-package="com.xxx">
<context:exclude-filter type="annotation"
expression="org.springframework.stereotype.Controller" />
<context:exclude-filter type="annotation"
expression="org.springframework.web.bind.annotation.ControllerAdvice" />
<context:exclude-filter type="annotation"
expression="com.mangofactory.swagger.plugin.EnableSwagger" />
</context:component-scan>
我想大家应该看的很明白了。为什么发生这种问题,让spring容器排除EnableSwagger注解就OK了。