900字范文,内容丰富有趣,生活中的好帮手!
900字范文 > idea swagger生成接口文档_spring boot集成Swagger-UI接口文档

idea swagger生成接口文档_spring boot集成Swagger-UI接口文档

时间:2023-06-29 12:54:49

相关推荐

idea swagger生成接口文档_spring boot集成Swagger-UI接口文档

本文介绍如何用spring boot集成Swagger-UI,实现项目在线接口文档

一、Swagger-UI简介

Swagger是一个Restful风格接口的文档在线自动生成和测试的框架

官网对Swagger-UI的介绍:

简单的说就是:Swagger提供了一组静态页面,可以在SpringBoot应用中集成这些静态页面,直接访问静态页面,并打开指定的Swagger规范,就可以显示、测试调用接口:

而在SpringBoot中集成Swagger是非常容易的,仅需增加几个简单的注解。

效果如图:

二、在pom.xml中引入Swagger-UI相关依赖

三、如何配置Swagger2Config类

Swagger2Config类位于config包,用来配置swagger。

介绍一些简单的配置:

1、API接口文档的生成范围,即在页面显示你哪些API接口

Swagger对生成API文档的范围有三种不同的选择

生成指定包面的类的API文档下生成有指定注解的类的API文档生成有指定注解的方法的API文档

三种方式如图:

2、配置页面信息

对应关系如图:

三、如何给交易类配置注解

常用注解

@Api:用于修饰Controller类,生成Controller相关文档信息@ApiOperation:用于修饰Controller类中的方法,生成接口方法相关文档信息@ApiParam:用于修饰接口中的参数,生成接口参数相关文档信息@ApiModelProperty:用于修饰实体类的属性,当实体类是请求参数或返回结果时,直接生成相关文档信息

1、@Api

value - 字段说明

description - 注释说明这个类

对应:

2、@ApiOperation

value - 字段说明

notes - 注释说明

httpMethod - 说明这个方法被请求的方式

response - 方法的返回值的类型

3、@ApiModelProperty

value–字段说明

name–重写属性名字

dataType–重写属性类型

required–是否必填

example–举例说明

hidden–隐藏

4、@ApiResponse

code - 响应的HTTP状态码

message - 响应的信息内容

四、如何加authorizations

如项目集成了OAuth2或JWT等 用户验证,不能直接调用需要添加authorizations

可以从控制台拿到,添加后就可以自由调用

五、文档调用

http://localhost:8080/swagger-ui.html

看版本信息

http://localhost:8080/swagger-resources/

本内容不代表本网观点和政治立场,如有侵犯你的权益请联系我们处理。
网友评论
网友评论仅供其表达个人看法,并不表明网站立场。