巴黎的灯光下 发表于 2019-4-11 14:56:16

从零开始写一个契约测试工具——数据库设计


接上文,第一步需要设计我们的表结构,我初步的构想是两张表来装下它,后续肯定会有一些变动,因为我也是一边写工具一边记录的。

设计说明

工具应该有两块内容,第一块是契约的信息,这部分记录的契约的结构体。第二快是子契约,所有具体的值必须由子契约来承载,子契约的内容一旦定义后是不可变更的。而契约工具对消费端和生产端的具体报文内容都由子契约来承载。

环境说明

我使用的是sqlalchemy这个ORM框架来处理数据库交互的。表结构的代码如下
from sqlalchemy import Column, String, Integer
from sqlalchemy.ext.declarative import declarative_base

BaseModel = declarative_base()


class ContractStructure(BaseModel):
    __tablename__ = 'contract_structure'
    id = Column(Integer, primary_key=True)
    contract_name = Column(String(500), nullable=False)
    contract_consumer_body = Column(String(10000), nullable=False)
    contract_consumer_keys = Column(String(500), nullable=False)
    contract_provider_body = Column(String(5000), nullable=False)
    contract_stakeholders = Column(String(500), nullable=False)
    contract_child_ids = Column(String(500), nullable=True)
    contract_version = Column(Integer, default=1)
    contract_last_version = Column(String(1), nullable=False, default='Y')
    provider_url = Column(String(100), nullable=True)


class ContractChild(BaseModel):
    __tablename__ = 'contract_child'
    id = Column(Integer, primary_key=True)
    child_id = Column(String(40), nullable=False)
    child_name = Column(String(100), nullable=False)
    contract_id = Column(Integer)
    child_consumer_body = Column(String(10000), nullable=False)
    child_provider_body = Column(String(5000), nullable=False)
下面我们一个一个来说明我这样设计的想法

ContractStructure

这个表是用来存放契约结构以及契约的一些相关信息。

contract_name
契约名称,一般来说方便认识的名字比较好,比如Consumer-Provider这种。

contract_consumer_body
契约消费者的结构体,也就是consumer端发起的报文。

contract_consumer_keys
契约消费者的结构体的key,由于契约测试中结构体是不可变的,因此必须要校验consumer端传过来结构的key值,用来确保报文结构的一致性

contract_provider_body
契约生产者的结构体,也就是返回给consumer端的报文结构

contract_stakeholders
契约的干系人,一旦契约发生变动,程序需要通知的对象

contract_child_ids
契约子内容的id

contract_version
契约的版本信息,一旦契约发生变更,那么版本也要对应的变更

contract_last_version
标记改版本的契约是否为最新的契约

provider_url
生产中的url地址,工具要能够给provider端发送契约内容,因此需要一个字段来记录url

contract_child

这个表用来存放子契约的内容

child_name
子契约对应的名字

contract_id
所属契约的id

child_consumer_body
消费端的报文内容

child_provider_body
生产端的报文内容

最后

以上,我们定义了工具的表,下面应该做的就是开始写具体的契约类。
页: [1]
查看完整版本: 从零开始写一个契约测试工具——数据库设计