SwaggerSpringBootStarter在 spring-boot 中使用 swagger

联合创作 · 2023-10-01 07:44

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

使用时的项目配置

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

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

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

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

#配置swagger的api信息
swagger.api.name = demo-api
swagger.api.title=Demo API
swagger.api.description=SwaggerSpringBootStarter 使用样例,一切就是这么简单
swagger.api.version=2.1.1
swagger.api.contact.name = 阿信sxq
swagger.api.contact.email = xinqiang.song@zycoo.com
swagger.api.contact.url = https://my.oschina.net/songxinqiang/
swagger.api.exclude-paths=/error,/admin/**

其中忽略路径使用英文逗号进行分隔,可以不进行配置

swagger ui在使用时的配置

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

需要单独准备swagger ui

可以使用maven坐标为

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

的webjar

使用演示

说明博客: https://my.oschina.net/songxinqiang/blog/1490463

使用演示可以查看 https://gitee.com/songxinqiang/SpringBootSwaggerStarter-Demo

浏览 9
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报