[//]: # (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
}
```