接口测试复习

接口测试复习
一。基本概念

接口概念：系统与系统之间数据交互的通道。

接⼝测试概念：校验预期结果与实际结果是否⼀致。

特征：

        测试⻚⾯测试发现不了的问题。（因为：接⼝测试绕过前端界⾯。 ）

        符合质量控制前移理念。

        低成本，⾼收益。

实现⽅式

        ⼯具实现： Postman ：使⽤简单。功能较少。

Jmeter：功能完善，上⼿难度⼤。

        代码实现： python + requests + pytest

java + HttpClient

二。HTTP协议

协议：就是规则。要求使⽤的双⽅，必须严格遵守。

HTTP 协议简介

        HTTP概念：超⽂本传输协议。基于客户端和服务器的应⽤层协议。

        特性： 1.客户端、服务器模式 2.简单快速 3.灵活 4.⽆状态 5.⽆连接

URL

定义：URL（uniform Resource Locator) 统一资源定位符，网络资源地址

HTTP使用URL来来建立连接和传送数据

URL组成：协议://hostname[:port]/path/[?查询参数1&查询参数2]

格式：协议 :// 域名 : 端⼝号 / 资源路径？查询参数 1& 查询参数 2...

协议：指定数据传输的规则：http 和 https

域名：在⽹络环境中，定位⼀台主机。本质：IP 地址

端⼝号：在⽹络主机上，定位⼀个进程（应⽤程序）。可以省略，端⼝号跟随协议。

        http： 80

        https： 443

资源路径：指定要访问的数据资源。可以没有。如果没有，默认值为 “/”

查询参数：给数据资源传递的参数。可以有多个，

⽤ & 隔分每⼀组查询参数，采⽤ k=v 键值对格式

下面URL的各个组成部分

http://www.weather.com.cn/data/sk/101010100.html

协议：http

域名：www.weather.com.cn

端口：80

资源路径：/data/sk/101010100.html

查询参数：无

三。HTTP请求

产⽣端：⼀定产⽣于客户端。

数据格式：请求行，请求头，请求体

整体格式

        请求⾏（http 请求第⼀⾏）

        请求头（第⼆⾏开始，到空⾏之前）

        空⾏（代表请求头结束）

        请求体（空⾏之后，直到结束）

示例：

POST http://demo.zentao.net/user-login.html HTTP/1.1

Host: demo.zentao.net

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101

Firefox/68.0

Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8

Accept-Language: zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2

Accept-Encoding: gzip, deflate

Referer: http://demo.zentao.net/user-login.html

Content-Type: application/x-www-form-urlencoded

Content-Length: 54

Connection: keep-alive

Upgrade-Insecure-Requests: 1

account=demo&password=efc4a3b32e48054865e5a8321cfda3e4

请求⾏组成：请求⽅法（空格）URL （空格）协议版本

请求⽅法：

        get：查询 —— 没有请求体

        post：添加（登录、注册）

        put：修改

        delete：删除 —— 没有请求体

URL ：语法格式⻅上。

协议版本：默认常⽤ HTTP/1.1

请求头

内部所有数据，均采⽤ k:v 语法格式 .

Content-Type：请求体数据类型

 text/html： HTML格式

 text/plain：纯文本格式

 image/jpeg：jpg图片格式

 application/json： JSON数据格式

 application/x-www-form-urlencoded：表单默认的提交数据格式

 multipart/form-data：在表单中进行文件上传时使用

请求体

        get、 delete 请求，没有请求体

        post、 put 请求，有请求体

        请求体中的数据类型，受请求头中 Content-Type 的值影响。

        位置：空白行之后的内容

        作用：传输数据实体

        请求体常在POST、PUT方法中使用

        常配合的请求头：Content-Type和Content-Length

四。HTTP响应

产⽣端：

⼀定是在服务器接受到 http 请求后，回发响应数据。

整体格式

响应⾏（第⼀⾏）

响应头（第⼆⾏开始，到空⾏结束）

空⾏（表示响应头结束）

响应体（空⾏，直到结束）

响应行也叫状态行

        位置：响应数据中第一行

        作用：描述服务器处理结果

        内容：状态行由协议版本号、状态码、状态消息组成

状态码三位数字组成，第一个数字定义响应类别：

 1xx：指示信息

 2xx：成功

 3xx：重定向

 4xx：客户端错误

 5xx：服务器端错误

响应头

位置：第二行开始到空白行之间

作用：描述客户端要使用的一些附加信息

特点：响应头由键值对组成，每行一对

响应体

位置：响应数据空白行之后

作用：服务器返回的数据实体

特点：有图片、json、xml、html等多种类型

四。接口规范

传统接口特性：

        请求⽅法，统⼀使⽤ get 或 post

        针对⼀个资源的操作，URL 不唯⼀

        响应状态码统⼀使⽤ 200 表示

RESTful ⻛格接⼝

        特性：请求⽅法，与 http 协议对应。

                get —— 查询

                post —— 添加

                put —— 修改

                delete —— 删除

针对⼀个资源的操作， URL 唯⼀。只看 URL ⽆法确定具体操作。

状态码使⽤较灵活

五。接口测试流程

1. 需求分析（产品经理产出的需求⽂档）

2. 接⼝⽂档解析（由开发产出接⼝⽂档）

3. 编写接⼝测试⽤例（将⽤例⽤ Excel形式表现）

4. 编写接⼝测试脚本

⼯具（postman）⽣成脚本

代码（python）编写，⽣成脚本

5. 执⾏脚本，跟踪缺陷

6. ⽣成接⼝测试报告

7. （可选）接⼝⾃动化持续集成

六。接口文档解析

接口文档：又称为API文档，是由后端开发编写，用来描述接口信息的文档。

为什么要写接口文档？协同：团队人员工作协同配合。约束：项目更新修改同步维护

接口解析要关注的核心要素？

1.请求报文：请求方法/请求路径/请求数据

2.响应报文：响应状态码/响应数据

接口文档的内容：

基本信息：接口名称、接口描述

请求参数：1. 请求方法 2. 请求路径3.请求头 4.请求数据：字段、说明、类型、备注、是否必填

返回参数：1. 响应状态码 2.响应数据：字段、说明、类型、备注、是否必填 3.data结构类型

七。Requests库

resp = requests.请求方法(url='URL地址', params={k:v}, headers={k:v},
   data={k:v}, json={k:v}, cookies='cookie数据'(如：令牌))
请求方法：
   get请求 - get方法
   post请求 - post方法
   put请求 - put方法
   delete请求 - delete方法

url：要访问的地址    - string类型
params：查询参数       - 字典
headers：请求头       - 字典
data：表单格式请求体数据 - 字典 -
json：json格式请求体数据 - 字典 -

cookies：用来传递cookies

resp：代表响应结果。
==获取指定响应数据==

常用：
- 获取 URL： resp.url
- ==获取响应状态码：resp.status_code==
- 获取 Cookie：resp.cookies
- 获取响应头：resp.headers
- 获取响应体：
  
  文本格式：resp.text
  
  ==json格式：resp.json()==。如果看到 JSONDecodeError 错误提示，说明不能转换为 json
八。cookies和session

设置cookies

获取cookies:cookies=response.cookies

