yapi期望、mock、自动化测试及idea插件使用

时间:2024-10-26 07:47:15

一、项目基本配置

1、添加新接口

在这里插入图片描述
添加子节点
在这里插入图片描述

2、接口请求/插件安装

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

3、同一个接口,不同参数来区别不同的服务/自动化测试

用测试集合来使用

在这里插入图片描述

# 回归测试,批量测试。

配置成功标识 (根据实际情况判断)

在这里插入图片描述

(body.sys_header.status, “true”)

导入需要测试的接口

在这里插入图片描述

添加请求参数

在这里插入图片描述

在这里插入图片描述

4、测试用例成功判断

开启test,并书写断言内容,判断接口是否正确执行(此判断需与全局判断同时正确,接口才会验证通过)

在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

断言语法:

断言脚本公共变量

/dist//docs/api/

二、mock

YApi的 Mock 功能可以根据用户的输入接口信息如协议、URL、接口名、请求头、请求参数、返回数据(返回数据)生成 Mock 接口,这些接口会自动生成模拟数据,创建者可以*构造需要的数据。

1、模拟请求参数

1)JSON-SCHEMA

在这里插入图片描述

开启 json-schema 功能后,根据 json-schema 定义的数据结构,生成随机数据。

例:

生成1开头的数字字符串 长度为6,需要在字段的mock处配置:

在这里插入图片描述

结果:自动生成请求参数

在这里插入图片描述

重点:如果不是以@字符开头的话或者匹配不到Mockjs中的占位符就会直接生成输入的值

更多占位信息参考 /#DPD

2)json

在这里插入图片描述

在运行页面 数据不会出现更新
在这里插入图片描述

在点击发送后,可以看到请求的数据已经生成

在这里插入图片描述

3)from

在这里插入图片描述

但是在运行页面 数据不会出现更新

在这里插入图片描述

在点击发送后,可以看到请求的数据已经生成

在这里插入图片描述

也可以配置所有请求都是json作为参数的形式,在 设置->请求配置->Pre-request Script配置如下信息

[‘Content-Type’] = “application/json”;

在这里插入图片描述

2、模拟返回数据

此处主要用在通过Mock地址访问接口时模拟的数据,请求后台接口不会走该通道

在这里插入图片描述

书写方式及更多信息:/yapi/documents/

3、Mock 期望

在测试时,很多时候需要根据不同的请求参数、IP 返回不同的 HTTP Code、HTTP 头和 JSON 数据。

Mock 期望就是根据设置的请求过滤规则,返回期望数据。

此处同样是通过mock地址访问接口时才会生效

点击接口->高级mock->期望->添加期望

在这里插入图片描述
在这里插入图片描述

请求参数中id==110002时会返回指定的结果,在body内 可以书写mock脚本

4、自定义脚本

用处与[Mock 期望](#_Mock 期望)相同,只存在于写法的区别

三、自动化测试

测试集合内的测试用例是与接口索引关联的,若接口改变,则测试用例的相关配置也会改变(参数值不会)

1、基本操作

测试集合->添加集合->导入接口

测试集合内的执行顺序:

在这里插入图片描述

配置通用规则

在这里插入图片描述

详情参考 一.3 配置成功标识(只针对当前的项目判断,其他项目许根据实际情况判断)

2、配置请求参数的方式

1)mock生成数据(不需要通过接口获取/不必要数据):

在这里插入图片描述

在这里插入图片描述

参考 二.1.1) 二.1.2)

2)接口返回数据:

首先查看需要调用的接口Key

在这里插入图片描述

使用$.key定位到指定的接口,如图:

在这里插入图片描述

3)配置接口断言

通用断言详情参考 一.3

和 一.4

4)开始测试:

在这里插入图片描述

可看到413的返回结果:
在这里插入图片描述

417的请求参数如图:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-uC1lpLRg-1598581672328)(C:\Users\ADMINI~1\AppData\Local\Temp\ksohtml3236\)]

详情参考:

/yapi/documents/

四、插件的使用(EsayYapi)

Easyyapi官方文档:/documents/

1、安装

Install

重启

打开File->settings 配置server

在这里插入图片描述

不要配置token,在第一次上传的时候配置(此处tokens包含多个项目的token)

可选默认配置:

在这里插入图片描述

上传为上传一个类下的所有api

2、操作

1)上传

在这里插入图片描述

如果要求yapi的请求参数为json格式,需要在接收实体前使用@RequestBody

2)配置

注释规范及demo:/documents/

注解的第一行为分类名/方法名/参数名

@module 指定当前接口/类对应的项目(不指定则为项目对应的yapi项目,可以在settings修改对应的token)

在这里插入图片描述

@ignore 忽略当前的接口/类

@deprecated 代表当前接口(类下所有接口)已废弃,效果:

在这里插入图片描述

@see 参数字段上的注解,用于指定枚举类

在这里插入图片描述

注解@(确保类正确即可,不用写全路径)的字段会被忽略

在这里插入图片描述

@mock 标记字段对应的mock信息

在这里插入图片描述

3)扩展操作(根据官方文档提供的支持拓展 自定义一些注释内标识)

新建.文件 放到项目根目录下

=#open
[#undone]=#undone
=#required
=POST
=#ignore

@open 标记接口公开

@undone 标记接口未完成(默认为完成状态)

@required 标记字段必传

@ignore 标记字段忽略

=POST默认为post请求

=… 请求的前缀(class的路径前)

4)对javaxValidtion的支持(通过javax的validation注解生成对应的mock规则)

在这里插入图片描述

更多映射关系查看:/setting/rules/field_mock.html

5)脚本

规则详情:/setting/

参考资料:

Yapi教程:/yapi/documents

断言语法(2个):
断言脚本公共变量

/dist//docs/api/

mockjs:/#DPD

EsayYapi: /documents/