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 = 'kenny**.**';
- $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{
-
- };
- });
|