来源 | HaaS技术社区
1、前言
之前的文章中，已经介绍了轻应用的概念以及如何在硬件平台上运行轻应用。这里介绍的轻应用框架提供的基础模块。基础模块是与平台无关，在多种场景下都会使用到的通用能力，主要包括以下几种：系统信息、文件系统、键值存储。
关于轻应用的文档请参考：https://help.aliyun.com/document_detail/174810.html
2、系统信息
系统信息模块提供了一些查看系统版本、系统时间、系统内存使用的接口等。该接口是全局接口，无需require。
2.1、示例代码
-
console.log('system version is: ' + system.version());
-
console.log('module version is: ' + system.versions().module);
-
console.log('system platform is: ' + system.platform());
-
console.log('system uptime is: ' + system.uptime());
-
// get heap/memory information
-
console.log('system heapTotal is: ' + system.memory().heapTotal);
-
console.log('system heapUsed is: ' + system.memory().heapUsed);
为了对开发者更友好，system相关的接口也支持使用
process进行访问，比如process.platform()、process.uptime()。
2.2、方法
system.version()
获取轻应用版本号。
返回
- String类型。
system.versions()
获取更多版本号。
返回
- Object类型。其属性有：
| 属性 |
说明 |
| module |
硬件模组版本号 |
system.platform()
获取当前硬件平台名称。
返回
- String类型。
system.uptime()
获取当前系统运行时间。单位为毫秒。
返回
- Number类型。
system.memory()
获取堆内存信息。
返回
- Object类型，其属性有：
| 属性 |
说明 |
| heapTotal |
总共的堆内存大小 |
| heapUsed |
已经使用的堆内存大小 |
system.gc()
主动进行系统内存回收。
返回
- Boolean类型，操作成功为True，操作失败为False。
3、文件系统
3.1、示例代码
-
var fs = require('fs');
-
-
var path = './test.data';
-
var content = 'this is amp fs test file';
-
-
// write file
-
fs.writeSync(path, content);
-
-
// read file
-
var data = fs.readSync(path);
-
console.log('fs read: ' + data);
-
-
fs.unlinkSync(path);
3.2、方法
fs.writeSync(String path, String|ArrayBuffer data, Object options)
向文件系统中写入文件。
入参
| 属性 |
类型 |
必填 |
描述 |
| path |
String |
是 |
写入文件的路径和名称 |
| data |
String | ArrayBuffer |
是 |
要写入的文本或者二进制数据 |
| options |
Object |
否 |
参考下面的options说明 |
options说明：
| 属性 |
类型 |
必填 |
描述 |
| flag |
String |
否 |
flag，详细参见：文件系统flag说明，默认是'w' |
fs.readSync(String path)
读取path路径下文件内容。
入参
| 属性 |
类型 |
必填 |
描述 |
| path |
String |
是 |
文件路径 |
返回
- ArrayBuffer 类型，读取到的数据。
fs.unlinkSync(String path)
删除对应path的文件。
入参
| 属性 |
类型 |
必填 |
描述 |
| path |
String |
是 |
文件路径 |
文件系统flag说明
当
-
'a': 打开文件用于追加。 如果文件不存在，则创建该文件。
-
'a+': 打开文件用于读取和追加。 如果文件不存在，则创建该文件。
-
'r': 打开文件用于读取。 如果文件不存在，则会发生异常。
-
'r+': 打开文件用于读取和写入。 如果文件不存在，则会发生异常。
-
'w': 打开文件用于写入。 如果文件不存在则创建文件，如果文件存在则截断文件。
-
'w+': 打开文件用于读取和写入。 如果文件不存在则创建文件，如果文件存在则截断文件。
4、键值存储
kv - 键值存储为持久化存储，设备掉电无影响。
4.1、示例代码
-
var kv = require('kv');
-
-
var key = 'key-test';
-
var value = 'this is amp kv test file';
-
-
// kv set
-
kv.setStorageSync(key, value);
-
-
// kv get
-
var val = kv.getStorageSync(key);
-
console.log('kv read: ' + val);
-
-
// kv remove
-
kv.removeStorageSync(key);
4.2、方法
kv.setStorageSync(String key, String value)
新增/更新 key-value。
入参
| 属性 |
类型 |
必填 |
描述 |
| key |
String |
是 |
需要新增的key。 |
| value |
String |
是 |
需要新增的value。 |
返回值
- Number类型，0：成功，其他：失败。
kv.getStorageSync(String key)
读取KV中的值。
入参
| 属性 |
类型 |
必填 |
描述 |
| key |
String |
是 |
需要读取的key。 |
返回值
- String类型，读取到的value值；如果读取失败则返回undefined。
kv.removeStorageSync(String key)
清除key-value值。
入参
| 属性 |
类型 |
必填 |
描述 |
| key |
String |
是 |
需要清除的key。 |
5、开发者技术支持
如需更多技术支持，可加入钉钉开发者群，或者关注微信公众号
更多技术与解决方案介绍，请访问阿里云AIoT首页https://iot.aliyun.com/
