YonBuilder 移动开发平台之数据存储

YonBuilder 移动开发平台之数据存储

YonBuilder 移动开发平台开发者提供了多种本地数据存储方案,包括 Local Storage、偏好数据、文件和数据库等,以满足不同规模数据存储需求。其中 Local Storage 和偏好数据一般用于存储比较简单、规模较小的数据,而文件和数据库多用于存储大量数据,并且利于管理。

1. Local Storage

YonBuilder 移动开发平台对 html5 的 Local Storage 进行了封装,在存储时更加方便。通过 $api 对象的 setStorage 方法不仅可以存储字符串,还可以直接存储 JSON 对象,而 getStorage 获取时也可以直接得到 JSON 对象。用法如下:

var key = 'user';

var user = {};

user.name = 'kenny';

user.email = '[email protected]';

$api.setStorage(key, user);

user = $api.getStorage(key);

2. 偏好数据

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

api.setPrefs({

    firstLaunch:false

});

其它方法请参考 api 对象文档。

3. 文件

 (1)api 对象方法

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

api.readFile({

    path: 'fs://a.txt'

}, function(ret, err){

    if(ret.status){

        var data = ret.data;

    }

});
api.writeFile({

    path: 'fs://a.txt',

    data:'writeFile测试内容'

}, function(ret, err){

    if(ret.status){

        api.alert({msg:'写入文件成功'});

    } else{

        api.alert({msg:err.msg});

    }

});

(2)fs 对象方法

   若要使用更加丰富的文件操作 API,则需要引入 fs 原生插件,该原生插件详细定义了文件和文件夹的相关操作,并且支持文本内容的指定位置读写,其写文件示例代码如下:

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({

            fd:fd,

            data:'text',

            offset:0

        },function(ret,err){

            if (ret.status) {

                api.alert({msg:'write操作成功'});

            } else{

                api.alert({msg:err.msg});

            }

        });

    }

});

其它方法请参考 fs 原生插件文档。

4. 数据库

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

db 原生插件提供了数据库相关操作 API,详见 db 原生插件文档。部分示例代码如下:

创建一张名为 Persons 的表:

var db = api.require('db');

var sql = 'CREATE TABLE Persons(Id_P int, LastName varchar(255), FirstName varchar(255),

Address varchar(255), City varchar(255))';

db.executeSql({

    name: 'databaseName',

    sql: sql

}, function(ret, err){

    if(ret.status){

        api.alert({msg:'创建表成功'});

    } else{

        api.alert({msg:err.msg});

    }

});

从 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{

       

    };

});

你可能感兴趣的:(json,前端,javascript)