数据存储开发指南

fs对象方法

说明

介绍

Local Storage

APICloud对html5的Local Storage进行了封装，在存储时更加方便。通过$api对象的setStorage方法不仅可以存储字符串，还可以直接存储JSON对象，而getStorage获取时也可以直接得到JSON对象。用法如下：

偏好数据

适用于少量的偏好设置数据的存储，一般用于保存一些状态值等，不推荐大量的数据通过此方式存储。 api对象提供了setPrefs、getPrefs、removePrefs方法，以键值对的方式传入参数，进行设置、获取和移除等，例如记录应用是否是第一次启动：


    firstLaunch:false

具体参数及用法请参考api文档中的说明。

文件

APICloud为开发者提供了文件和文件夹相关操作API，包括创建、移动、删除文件和文件夹等，以及文本内容的读写操作。其中api对象提供了基本的readFile、writeFile方法，支持整个文件内容的读写操作，其读写文件示例代码如下：

var fs = api.require('fs');
fs.open({
    path:'fs://test.txt',
    flags:'read_write'
},function(ret, err) {
    if (ret.status) {
        var fd = ret.fd;            //fd为文件句柄
        fs.write({
            data:'text',
            offset:0
        },function(ret,err){
            if (ret.status) {
                api.alert({msg:'write操作成功'});
            } else{
            }
        });
    }

其它方法请参考fs模块文档。

数据库

APICloud为开发者提供了操作本地数据库的接口，但需要开发者熟悉基本的SQL语句，如创建表、插入和更新数据、获取数据等操作。

db模块提供了数据库相关操作API，详见db模块文档。部分示例代码如下：

创建一张名为Persons的表：

var db = api.require('db');
var sql = 'SELECT * FROM Persons';
db.selectSql({
    name:'databaseName',
    sql: sql
}, function(ret, err){
    if(ret.status){
        var data = ret.data;    
    } else{