通过Swagger来管理服务平台对外提供的接口,方便开发测试,对于后台开发中节约与客户端开发者的交流成本,避免通过修改复杂的文档完成接口对接,使得项目开发更具有简洁性、高效性。
项目快速整合Swagger
实现方案:点击查看
https://github.com/YouAreOnlyOne/FastFrameJar/tree/master/ApiConfig
最终效果
相关问题
1、配置运行正常,接口不显示
No operations defined in spec!
SpringMVC+Swagger2 发现能出现swagger-ui.html页面,但是无法显示接口方法。
swagger-ui不显示接口列表。
解决方法:
1)不要把配置文件放在controller目录下,
2)在springmvc配置文件中添加过滤和扫描
<mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/" />
<mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/" />
<bean id="testSwagger" class="com.construct.test.TestSwaggerApi"></bean>
2、尝试访问http://localhost:8080/v2/api-docs,得到的数据为{}
查资料得知fastjson版本问题,替换即可:
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.1.41</version>
</dependency>
替换为:
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.28</version>
</dependency>