SpringMvc中文檔出現(xiàn)異常一般分2種情況:
針對以上兩種情況的解決辦法:
第一種:doc.html打開提示404?
一般無需添加此配置,如果出現(xiàn)這種情況,在Spring的xml配置文件中,添加Spring的靜態(tài)資源映射路徑即可,如下:
<mvc:resources location="classpath:/META-INF/resources/" mapping="doc.html"/>
<mvc:resources location="classpath:/META-INF/resources/webjars/" mapping="/webjars/**"/>
第二種:doc.html已經(jīng)可以打開,但是頁面無任何接口文檔?
在web.xml中配置了DispatcherServlet
,則需要追加一個url匹配規(guī)則,如下
<!-- 配置swagger-bootstrap-ui的url請求路徑-->
<servlet-mapping>
<servlet-name>swaggerDemoMvc</servlet-name>
<url-pattern>/v2/api-docs</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>swaggerDemoMvc</servlet-name>
<url-pattern>/swagger-resources</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>swaggerDemoMvc</servlet-name>
<url-pattern>/swagger-resources/configuration/ui</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>swaggerDemoMvc</servlet-name>
<url-pattern>/swagger-resources/configuration/security</url-pattern>
</servlet-mapping>
<!--此接口地址為SwaggerBootstrapUi提供的增強地址,如果不使用增強功能,可排除此配置-->
<servlet-mapping>
<servlet-name>swaggerDemoMvc</servlet-name>
<url-pattern>/v2/api-docs-ext</url-pattern>
</servlet-mapping>
關(guān)于SpringMvc的代碼示例可參考swagger-bootstrap-ui-demo-mvc
更多建議: