.jpg)
mcm模块使用攻略relation对象详解
mcm模块简介：
使用APICloud数据云服务时，客户端需要使用mcm模块来对云端数据进行操作，mcm模块包含了model、user、relation和query等对象
今天我们先来详细解释下，relation对象。
relation对象包括：
(1)insert
(2)count
(3)findAll
(4)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 对象
-
描述：错误信息
示例代码
var relation = api.require('relation');
relation.insert({
class: 'user',
id: 'A00001',
column: 'column',
value: {
name: 'value'
}
}, function(ret, err){
if( ret ){
alert( JSON.stringify( ret) );
}else{
alert( JSON.stringify( err) );
}
});
可用性：
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 对象
-
描述：错误信息
示例代码
var relation = api.require('relation');
relation.count({
class: 'user',
id: 'A00001',
column: 'column'
}, function(ret, err){
if( ret ){
alert( JSON.stringify( ret) );
}else{
alert( JSON.stringify( err) );
}
});
可用性：
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 对象
-
描述：错误信息
示例代码
var relation = api.require('relation');
relation.findAll({
class: 'user',
id: 'A000000001',
column: 'column'
}, function (ret, err) {
if( ret ){
alert( JSON.stringify( ret) );
}else{
alert( JSON.stringify( err) );
}
});
可用性：
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 对象
-
描述：错误信息
示例代码
var relation = api.require('relation');
relation.deleteAll({
class: 'user',
id: 'A00001',
column: 'column'
}, function(ret, err){
if( ret ){
alert( JSON.stringify( ret) );
}else{
alert( JSON.stringify( err) );
}
});
可用性：
iOS系统，Android系统
可提供的1.0.0及更高版本