Springboot整合Swagger

问题

前后端分离后,接口文档显得十分重要,调试也是, Swagger 为我们提供了一个有用的功能。自动把端口以网页形式展示出来。

使用官方方式

只要两步即可:

(1)添加依赖

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.9.2</version>
</dependency>

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
  <version>2.9.2</version>
</dependency>

(2)启动注解

@EnableSwagger2
@SpringBootApplication
public class SpringbootMongoApplication {
	public static void main(String[] args) {
		SpringApplication.run(SpringbootMongoApplication.class, args);
	}
}

完成以上两步即可,启动 Springboot 应用,访问: http://localhost:8080/swagger-ui.html

Springboot整合Swagger

使用SpringForAll封装后的依赖

在该项目的帮助下,我们的Spring Boot可以轻松的引入swagger2:

  • pom.xml 中引入依赖:
<dependency>
	<groupId>com.spring4all</groupId>
	<artifactId>swagger-spring-boot-starter</artifactId>
	<version>1.9.1.RELEASE</version>
</dependency>
  • 在应用主类中增加 @EnableSwagger2Doc 注解
@EnableSwagger2Doc
@SpringBootApplication
public class Bootstrap {
    public static void main(String[] args) {
        SpringApplication.run(Bootstrap.class, args);
    }
}

默认情况下就能产生所有当前Spring MVC加载的请求映射文档。

GibHub网址: https://github.com/SpringForAll/spring-boot-starter-swagger

总结

更多丰富的用法,就参考官方文档吧。

欢迎关注微信公众号< 南瓜慢说 >,将持续为你更新…

Springboot整合Swagger

推荐阅读:

如何制定切实可行的计划并好好执行

Springboot相关

容器技术

Https专题

原文 

https://www.pkslow.com/archives/springboot-swagger

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » Springboot整合Swagger

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址