【补充说明】如何在JavaWeb项目中集成Swagger-UI

原文地址：https://bbs.huaweicloud.com/forum/thread-6358-1-1.html

【问题描述】在使用软开云接口测试的时候，导出swagger文档，是个十分优雅的操作。经过实战，发现Swagger的API文档，还是导不出来，经过深入分析，将遇到的问题再总结了一下。

1、报告异常：

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter': Instantiation of bean failed

原因是com.fasterxml.jackson.core的版本号过低，将2.6.6修改为更高版本，例如2.9.6（目前最新），问题得到解决。

2、报告异常：

1

Unable to infer base url. This is common when using dynamic servlet registration or when the API is behind an API Gateway. The base url is the root of where all the swagger resources are served.

这个问题的原因，网络上的说明有很多，但终究是因为页面访问有问题。-出问题的可能性最大。不同系统的拦截方法，可能不尽相同，在这块找问题，基本会解决。提供一点样例代码，仅供参考。

web.xml

1

2

3

4

/swagger-resources/configuration/ui

/swagger-resources/configuration/security

/swagger-resources

/v2/api-docs

-Java类中

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

/**

* 登录校验忽略swagger

*

* @param mapping

*            相关映射

* @return

* @author Corpse

* @since 2018-08-23 18:26

*/

private boolean swagger(String mapping)

{

return swaggerAccess && XhString.equals(mapping,

"/swagger-resources/configuration/ui",

"/swagger-resources/configuration/security",

"/swagger-resources",

"/v2/api-docs");

}

注意：根据自己系统的实际情况，合理配置拦截规则。

解决这两个问题之后，根据上面文档中的描述，就可以得到你想要的页面了。

软件开发云

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。