127 lines
3.9 KiB
Markdown
127 lines
3.9 KiB
Markdown
[//]: # (Author: bug)
|
||
[//]: # (Date: 2020-11-01 16:26:41)
|
||
|
||
# json 数据源
|
||
|
||
## json数据格式
|
||
|
||
|
||
大多数数据格式填法符合直觉，有几个数据类型的格式比较特殊：
|
||
- set类型。填法为 [v1,v2,...]
|
||
- map类型。由于json只支持string类型的key，因此map格式填法为 [[k1,v1],[k2,v2]...]
|
||
- 多态bean类型。需要 \_\_type\_\_ 属性来指定具体类型名。
|
||
- text类型，填法为 {"key":key, "text":text}
|
||
|
||
不同数据结构在json中格式示例如下：
|
||
|
||
```xml
|
||
<bean name="DemoType2" >
|
||
<var name="x4" type="int"/>
|
||
<var name="x1" type="bool"/>
|
||
<var name="x5" type="long"/>
|
||
<var name="x6" type="float"/>
|
||
<var name="x7" type="double"/>
|
||
<var name="x10" type="string"/>
|
||
<var name="t1" type="text"/>
|
||
<var name="x12" type="DemoType1"/>
|
||
<var name="x13" type="DemoEnum"/>
|
||
<var name="x14" type="DemoDynamic"/>
|
||
<var name="v2" type="vector2"/>
|
||
<var name="v3" type="vector3"/>
|
||
<var name="v4" type="vector4"/>
|
||
<var name="t1" type="datetime"/>
|
||
<var name="k1" type="array,int"/>
|
||
<var name="k2" type="list,int"/>
|
||
<var name="k8" type="map,int,int"/>
|
||
<var name="k9" type="list,DemoE2"/>
|
||
<var name="k15" type="array,DemoDynamic" />
|
||
</bean>
|
||
```
|
||
|
||
示例json文件内容如下
|
||
|
||
```json
|
||
{
|
||
"x1":true,
|
||
"x2":3,
|
||
"x3":128,
|
||
"x4":1,
|
||
"x5":11223344,
|
||
"x6":1.2,
|
||
"x7":1.23432,
|
||
"x10":"hq",
|
||
"t1": {"key":"/key/xx1","text":"apple"},
|
||
"x12": { "x1":10},
|
||
"x13":"B",
|
||
"x14":{"__type__": "DemoD2", "x1":1, "x2":2},
|
||
"v2":{"x":1, "y":2},
|
||
"v3":{"x":1.1, "y":2.2, "z":3.4},
|
||
"v4":{"x":10.1, "y":11.2, "z":12.3, "w":13.4},
|
||
"t1":"1970-01-01 00:00:00",
|
||
"k1":[1,2],
|
||
"k2":[2,3],
|
||
"k7":[2,3],
|
||
"k8":[[2,2],[4,10]],
|
||
"k9":[{"y1":1, "y2":true},{"y1":2, "y2":false}],
|
||
"k15":[{"__type__": "DemoD2", "x1":1, "x2":2}]
|
||
}
|
||
```
|
||
|
||
## 以复合json文件形式组织
|
||
|
||
整个表以一个或者多个json文件的形式组织。在table的input属性中手动指定json数据源，有以下几种格式：
|
||
- xxx.json，把xxx.json当作一个记录读入。
|
||
- *@xxx.json，把xxx.json当作记录列表读入。
|
||
- field@xxx.json，把 xxx.json中的field字段当作一个记录读入。field可以是深层次字段，比如 a.b.c。
|
||
- *field@xxx.json，把xxx.json中的field字段当作记录列表读入。field可以是深层次字段。
|
||
|
||
比较有趣的是，与xlsx数据源相似，支持将多个表放到同一个json中，不过实践中极少这么做。
|
||
|
||
如下列示例：
|
||
|
||
- TbCompositeJsonTable1 从 composite_tables.json的table1字段中读入记录列表，从composite_tables2.json中读入记录列表，从one_record.json中读入一个记录
|
||
- TbCompositeJsonTable2 从 composite_tables.json的table2字段中读入记录列表
|
||
- TbCompositeJsonTable3 从 composite_tables.json的table3字段中读入一个记录
|
||
|
||
|
||
```xml
|
||
<bean name="CompositeJsonTable1">
|
||
<var name="id" type="int"/>
|
||
<var name="x" type="string"/>
|
||
</bean>
|
||
<bean name="CompositeJsonTable2">
|
||
<var name="id" type="int"/>
|
||
<var name="y" type="int"/>
|
||
</bean>
|
||
<bean name="CompositeJsonTable3">
|
||
<var name="a" type="int"/>
|
||
<var name="b" type="int"/>
|
||
</bean>
|
||
|
||
<table name="TbCompositeJsonTable1" value="CompositeJsonTable1" input="*table1@composite_tables.json,*@composite_tables2.json,one_record.json"/>
|
||
<table name="TbCompositeJsonTable2" value="CompositeJsonTable2" input="*table2@composite_tables.json"/>
|
||
<table name="TbCompositeJsonTable3" value="CompositeJsonTable3" mode="one" input="table3@composite_tables.json"/>
|
||
```
|
||
|
||
## 以目录树形式组织
|
||
典型用法是，以目录为数据源（会遍历整棵目录树），目录树下每个json文件为一个记录读入。
|
||
|
||
如下，递归遍历test/json_datas整个目录树，**按文件名排序后**依次将每个json数据当作一个记录读入。
|
||
|
||
```xml
|
||
<table name="TbDataFromJson" value="DemoType2" input="test/json_datas"/>
|
||
```
|
||
|
||
## 数据tag
|
||
与excel格式类似，json格式支持记录tag，用 \_\_tag\_\_ 属性来指明tag，示例如下：
|
||
|
||
```json
|
||
{
|
||
"__tag__":"dev",
|
||
"x":1,
|
||
"y":2
|
||
}
|
||
```
|
||
|
||
|