mcm

概述

使用APICloud数据云服务时,客户端需要使用mcm模块来对云端数据进行操作,mcm模块包含了model、user、relation和query等对象

config insert deleteById updateById findById findAll count exist uploadFile downloadFile

概述

通过model对象,可以对云端指定表内数据进行修改,以及通过查询条件进行查询。注:如果不是在云端编译的应用中测试,则需要调用config方法,配置appKey等信息

config

全局函数,配置appKey等应用信息。设置一次即生效,直到下一次设置,不设置默认为当前应用的信息

config({param})

params

appId:

  • 类型:字符串
  • 默认值:widget目录下config.xml里面的id
  • 描述:应用的id,在APICloud上应用概览里获取,可以为空

appKey:

  • 类型:字符串
  • 默认值:无
  • 描述:应用的安全校验Key,在APICloud上应用概览里获取,不能为空

host:

  • 类型:字符串
  • 默认值:无
  • 描述:应用服务器地址,可为空,为空时默认为编译时的服务器地址

示例代码

  1. var model = api.require('model');
  2. model.config({
  3. appKey: 'A991A337-0212-A29D-0C9C-A518E39FXXXX',
  4. host: 'https://d.apicloud.com'
  5. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

insert

向对象插入一条数据

insert({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

value:

  • 类型:JSON 对象
  • 默认值:无
  • 描述:插入的键值对,与服务器上class中键值对应,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:插入成功后对应的该条数据在服务器的所有键值

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.insert({
  3. class: 'user',
  4. value: {
  5. name : 'text'
  6. }
  7. }, function(ret, err){
  8. if( ret ){
  9. alert( JSON.stringify( ret ) );
  10. }else{
  11. alert( JSON.stringify( err ) );
  12. }
  13. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

deleteById

根据ID删除对象的一条数据

deleteById({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被删除数据的行ID,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.deleteById({
  3. class: 'user',
  4. id: 'A0000000001'
  5. }, function(ret, err){
  6. if( ret ){
  7. alert( JSON.stringify( ret ) );
  8. }else{
  9. alert( JSON.stringify( err ) );
  10. }
  11. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

updateById

根据ID更新对象的一条数据

updateById({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:将要更新数据的行ID,不能为空

value:

  • 类型:JSON
  • 默认值:无
  • 描述:将要更新的键值对,与服务器上class中键值对应,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:更新成功后对应的该条数据在服务器的所有键值

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.updateById({
  3. class: 'user',
  4. id: 'A000001',
  5. value: {
  6. nickname: 'Tom'
  7. }
  8. }, function(ret, err){
  9. if( ret ){
  10. alert( JSON.stringify( ret ) );
  11. }else{
  12. alert( JSON.stringify( err ) );
  13. }
  14. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

findById

根据ID查找对象的一条数据

findById({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被查找数据的行ID,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:查找成功后对应的该条数据在服务器的所有键值

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.findById({
  3. class: 'user',
  4. id: 'A00001'
  5. }, function(ret, err){
  6. if( ret ){
  7. alert( JSON.stringify( ret ) );
  8. }else{
  9. alert( JSON.stringify( err ) );
  10. }
  11. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

findAll

根据条件查找对象中所有符合条件的数据

findAll({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

qid:

  • 类型:字符串
  • 默认值:无
  • 描述:通过query对象创建的查询条件对象ID,见query对象,不能为空

callback(ret, err)

ret:

  • 类型:JSON数组
  • 描述:查找成功后对应的所有满足条件的数据

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.findAll({
  3. class: "activity",
  4. qid: queryId
  5. }, function( ret, err ) {
  6. if( ret ){
  7. alert( JSON.stringify( ret ) );
  8. }else{
  9. alert( JSON.stringify( err ) );
  10. }
  11. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

count

根据条件返回对象下满足该条件的总记录数

count({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

qid:

  • 类型:字符串
  • 默认值:无
  • 描述:通过query对象创建的查询条件对象ID,见query对象,可以为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.count({
  3. class: "user",
  4. qid: queryId
  5. }, function( ret, err ) {
  6. if( ret ){
  7. alert( JSON.stringify( ret ) );
  8. }else{
  9. alert( JSON.stringify( err ) );
  10. }
  11. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

exist

查询某对象下某行是否存在

exist({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被查找数据的行ID,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.exist({
  3. class: "book",
  4. id: "xxx"
  5. }, function( ret, err ) {
  6. if( ret ){
  7. alert( JSON.stringify( ret ) );
  8. }else{
  9. alert( JSON.stringify( err ) );
  10. }
  11. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

uploadFile

上传文件到云端file表里面

uploadFile({params}, callback(ret, err))

params

data:

  • 类型:JSON 对象
  • 默认值:无
  • 描述:提交的文件及相关数据,不能为空
  • 内部字段:
  1. {
  2. file: //文件对象,不能为空
  3. {
  4. url:'' //文件路径,不能为空
  5. name:'' //文件名
  6. },
  7. values: //其它字段
  8. {
  9. }
  10. };

report:

  • 类型:布尔
  • 默认值:false
  • 描述:上传过程是否回调上传进度

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息,依赖于report字段,report为false时为上传完成时,服务器返回的数据
  1. reporttrue时内部字段:
  2. {
  3. progress: //上传进度,0.00-100.00
  4. state: //上传状态,(0-上传中 1-上传成功 2-上传失败)
  5. body: //上传完成时,服务器返回的数据
  6. }

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.uploadFile({
  3. report: false,
  4. data: {
  5. file: {
  6. name: 'apicloud.png',
  7. url: 'widget://res/img/apicloud.png'
  8. },
  9. values: {
  10. key1: 'value1',
  11. key2: 'value2'
  12. }
  13. }
  14. }, function(ret, err){
  15. if( ret ){
  16. alert( JSON.stringify( ret ) );
  17. }else{
  18. alert( JSON.stringify( err ) );
  19. }
  20. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

downloadFile

下载文件

downloadFile({params}, callback(ret, err))

params

url:

  • 类型:字符串
  • 默认值:无
  • 描述:文件远程地址,url和id必须传一个

id:

  • 类型:字符串
  • 默认值:无
  • 描述:已上传文件在云端file表中的行ID,url和id必须传一个

savePath:

  • 类型:字符串
  • 默认值:无
  • 描述:存储路径,为空时使用自动创建的路径

report:

  • 类型:布尔
  • 默认值:false
  • 描述:下载过程是否回调下载进度

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:下载信息
  • 内部字段:
  1. {
  2. fileSize: //文件大小
  3. progress: //下载进度,0.00-100.00
  4. state: //下载状态,(0-下载中 1-下载成功 2-下载失败)
  5. savePath: //文件的本地保存路径
  6. }

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var model = api.require('model');
  2. model.downloadFile({
  3. report: true,
  4. id: 'asfdasfasfasfasf',
  5. savePath: ''
  6. }, function(ret, err) {
  7. if( ret ){
  8. alert( JSON.stringify( ret ) );
  9. }else{
  10. alert( JSON.stringify( err ) );
  11. }
  12. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

createQuery limit skip asc desc include whereEqual whereNotEqual whereLike whereUnLike whereStartWith whereEndWith whereExist whereNotExist whereContain whereContainAll whereNotContain whereGreaterThan whereGreaterThanOrEqual whereLessThan whereLessThanOrEqual justFields exceptFields

概述

query对象用于构建一个或多个查询条件,包含分页、排序、以及其它where语句等,设置查询条件后,传递给model对象的查询方法,以获取符合条件的记录。

createQuery

创建一个query对象

createQuery(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

字段:

  1. {
  2. qid //query对象的句柄ID,数字型
  3. }

示例代码

  1. var query = api.require('query');
  2. query.createQuery(function( ret, err ){
  3. if( ret ){
  4. alert( JSON.stringify( ret ) );
  5. }else{
  6. alert( JSON.stringify( err ) );
  7. }
  8. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

limit

设置查询返回结果限制为n条,相当于“分页”大小。

limit({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

value:

  • 类型:数字
  • 默认值:20
  • 描述:被限制的数目值

示例代码

  1. var query = api.require('query');
  2. query.limit({
  3. qid: queryId,
  4. value: 3
  5. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

skip

设置查询返回结果中忽略前n条

skip({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

value:

  • 类型:数字
  • 默认值:0
  • 描述:被忽略的数目值

示例代码

  1. var query = api.require('query');
  2. query.skip({
  3. qid: queryId,
  4. value: 0
  5. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

asc

设置查询返回结果按某列正序排列

asc({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:用于排序的列,不能为空

示例代码

  1. var query = api.require('query');
  2. query.asc({
  3. qid: queryId,
  4. column: 'id'
  5. });

补充说明

与desc互斥

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

desc

设置查询返回结果按某列倒序排列

desc({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:用于排序的列,不能为空

示例代码

  1. var query = api.require('query');
  2. query.desc({
  3. qid: queryId,
  4. column: 'id'
  5. });

补充说明

与asc互斥

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

include

设置查询返回结果中包含pointer指向的对象

include({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:pointer列名,不能为空

示例代码

  1. var query = api.require('query');
  2. query.include({
  3. qid: queryId,
  4. column: 'column'
  5. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereEqual

设置查询条件为某列等于某值

whereEqual({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereEqual({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个,与whereNotEqual互斥

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereNotEqual

设置查询条件为某列不等于某值

whereNotEqual({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereNotEqual({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个,与whereEqual互斥

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereLike

设置查询条件为某列内容中包含某值

whereLike({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereLike({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereUnLike

设置查询条件为某列内容中不包含某值

whereUnLike({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereUnLike({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereStartWith

设置查询条件为某列内容以某值开头

whereStartWith({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereStartWith({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereEndWith

设置查询条件为某列内容以某值结尾

whereEndWith({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereEndWith({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereExist

设置查询条件为某列内容不为空

whereExist({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereExist({
  3. qid: queryId,
  4. column: 'id'
  5. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereNotExist

设置查询条件为某列内容为空

whereNotExist({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereNotExist({
  3. qid: queryId,
  4. column: 'id'
  5. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereContain

设置查询条件为某列内容中包含某值

whereContain({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereContain({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个,该列需为array型

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereContainAll

设置查询条件为某列内容中包含某几个值

whereContainAll({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串数组
  • 默认值:无
  • 描述:作为条件的多个值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereContainAll({
  3. qid: queryId,
  4. column: 'id',
  5. value: ['A00000000001']
  6. });

补充说明

可设置多个,该列需为array型

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereNotContain

设置查询条件为某列内容中不包含某值

whereNotContain({params})

arams

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereNotContain({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个,该列需为array型

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereGreaterThan

设置查询条件为某列的内容大于某值

whereGreaterThan({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,数字或者date型,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereGreaterThan({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereGreaterThanOrEqual

设置查询条件为某列的内容大于等于某值

whereGreaterThanOrEqual({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,数字或者date型,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereGreaterThanOrEqual({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereLessThan

设置查询条件为某列的内容小于某值

whereLessThan({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,数字或者date型,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereLessThan({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

whereLessThanOrEqual

设置查询条件为某列的内容小于等于某值

whereLessThanOrEqual({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的列名,不能为空

value:

  • 类型:字符串
  • 默认值:无
  • 描述:作为条件的值,数字或者date型,不能为空

示例代码

  1. var query = api.require('query');
  2. query.whereLessThanOrEqual({
  3. qid: queryId,
  4. column: 'id',
  5. value: 'A00000000001'
  6. });

补充说明

可设置多个

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

justFields

设置查询仅返回需要的字段

justFields({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

value:

  • 类型:字符串数组
  • 默认值:无
  • 描述:字段的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.justFields({
  3. qid: queryId,
  4. value: ['value']
  5. });

补充说明

与exceptFields互斥

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

exceptFields

设置查询返回除某些字段以外的字段

exceptFields({params})

params

qid:

  • 类型:数字
  • 默认值:无
  • 描述:query对象句柄ID,由createQuery创建而来,不能为空

value:

  • 类型:字符串数组
  • 默认值:无
  • 描述:字段的值,不能为空

示例代码

  1. var query = api.require('query');
  2. query.exceptFields({
  3. qid: queryId,
  4. value: ['value']
  5. });

补充说明

与justFields互斥

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

insert count findAll deleteAll

概述

relation对象主要用于对一张表中数据类型为Relation的列进行操作

insert

向对象的某关系列下插入一条内容

insert({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被插入对象ID,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:关系列的名称,对应服务器上的同名relation,不能为空

value:

  • 类型:JSON 对象
  • 默认值:无
  • 描述:插入的键值对,与服务器上class中键值对应,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var relation = api.require('relation');
  2. relation.insert({
  3. class: 'user',
  4. id: 'A00001',
  5. column: 'column',
  6. value: {
  7. name: 'value'
  8. }
  9. }, function(ret, err){
  10. if( ret ){
  11. alert( JSON.stringify( ret) );
  12. }else{
  13. alert( JSON.stringify( err) );
  14. }
  15. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

count

查找对象某关系列下对应的数据总条数

count({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被查找对象ID,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:关系列的名称,对应服务器上的同名relation,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var relation = api.require('relation');
  2. relation.count({
  3. class: 'user',
  4. id: 'A00001',
  5. column: 'column'
  6. }, function(ret, err){
  7. if( ret ){
  8. alert( JSON.stringify( ret) );
  9. }else{
  10. alert( JSON.stringify( err) );
  11. }
  12. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

findAll

查找对象某关系列下对应的所有数据

findAll({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被查找对象ID,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:关系列的名称,对应服务器上的同名relation,不能为空

callback(ret, err)

ret:

  • 类型:JSON数组
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var relation = api.require('relation');
  2. relation.findAll({
  3. class: 'user',
  4. id: 'A000000001',
  5. column: 'column'
  6. }, function (ret, err) {
  7. if( ret ){
  8. alert( JSON.stringify( ret) );
  9. }else{
  10. alert( JSON.stringify( err) );
  11. }
  12. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

deleteAll

删除对象某关系列下对应的所有数据

deleteAll({params}, callback(ret, err))

params

class:

  • 类型:字符串
  • 默认值:无
  • 描述:对象的名称,对应服务器上的同名class,不能为空

id:

  • 类型:字符串
  • 默认值:无
  • 描述:被删除对象ID,不能为空

column:

  • 类型:字符串
  • 默认值:无
  • 描述:关系列的名称,对应服务器上的同名relation,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var relation = api.require('relation');
  2. relation.deleteAll({
  3. class: 'user',
  4. id: 'A00001',
  5. column: 'column'
  6. }, function(ret, err){
  7. if( ret ){
  8. alert( JSON.stringify( ret) );
  9. }else{
  10. alert( JSON.stringify( err) );
  11. }
  12. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

login register logout updatePassword

概述

user对象提供用户相关操作,包括注册、登录、修改密码等

login

登录

login({params}, callback(ret, err))

params

username:

  • 类型:字符串
  • 默认值:无
  • 描述:用户名,不能为空

password:

  • 类型:字符串
  • 默认值:无
  • 描述:密码,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var user = api.require('user');
  2. user.login({
  3. username: 'name',
  4. password: '12345678'
  5. }, function( ret, err ) {
  6. if( ret ){
  7. alert( JSON.stringify( ret) );
  8. }else{
  9. alert( JSON.stringify( err) );
  10. }
  11. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

register

注册

register({params}, callback(ret, err))

params

username:

类型:字符串 默认值:无 描述:用户名,不能为空

password:

类型:字符串 默认值:无 描述:密码,不能为空

email:

类型:字符串 默认值:无 描述:邮箱,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var user = api.require('user');
  2. user.register({
  3. username: 'uname',
  4. password: '111111',
  5. email: 'xixi@apicloud.com'
  6. }, function( ret, err ) {
  7. if( ret ){
  8. alert( JSON.stringify( ret) );
  9. }else{
  10. alert( JSON.stringify( err) );
  11. }
  12. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

logout

注销登录

logout(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var user = api.require('user');
  2. user.logout(function(ret, err){
  3. if( ret ){
  4. alert( JSON.stringify( ret) );
  5. }else{
  6. alert( JSON.stringify( err) );
  7. }
  8. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

updatePassword

修改密码

updatePassword({params}, callback(ret, err))

params

password:

  • 类型:字符串
  • 默认值:无
  • 描述:密码,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:成功信息

err:

  • 类型:JSON 对象
  • 描述:错误信息

示例代码

  1. var user = api.require('user');
  2. user.updatePassword({
  3. password: 'newPwd'
  4. }, function(ret, err) {
  5. if( ret ){
  6. alert( JSON.stringify( ret) );
  7. }else{
  8. alert( JSON.stringify( err) );
  9. }
  10. });

补充说明

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本