开源中国 2018 年度最后一场技术盛会邀你来约~错过就要等明年啦!点此立即预约

阿信sxq / SpringBootSwaggerStarterJavaApache-2.0

指数
0
Watch 22 Star 76 Fork 16
加入码云
与超过 300 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
在spring-boot中使用swagger,自动配置 展开 收起

Loading...
README.md

SpringBootSwaggerStarter

在spring-boot中使用swagger,可以实现对代码无侵入地集成swagger

使用时的项目配置

需要在spring boot项目中使用,下面按照使用maven构建项目,以及使用application.properties文件来配置进行介绍, 如果使用其他的构建工具或配置文件,做相应的变更即可

在maven配置文件pom.xml中添加依赖

<dependency>
    <groupId>cn.songxinqiang</groupId>
    <artifactId>swagger-spring-boot-starter</artifactId>
    <version>x.y.z.RELEASE</version>
</dependency>

application.properties文件中配置api的信息

swagger.api.name = #api 的组信息
swagger.api.title = #标题
swagger.api.description = #描述信息
swagger.api.version = #版本
swagger.api.contactUser = #联系人名称
swagger.api.contactUrl = #联系人url
swagger.api.contactEmail = #联系人邮箱

具体的使用,请查看开源中国博客的介绍

swagger ui在使用时的配置

api的控制器会监听在地址v2/api-docs?group=<swagger.api.name配置的值>, 对于swagger ui来说需要指定服务器的“基础地址”为项目的根地址即可

或者可以直接添加依赖即可:

<dependency>
    <groupId>cn.songxinqiang</groupId>
    <artifactId>swagger-spring-boot-starter-ui</artifactId>
    <version>x.y.z.RELEASE</version>
</dependency>

说明

本组件应对的是在使用Spring MVC时的场景,只会处理@Controller,@RequestMapping等其他与之关联的注解

基于springfox-swagger2,本组件只是简单的配置了一下下,感谢他们

点评 ( 6 )

你可以在登录后,发表评论

搜索帮助