配置文件模型

AWTK-MVVM 内置了一些配置文件模型，用于读写各种配置文件，比如，JSON/XML/INI/CSV/UBJSON 等。

文件名中可以引用下面的变量。

• ${app_dir} 应用程序目录
• ${user_dir} 用户目录
• ${temp_dir} 临时目录

json(url=${app_dir}/demos/demo_conf/demo.json)

支持 http/https 协议。支持 HTTP 协议时，要启用 socket。支持 HTTPS 协议时，要启用 ssl。

示例

json(url=http://t.weather.sojson.com/api/weather/city/101030100)

支持从资源加载数据。

1. json 配置

示例

{"network" : {"device" : "eth0","ip" : "192.168.1.1"},"serial" : {"device" : "COM1","baudrate" : "115200"}
}

功能：用于读写 JSON 文件。

1.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

属性名	属性的值
network.device	eth0
network.ip	192.168.1.1
serial.device	COM1
serial.baudrate	115200

1.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

1.3 创建参数

参数	类型	说明
url	string	文件路径（必须）

示例

json(url=${app_dir}/demos/demo_conf/demo.json)

2. ubjson 配置

示例

{"network" : {"device" : "eth0","ip" : "192.168.1.1"},"serial" : {"device" : "COM1","baudrate" : "115200"}
}

功能：用于读写 UBJSON 文件。

2.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

属性名	属性的值
network.device	eth0
network.ip	192.168.1.1
serial.device	COM1
serial.baudrate	115200

2.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

2.3 创建参数

参数	类型	说明
url	string	文件路径（必须）

示例

ubjson(url=${app_dir}/demos/demo_conf/demo.ubjson)

3. xml 配置

示例

<root><network device="eth0" ip="192.168.1.1" /><serial device="COM1" baudrate="115200" />
</root>

功能：用于读写 XML 文件。

3.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

属性名	属性的值
network.device	eth0
network.ip	192.168.1.1
serial.device	COM1
serial.baudrate	115200

3.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

3.3 创建参数

参数	类型	说明
url	string	文件路径（必须）

示例

xml(url=${app_dir}/demos/demo_conf/demo.xml)

4. ini 配置

示例

[network]device = eth0ip = 192.168.1.1
[serial]device = COM1baudrate = 115200

功能：用于读写 INI 文件。

4.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

属性名	属性的值
network.device	eth0
network.ip	192.168.1.1
serial.device	COM1
serial.baudrate	115200

4.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

4.3 创建参数

参数	类型	说明
url	string	文件路径（必须）

示例

ini(url=${app_dir}/demos/demo_conf/demo.ini)

5. csv 配置

示例

eth0,192.168.1.1
eth1,192.168.1.2
eth2,192.168.1.3

功能：用于读写 CSV 文件。

5.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

用于列表项绑定

属性名	属性的值
item.device	访问第一列
item.ip	访问第二列
item.0	访问第一列
item.1	访问第二列
item.[0]	访问第一列
item.[1]	访问第二列

5.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

5.3 创建参数

参数	类型	说明
url	string	文件路径（必须）
col_names	string	列名，用分隔符分隔
sep	char	分隔符，默认为逗号

示例

csv(url=${app_dir}/demos/demo_conf/demo.csv, col_names='device,ip', sep=',')

6. json_array 配置

示例

{"networks": [{"device": "eth0","ip": "192.168.1.1"},{"device": "eth1","ip": "192.168.1.2"},{"device": "eth2","ip": "192.168.1.3"}]
}

功能：用于读写 JSON 文件（方便绑定到列表视图）。

6.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

用于列表项绑定

属性名	属性的值
item.device	device
item.ip	ip

6.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

6.3 创建参数

参数	类型	说明
url	string	文件路径 （必须）
prefix	string	路径前缀（可选）

示例

json_array(url=${app_dir}/demos/demo_conf/demo_array.json, prefix=networks)

7. xml_array 配置

示例

<networks><network device="eth0" ip="192.168.1.1" /><network device="eth1" ip="192.168.1.2" /><network device="eth2" ip="192.168.1.3" />
</networks>

功能：用于读写 XML 文件（方便绑定到列表视图）。

7.1 内置属性

可以通过路径引用属性值。比如上面的例子，可以用下面的方式访问：

用于列表项绑定

属性名	属性的值
item.device	device
item.ip	ip

7.2 内置命令

命令	参数	说明
save	无	保存
reload	无	重新加载

7.3 创建参数

参数	类型	说明
url	string	文件路径 （必须）
prefix	string	路径前缀（可选）

示例

xml_array(url=${app_dir}/demos/demo_conf/demo_array.xml, prefix=networks)