data-packer 1.0.1

简介

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目录