干货 | 通用 api 封装实战,带你深入理解 PO

电商数据girl 2023-08-14 09:07:43

理念

 

 

apiobject设计模式可以简单分为6个模块,分别是API对象(淘宝/京东/1688平台API接口)、接口测试框架、配置模块、数据封装、Utils、测试用例。

  • 接口测试框架:base_api,完成对api的驱动

  • API对象:继承base_api后,完成对接口的封装

  • 配置模块:完成配置文件的读取

  • 数据封装:数据构造与测试用例的数据封装

  • Utils:其他功能封装,改进原生框架不足

  • 测试用例:调用Page/API对象实现业务并断言

枯燥的讲述概念可能难以理解,后面的章节都会围绕这些模块进行理论的拆解和实例的演示。

 

 

api 模式应用

 

 

 

在这里将会结合企业微信的部门管理,获取部门列表接口作为一个接口测试用例,从没有封装到使用apiobject设计模式进行封装改造。将实战与理论结合,更深入理解apiobject设计模式。

 

 

 

环境准备

 

 

 

 

企业微信服务端API:https://work.weixin.qq.com/api/doc/90000/90135/90664。不加任何封装和改造的企业微信,获取部门列表接口测试用例

 

  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
import requests

class TestDemo:
    def test_get_token(self):        r = requests.get(url="https://qyapi.weixin.qq.com/cgi-bin/gettoken",            params={"corpid": "ww93348658d7c66ef4", "corpsecret": "T0TFrXmGYel167lnkzEydsjl6bcDDeXVmkUnEYugKIw"})        return r.json()["access_token"]
    def test_department_list(self):        r = requests.get(url="https://qyapi.weixin.qq.com/cgi-bin/department/list",            params={"access_token": self.test_get_token(), "id": 1})        assert r.json()["errcode"] == 0        return print(r.json())

 

 

 

思路

 

 

 

  • api

    • base_api.py是用来封装所有api的通用方法,比如打印log、对断言工具做二次封装等,不牵涉和业务相关的操作

    • wework.py继承base_api并实现基本业务,之后所有的具体的业务资源继承自wework,比如token的获取等;

    • department继承自wework,用来实现对应模块具体的业务逻辑,比如发送请求,请求内有什么参数等等。

  • testcases文件夹内统一存放所有的测试用例,调用API对象实现业务并断言

  • utils文件夹内存放对其他功能封装,改进原生框架不足

  • data文件夹数据构造与测试用例的数据封装此外,还有配置模块与数据封装会在后面的章节进行具体的介绍

 

 

 

实战案例

 

 

utils.py,在此文件中封装一个jsonpath方法。

 

  •  
  •  
  •  
  •  
  •  
  •  
  •  
import jsonfrom jsonpath import jsonpath
class Utils:    @classmethod    def jsonpath(cls, json_object, expr):        return jsonpath(json_object, expr)

 

base_api.py,在此文件中调用utils中的jsonpath方法。

 

  •  
  •  
  •  
  •  
  •  
  •  
  •  
from test_wework.utils.Utils import Utils
class BaseApi:    json_data = None
    def jsonpath(self, expr):        return Utils.jsonpath(self.json_data, expr)

 

wework.py,继承类BaseApi,实现token的获取。将在后面“通用api封装”章节中详细讲述函数内部的设计。

 

  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
class WeWork(BaseApi):    corpid = "ww93348658d7c66ef4"    contact_secret = "T0TFrXmGYel167lnkzEydsjl6bcDDeXVmkUnEYugKIw"    token = dict()    token_url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken"
    @classmethod    def get_token(cls, secret=contact_secret):        # 避免重复请求,提高速度        if secret not in cls.token.keys():            r = cls.get_access_token(secret)            cls.token[secret] = r["access_token"]        return cls.token[secret]
    @classmethod    def get_access_token(cls, secret):        r = requests.get(cls.token_url, params={"corpid": cls.corpid, "corpsecret": secret})        return r.json()

 

department.py,继承类WeWork,发起一个get请求,获取department的list。

 

  •  
  •  
  •  
  •  
  •  
  •  
class Department(BaseApi):    list_url = "https://qyapi.weixin.qq.com/cgi-bin/department/list"
    def list(self, id):        self.json_data = requests.get(self.list_url, params={"access_token": WeWork.get_contact_token(), "id": id}).json()        return self.json_data

 

test_department.py,断言返回值中的第一个name是否为“WestWayyt”。

 

  •  
  •  
  •  
  •  
  •  
  •  
class TestDepartment:    department = Department()
    def test_department_list(self):        r = self.department.list(1)        assert self.department.jsonpath(expr="$..name")[0] == "WestWayyt"

 

 

通用 api 封装实战

 

 

在apiobject设计模式中,需要一个“base_api”作为其他api步骤的父类,把通用功能放在这个父类中,供其他的api直接继承调用。这样做的优点在于,减少重复代码,提高代码的复用性。

 

上文在演示使用api-object设计模式对脚本进行改造时提到了base_api。不过在上文,仅仅只是封装了一个utils中的一个简单方法。并没有完全体现出base_api的实际作用。

 

接下来会通过通用接口协议的定义与封装实战,实际体会一下base_api的巧妙之处。

base_api.py,在代码内,对request进行一层封装,当然在这里还看不出来具体的优势:

 

  •  
  •  
  •  
  •  
  •  
  •  
  •  
import requests
class BaseApi:
    def request(self, method, url, **kwargs):        self.json_data = requests.request(method=method, url=url, **kwargs)        return self.json_data

 

wework.py,继承于类BaseApi,可以直接调用父类中的request方法(不需要导入requests库),从而发起一个get请求:

  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
from test_interface.test_wework.api.base_api import BaseApi
class WeWork(BaseApi):    corpid = "ww93348658d7c66ef4"    contact_secret = "T0TFrXmGYel167lnkzEydsjl6bcDDeXVmkUnEYugKIw"    token = dict()    token_url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken"
    def get_access_token(self):        r = self.request(method="get", url=self.token_url,                         params={"corpid": self.corpid, "corpsecret": self.contact_secret})        return r.json()

 

test_wework.py,继承于类WeWork,主要目的只是为了检查上面的get_access_token(self) 是否成功:

  •  
  •  
  •  
  •  
  •  
  •  
  •  
from test_interface.test_wework.api.wework import WeWork
class TestWeWork(WeWork):
    def test_get_access_token(self):        r = self.get_access_token()        assert r["errcode"]==0

 

在上面的案例中,在base_api.py中对 requests 进行了多一层的封装,这样子,只要是属于BaseApi这个类的子类,都可以无需引用而直接调用 requests 库。从而发起各种各样的请求,实现了通用接口协议的定义与封装。

...全文
14 回复 打赏 收藏 转发到动态 举报
写回复
用AI写文章
回复
切换为时间正序
请发表友善的回复…
发表回复

1,370

社区成员

发帖
与我相关
我的任务
社区描述
加入“谷歌开发者”社区,一起“共码未来。
android 企业社区
社区管理员
  • 谷歌开发者
  • 开发者大赛发布
  • 活动通知
加入社区
  • 近7日
  • 近30日
  • 至今
社区公告
暂无公告

试试用AI创作助手写篇文章吧