requests.get(url,cookies={"c1":"v1"}

Cookie简介
- cookie 是工程师，针对 http协议是无状态这一特征，设计的一种技术。
- cookie 将数据保存在浏览器端。默认存储空间大小为 4k（可以修改）。
- cookie 中的数据，用户和随意获取，没有安全性可言。
- cookie 中存放的数据类型，受浏览器限制。
- cookie 中大多存放于网络通信相关的不敏感数据信息。提高访问速度。如：用户名、登录状态等。
Session简介

概念：也叫会话！从客户端登录服务器开始，直到客户端退出登录，所产生的所有通信数据，保存在 session中。
- session 将数据存在服务器端
- session 使用服务器存储空间，没有大小限制。
- session 支持的数据类型，受服务器主机影响。几乎支持所有数据类型。
- session 中的数据，大都采用加密、转码存储。安全性较高。
Session自动管理Cookie

因为，cookie中的数据，都是由 session 提供的。
实现步骤：
1. 创建 session 对象(实例)。 my_session = requests.Session()【注意：() 不能丢！！！】
2. 使用 session实例，调用get方法，发送获取验证码请求（不需要提取cookie）。 my_session.get()
3. 使用同一个 session实例，调用post方法，发送登录请求（不需要携带cookie）。my_session.post()
4. 使用同一个 session实例，调用get方法，发送查看我的订单页面请求（不需要携带cookie）。my_session.get()
# 导包
import requests

# 1. 创建session实例
my_session = requests.Session()

# 2. 使用session实例，调用 get方法，发送获取验证码请求
resp1 = my_session.get(url="http://tpshop-test.itheima.net/index.php?m=Home&c=User&a=verify")
# print(resp1.text)

# 3. 使用同一个session实例，调用 post方法，发送登录请求。（正确用户名、密码）
resp2 = my_session.post(url="http://tpshop-test.itheima.net/index.php?m=Home&c=User&a=do_login",
data={"username": "13812345678", "password": "123456", "verify_code": "8888"})
print("登录结果：", resp2.json())

# 4. 使用同一个session实例，调用 get方法，查询我的定义页面。
resp3 = my_session.get(url="http://tpshop-test.itheima.net/Home/Order/order_list.html")

# 5. 打印响应结果
print("我的订单页面：", resp3.text)

面试题 Cookie 和 Session 区别
1. 数据存储位置：
  - Cookie 存储在浏览器端
  - Session 存储在服务器端
2. 安全性：
  - Cookie 直接存储在浏览器，可以任意获取，没有安全性可言。
  - Session 存储在服务器端，采用加密、转码形式存储数据，安全性较高。
3. 数据类型
  - Cookie 直接存储在浏览器，支持测试数据类型受浏览器限制
  - Session 存储在服务器端，服务器就是一台主机。因此几乎支持所有的数据类型。
4. 大小：
  - Cookie 默认大小 4k（可调）
  - Session 直接使用服务器存储。没有大小限制。
九。PyMySQL操作数据库
==操作步骤==
1. 导包 import pymysql
2. 创建连接 conn = pymyql.connect()
3. 创建游标 cursor = conn.cursor()
4. 执行 SQL 语句 cursor.execute( “sql 语句” )
  
  查询语句 select —— 不修改数据库，会返回结果集
  
  从结果集中，提取想要的数据 cursor.fetch*()
  
  增删改语句 insert、update、delete —— 没有结果返回，会修改数据库
  
  执行成功：提交事务。conn.commit()
  
  执行失败：回滚事务。conn.rollback()
5. 关闭游标 cursor.close()
6. 关闭连接 conn.close()
十。日志收集

日志

日志就是用于记录系统运行时的信息，对一个事件的记录；也称为 Log
有哪些信息需要记录？

• 脚本运行过程中某个重要变量的值

• 方法的输入参数和返回结果

• 异常信息
日志作用：

1.调试程序

2.了解系统程序运行的情况，是否正常

3.系统程序运行故障分析与问题定位

4.用来做用户行为分析和数据统计

日志级别

日志级别：是指日志信息的优先级、重要性或者严重程度

当为程序指定一个日志级别后，程序会记录所有日志级别大于或等于指定日志级别的日志信息，而不是仅仅记录指定级别的日志信息；

一般建议只使用DEBUG、INFO、WARNING、ERROR这四个级别

日志收集的位置：

控制台：方便自动化测试脚本的调试

日志文件：可以把日志长久的保存起来

需要达成的效果：

1. 可以把日志输出到不同位置

        控制台

        日志文件（防止日志文件过大，每日生成一个日志文件）

2. 记录更加详细的日志信息

        打印日志的时间

        日志的级别

        打印日志的位置

        日志内容

3. 可以打印不同级别的日志如 INFO ERROR

十一。代码分层

分层思想：

按代码功能，划分为接口对象层、测试脚本层

接口对象层：

负责发送 http请求，访问待测接口。返回响应数据。

测试用例层（测试脚本层）：

调用接口，按响应数据，断言完成测试。
封装思想：
- 将普通方式实现代码中，固定不变的，直接写到方法的实现内部。
- 将动态变化的，从参数传入。
- 将响应结果，通过返回值 return
十二。Unittest框架

unittest是Python标准库中的一个单元测试框架，用于编写和执行单元测试。它提供了一组用于编写测试用例、运行测试以及生成测试报告的类和方法。

下面是unittest框架的一些重要概念和使用方法：
1. 测试用例（Test Case）：测试用例是单元测试的最小单位，它是一个独立的测试单元，用于验证代码的某个具体功能或行为。通常继承自unittest.TestCase类，并包含一个或多个测试方法。
2. 测试方法（Test Method）：测试方法是测试用例中的一个函数，以test_开头，用于执行具体的测试逻辑。可以在测试方法中使用断言（assert）来验证预期结果和实际结果是否一致。
3. 测试套件（Test Suite）：测试套件是由多个测试用例组成的集合，用于按照一定顺序运行多个测试。
4. 测试运行器（Test Runner）：测试运行器是用于执行测试的工具，可以运行单个测试用例、单个测试模块或整个测试套件，并生成测试报告。
5. 断言方法（Assertion Methods）：断言方法是用于验证测试结果的方法，可以判断实际结果与预期结果是否相等、是否为真等。例如，assertEqual()用于判断两个值是否相等。
十三。参数化
参数化步骤
1. 将测试数据，按 [{},{},{}] 格式组织到 json文件中。
2. 读取 json文件，将数据转换为 [(),(),()]
3. 在通用测试方法上一行，添加 @pytest.mark.parameterize()
4. 给 parameterize() 传参。参1：字符串类型，内容为 json文件中一组数据的 key。参2：[(),(),()]格式数据。
5. 给通用测试方法添加形参，与 parameterize() 参1 字符串的内容一致。
6. 修改通用测试方法内部实现，使用形参。
```
# 将测试数据 组织到 json文件中
[
  {"x": 10, "y": 20, "expect": 30},
  {"x": 100, "y": 200, "expect": 300},
  {"x": 1000, "y": 2000, "expect": 3000}
]
--------------------------------------------------------------
import pytest
import json
 
# 待测 函数
def add(x, y):
    return x + y
 
# 封装函数，读取json文件，将 [{},{},{}] 数据 转换为 [(),(),()] 格式的数据
def read_json_data(filename):
    with open(filename, "r", encoding="utf8") as f:
        json_data = json.load(f)
        data_list = []
        for data in json_data:
            val = data.values()
            tmp = tuple(val)
            data_list.append(tmp)
        # 必须返回，不能在 for 内
        return data_list  # 返回 [(10, 20, 30), (100, 200, 300), (1000, 2000, 3000)]
 
# 结合 pytest 定义测试类
class TestAddFunc(object):
    @pytest.mark.parametrize("x, y, expect", read_json_data("add_data.json"))  # 参2 要求必须是 [(),(),()] 格式的数据
    def test_add(self, x, y, expect):  # 通用测试方法
        res = add(x, y)  # 调用 待测函数，得实际结果
        assert expect == res  # 断言
```
十四。接口自动化测试框架
目录结构
- api/：接口对象层（代码：python package）
- scripts/：测试脚本层（代码：python package）
- common/：通用工具方法、函数（代码：python package）
- data/：测试数据文件（文件：dir）
- report/：测试报告（文件：dir）
- config.py: 项目中的配置信息。（全局变量）
- pytest.ini: pytest 配置
1.在data/下组织数据文件

2.
1. 在 common/ 下创建文件 read_json_file.py
2. 在文件内，创建函数，读取json文件中的数据，转换成 [(),(),()] 格式数据
3. 测试此函数功能通过
4. 建议读取 json文件时，使用绝对路径法传入文件名
5. 在 config.py 中，添加全局变量，获取项目目录 BASE_DIR = os.path.dirname(__file__)
6. 拼接 json文件的绝对路径 filename = BASE_DIR+"/data/login_data.json"
7. 使用绝对路径，传入 json文件读取函数。 read_json_data(filename)
```
import json
 
# 定义工具函数，读取json文件中的数据，转换成 [(),(),()] 格式数据
def read_json_data(filename):
    with open(filename, "r", encoding="utf8") as f:
        json_data = json.load(f)
        login_list = []
        for data in json_data:
            tmp = tuple(data.values())
            login_list.append(tmp)
 
        return login_list
 
if __name__ == '__main__':
    res = read_json_data("../data/login_data.json")
    print(res)
```
3.在common下写断言工具和数据库操作类

4.在api下写登录工具和员工管理工具

5.解决重复手机号问题，
- 在测试添加员工接口前（setup），保证数据库中，无此手机号！执行 delete SQL语句，将欲使用的手机号删除。
- 使用这个手机号，展开添加员工接口的测试。
- 在测试添加员工接口结束后（teardown），删除添加员工接口测试时，使用的手机号。
```
    def setup(self):
        del_sql = f"delete from bs_user where mobile='{TEL}';"
        DBTools.db_uid(del_sql)
 
    def teardown(self):
        del_sql = f"delete from bs_user where mobile='{TEL}';"
        DBTools.db_uid(del_sql)
```
6.获取请求头
1. 在 common/ 下创建文件 get_header.py
2. 文件中添加代码，获取请求头，并测试无误
```
from api.ihrm_login_api import IhrmLoginApi
 
def get_header():
    req_data = {"mobile": "13800000002", "password": "123456"}
    resp = IhrmLoginApi.login(req_data)
    header = {"Authorization": resp.json().get("data")}
    return header
 
if __name__ == '__main__':
    ret = get_header()
    print(ret)
```
7.生成测试报告，储存在report目录下

十五。全量字段校验

十六。Dubbo
相关阅读:
【无标题】
AI伦理：科技发展中的人性之声
 酷宇宙观点：万物金融化，定义下一个金融服务时代
 2023辽宁省数学建模B题数据驱动的水下导航适配区分类预测完整原创论文分享（python求解）
TiDB x 北京银行丨新一代分布式数据库的探索与实践
 操作系统——处理机调度
 如何在JavaScript中使用高阶函数
 基于 GPS 的 NTP 时间同步服务器
 Golang-RSA2签名及验签
 Small RTOS51 学习笔记（8）信号量
原文地址：https://blog.csdn.net/qq_51250393/article/details/133498449

一。基本概念

二。HTTP协议

三。HTTP请求

四。HTTP响应

四。接口规范

五。接口测试流程

六。接口文档解析

七。Requests库

八。cookies和session

Cookie简介

Session简介

面试题 Cookie 和 Session 区别

九。PyMySQL操作数据库

十。日志收集

十一。代码分层

十二。Unittest框架

十三。参数化

十四。接口自动化测试框架

十五。全量字段校验

十六。Dubbo