SpringBoot项目集成swagger

作者 : 开心源码 本文共1340个字,预计阅读时间需要4分钟 发布时间: 2022-05-14 共312人阅读

Swagger是一个开源软件框架,由大型工具生态系统支持,可帮助开发人员设计,构建,记录和使用RESTful?Web服务。尽管大多数客户通过Swagger UI工具识别Swagger,但Swagger工具集包括对自动文档,代码生成和测试用例生成的支持。

使用了swagger我们能做什么呢?

想问一下广大的后台开发者能否为了在接口开完完成的时候由于需要些接口文档而烦恼,当然网上很多接口文档书写工具,但是从现在开始,你们可以省去写接口文档的时间了,不需要再为写接口文档而烦恼,使用了swagger能省去开发者省去写接口文档的时间,而且swagger是基于restful的接口框架,开发者只要要贴注解,写注释就能够自动生成接口文档,听起来是不是很强大很方便,没错swagger就是这么强大

如何在项目中集成swagger?

那么重点来了,下面就以SpringBoot项目集成swagger举例

首先需要导入Maven依赖

<groupId>io.springfox

? ? <artifactId>springfox-swagger2

? ? <version>2.7.0

? ? <groupId>io.springfox

? ? <artifactId>springfox-swagger-ui

? ? <version>2.7.0

</dependency>

接着新建一个swaggerconfig的配置类进行swagger独有的配置

可能到这里有有人问,这么快?没错,就是这么快,这么简单,我们的SpringBoot项目就集成了swagger了,接下来就是用了,下面就是各常用注解的使用。

@Api(description =”贴在类上,整个controller的注释”)

@ApiOperation(value =”贴在方法上,方法的注释”)

@ApiModelProperty(value =”贴在对象里的字段上”)

注:当你需要的参数是一个对象的时候,对象里的字段是不是无法进行注释,当你在字段上贴上此注解就可

@ApiImplicitParams?: 用在方法上包含一组参数说明。

@ApiImplicitParam:用来注解来给方法入参添加说明。

@ApiResponses:用于表示一组响应

@ApiResponse:用在@ApiResponses中,一般用于表达一个错误的响应信息

l?code:数字,例如400

l?message:信息,例如”请求参数没填好”

l?response:抛出异常的类

@ApiModel:形容一个Model的信息(一般用在请求参数无法使用@ApiImplicitParam注解进行形容的时候)

补充说明:

paramType:指定参数放在哪个地方header:请求参数放置于Request Header,使用@RequestHeader获取

query:请求参数放置于请求地址,使用@RequestParam获取

path:(用于restful接口)–>请求参数的获取:@PathVariable

body:(不常用)

form(不常用)

name:参数名?

dataType:参数类型?

required:参数能否必需传 true /false

value:说明参数的意思?

defaultValue:参数的默认值

总结的不好,请见谅!

说明
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » SpringBoot项目集成swagger

发表回复