luban/docs/data_json.md

3.9 KiB
Raw Blame History

json 数据源

json数据格式

大多数数据格式填法符合直觉,有几个数据类型的格式比较特殊:

  • set类型。填法为 [v1,v2,...]
  • map类型。由于json只支持string类型的key因此map格式填法为 [[k1,v1],[k2,v2]...]
  • 多态bean类型。需要 __type__ 属性来指定具体类型名。
  • text类型填法为 {"key":key, "text":text}

不同数据结构在json中格式示例如下

<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文件内容如下

 {
	"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字段中读入一个记录
<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数据当作一个记录读入。

<table name="TbDataFromJson" value="DemoType2" input="test/json_datas"/>

数据tag

与excel格式类似json格式支持记录tag用 __tag__ 属性来指明tag示例如下

{
	"__tag__":"dev",
	"x":1,
	"y":2
}