AWTK-MVVM 配置文件模型
配置文件模型
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)