Skip to content

A python library is convenient for build expected data from original data.

License

Notifications You must be signed in to change notification settings

ideascf/data-packer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

简介

data-packer是一个数据打包工具。将通过一系列操作将数据从传入数据容器导入到传出容器中. 数据打包中的一个字段打包,将由以下步骤构成:

  1. 从传入数据容器中获取数据
  2. 遍历字段校验器列表,对该字段进行校验(如过用户传入了). 以检查传入数据的:类型,长度,取值等是否合法
  3. 遍历字段转换器列表,对该字段值进行转换(如果用户传入了). 以便将传入数据值转换为我们期望的格式/类型等
  4. 设置转换后的字段值到传出数据容器

定义

  • data-packer是字段提取,校验,打包的工具包.
  • 将数据打包逻辑中设计到的实体抽象为:
    • 字段 定义不同类型的字段,相互组合形成最终的期望的数据组成结构
    • 校验器 当需要对原始数据进行校验时使用, 如校验数据类型,取值范围
    • 转换器 当原始数据需要进一步加工处理时使用. 比如长度截取,类型转换等
    • 数据容器 将原始数据和目的数据抽象为数据容器,便于再数据打包过程中处理

组成

  • field包,用来定义常见的字段类型。 如:
    • 必填字段(RequiredField)
    • 可选字段(DefaultField)
    • 缺省值字段(DefaultField)
    • 占位字段(PlaceholderField)
    • 多选字段(SelectorField)
    • 组合字段(CompositedField)
  • checker包: 定义字段校验器类, 用于校验传入容器中的字段值是否合法
  • converter包: 定义字段值转换器类, 用于按需转换传入数据容器中的字段值
  • container包: 定义一些数据容器类, 用于封装原始数据和目的数据,以便于数据打包

应用场景

  1. 微信支付业务中,封装到微信的请求数据,解析微信的返回数据。
  2. web业务中,解析并转换web端传入的请求数据。
  3. 服务提供端:预定义一系列的DataPacker对象,用于验证和转换 前段传入的数据为内部可用的数据容器。
  4. 服务请求端:按照服务提供方要求的数据格式创建好DataPacker对象后,将请求的原始数据容器快捷方便的转为服务提供方需要的格式。

示例

参见example目录

About

A python library is convenient for build expected data from original data.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages