Spring MVC不顯示接口文檔

很多朋友在使用Spring MVC時(shí),會(huì)碰到接口文檔沒(méi)有的情況,在此處做一個(gè)說(shuō)明

1、首先保證SwaggerConfig的配置文件中配置正確的Docket對(duì)象(即默認(rèn)掃描的包路徑或者基于@ApiOperation注解)

2、其次,區(qū)別于SpringBoot的注入,不使用@Configuration注解注入到Spring的IOC容器中,采用<bean>XML注入的方式注入到Spring的容器中,如下：

<bean id="SwaggerConfig" class="com.xiaominfo.swagger.config.SwaggerConfiguration"></bean>

3、需保證注入的SwaggerConfig的bean在Spring的MVC的容器中,因?yàn)镾pring MVC存在父子容器的關(guān)系,如果不將該Bean注入到Spring MVC容器中的話,Swagger就會(huì)掃描不到Controller層的接口，自然也就不會(huì)顯示文檔

例如：

<servlet>
    <servlet-name>swaggerDemoMvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
        <!--在第二步中注入的SwaggerConfig的bean需寫在spring.xml文件中-->
      <param-value>classpath:config/spring.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>