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

巴黎的灯光下

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

设计说明

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

环境说明

我使用的是sqlalchemy这个ORM框架来处理数据库交互的。表结构的代码如下

1. from sqlalchemy import Column, String, Integer
   
2. from sqlalchemy.ext.declarative import declarative_base
   
3. 
   
4. BaseModel = declarative_base()
   
5. 
   
6. 
   
7. class ContractStructure(BaseModel):
   
8.     __tablename__ = 'contract_structure'
   
9.     id = Column(Integer, primary_key=True)
   
10.     contract_name = Column(String(500), nullable=False)
    
11.     contract_consumer_body = Column(String(10000), nullable=False)
    
12.     contract_consumer_keys = Column(String(500), nullable=False)
    
13.     contract_provider_body = Column(String(5000), nullable=False)
    
14.     contract_stakeholders = Column(String(500), nullable=False)
    
15.     contract_child_ids = Column(String(500), nullable=True)
    
16.     contract_version = Column(Integer, default=1)
    
17.     contract_last_version = Column(String(1), nullable=False, default='Y')
    
18.     provider_url = Column(String(100), nullable=True)
    
19. 
    
20. 
    
21. class ContractChild(BaseModel):
    
22.     __tablename__ = 'contract_child'
    
23.     id = Column(Integer, primary_key=True)
    
24.     child_id = Column(String(40), nullable=False)
    
25.     child_name = Column(String(100), nullable=False)
    
26.     contract_id = Column(Integer)
    
27.     child_consumer_body = Column(String(10000), nullable=False)
    
28.     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
生产端的报文内容

最后

以上，我们定义了工具的表，下面应该做的就是开始写具体的契约类。