Swagger 是一款RESTFUL接口的文档在线自动生成+功能测试功能软件。之前用swager1 集成过,无意间看到swagger2比swagger1强大很多,则没啥事就玩玩Spring MVC 集成Swagger2,言归正传,往下看。
集成Swageger2有几步
- 在pom.xml中添加相关jar
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.4.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.4.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.6.5</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.6.5</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.6.5</version>
</dependency>
- 在Spring配置文件中添加
<!-- 注释声明Swaggeer -->
<bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping" />
<!-- 访问资源文件配置,资源文件是springfox-swagger-ui.jar -->
<mvc:resources location="classpath:/META-INF/resources/" mapping="swagger-ui.html"/>
<mvc:resources location="classpath:/META-INF/resources/webjars/" mapping="/webjars/**"/>
- 访问地址
http://localhost:8080/spring-example/swagger-ui.html
- 效果图
- 注意事项
- 修改swagger.html样式、或者汉化,从 springfox-swagger-ui.jar 着手修改。
- 关于Swagger2注解说明,网络有很多,但我觉得这篇文章还不错【点击】
Demo下载地址:https://download.csdn.net/download/everyday_hzg/10452659
欢迎吐槽,共同进步。