新手入门教程，从0开始入手APIcloud（二）

时间：2021-07-28 11:22:21


前面一篇主要讲了项目的创建和布局方式。总结一下APP的布局方式最佳为win+frame，多写个文件多弄点优化才能让你的APP流畅度提高。
这篇主要来讲一下模块的引入、服务器数据对接及APP数据存储方式。

一、模块的引入和使用
在apicloud的模块store里面提供了大量的模块，我们可以直接在html里面引入使用

使用方法：
在需要使用模块的页面中加入:

var obj = api.require('模块名');

然后参考对应模块的使用方法。如果在一个页面中频繁使用到一个模块的功能，最好就将其声明称全局变量。

二、服务器数据对接---云数据库和本地服务器
1、在APICLOUD开发的过程中，我们看到了一个新名词，数据云。这个是apicloud提供给开发者的一个云数据库，我们可以利用它来完成数据的存储和读取。
开启数据云流程，  进入控制台---左侧云设置----选择一个储存服务--确定即可开通，然后在Database里面我们会看到默认的几张表
（以下注释非官方注释，个人理解的意思 *.*）
accessToken    ----  存储用户令牌类
file  ---- 文件类
role  -----  角色配置
roleMapping  ---  相关对应的角色权限
user  -----  用户
（默认的表前面有个下划线不用理会他，就当不存在哈）
当然我们也可以根据自己的需求创建各类表，通过添加列来自己表字段，注意根据自己需求设置下字段类型，字段类型不懂的可以百度一下，主要有字符，数字，时间，文件，数组，关联等

对于数据表的操作说简单的点就是增删改查，下面说一下数据云的使用方法，在文档里面对应(mcm)

我们通过model模块来实现数据云的操作，首先引入和配置下model模块
var model = api.require('model');
model.config({
    appKey: 'A991A337-0212-A29D-0C9C-A518E39FXXXX',
    host: 'https://d.apicloud.com'
});


appKey 可以在控制台里面查看。

然后通过model的各种方法来实现增删改查
例子，插入数据
var model = api.require('model');
model.insert({
    class: '表名',
    value: {
        字段: '值'
    }
}, function(ret, err){
    if(ret){
        //do something      
    }
});


其他的方法请参考：  http://docs.apicloud.com/%E7%AB%AFAPI/%E4%BA%91%E6%9C%8D%E5%8A%A1%E5%AF%B9%E6%8E%A5/mcm#a2
TIP:在apicloud，一般用ret来标识成功的返回，err表示错误
在表的操作中数据返回的是JSON格式，我们拿到这个JSON数据后就开始用js来处理，插入到html元素中

自己可以建个表，按照文档来试一下各种方法。

2、从自己的服务器读写数据

apicloud封装了一个ajax的方法来方便我们通过post或get等获取服务器数据，获取的数据类型有json和text格式，使用方法跟JS原生和jq的post get  大同小易
重点来说一个几个注意的地方

当使用post时，发送的数据要写在data的values里面。
当为get时，data是不起作用的，发送的数据放在url里面

以php为例接受时直接  $name = $_POST['name'];

三、APP数据存储方式

在apicloud的数据方式还是蛮多的，上面的数据云和自己服务器算是两个吧，下面还有H5的本地保存，读写文件方式，设置偏好值等。
1、H5本地保存 localStorage   在apicloud中已经封装的更简单了
$api.setStorage('name','key');//设置
$api.getStorage('name');//获得指定name的值
$api.rmStorage('name');//清除指定name的值
$api.clearStorage();//清楚全部本地数据


不过这个方式不建议大数据的读取，可以用来存取用户的基本信息
文档 http://docs.apicloud.com/APICloud/%E6%8A%80%E6%9C%AF%E4%B8%93%E9%A2%98/framework-dev-guide#39
2、文件存储方式

readFile和writFile     fs模块
如果不牵扯到文件的修改的话建议使用readFile和writeFile，操作还要方便些。
这些主要用在保存大数据和保存内容缓存，保存文件的时候个人觉得保存到缓存文件夹里面，获取方式  var cacheDir = api.cacheDir;
例子，比如我们要将内容列表写到本地，然后将列表的内容分别保存一个文件，下次打开APP的时候先查询有没有对应的本地文件，没有的话或者有更新再从服务器读取

以JSON数据为例：得到JSON数据后
var cacheDir = api.cacheDir;
api.writeFile({
    path: cacheDir+'/自定一个文件名.json',
    data: JSON.stringify(josn)
}, function(ret, err){

})

注意要将json转为字符串，否则无法写入，（不转换的话安卓设备可以写入，IOS上是不行的）
读取：
api.readFile({
    path: cacheDir+'/文件名.json'
}, function(ret, err){
    if(ret.status){
        var jsonData = JSON.parse(ret.data);
    }
});

注意读的时候将数据转为对象

3.

此外apicloud还提供了api.setPrefs的方法来设置偏好值

参考文档：http://docs.apicloud.com/%E7%AB%AFAPI/api#45


到此数据这一块的处理又差不多到一阶段了，多多动手才能发现问题，发现了才能去解决。我提供的只是一种思路方式，关键还得靠大家。谢谢

下一篇将介绍  APP 优化的处理，

新手入门教程，从0开始入手APIcloud（一）

新手入门教程，从0开始入手APIcloud（二）

新手进阶教程，从0入手APICloud（三）-- 缓存方案
标签：

相关文章