Packageyy
Interfacepublic interface ICloud extends flash.events.IEventDispatcher

简单存储接口。提供简单的简单存储数据服务,包括增,删,改,查的基本操作,除了 频道所有者(OW紫马)和 频道总管理(VP橙马)可以删除和修改所有数据之外,其他用户只能删除和修改自己的数据,每个用户都可以查询所有数据。



Public Methods
 MethodDefined By
  
addData(intValue1:uint, intValue2:uint, stringValue:String):Object
增加数据。注意:同一个用户在一个应用中两次保存之间需要间隔1秒
ICloud
  
deleteData(filters:Array):Object
删除数据
ICloud
  
queryData(filters:Array):Object
查询数据
ICloud
  
updateData(intValue1:uint, intValue2:uint, stringValue:String, filters:Array):Object
修改数据
ICloud
Method Detail
addData()method
public function addData(intValue1:uint, intValue2:uint, stringValue:String):Object

增加数据。注意:同一个用户在一个应用中两次保存之间需要间隔1秒

Parameters

intValue1:uint — 要保存的字符串型数据
 
intValue2:uint — 要保存的uint型数据
 
stringValue:String — 要保存的uint型数据

Returns
Object — 返回调用是否成功,是一个Object对象,具体属性如下

ret: int类型 返回码 0=成功,非0值失败,具体请参考错误代码。

key: String类型 返回码 增加成功后返回数据的key。key可以唯一标识一条数据


Example
         var result:Object=YY.instance.cloud.addData(11,22,"hello yy");
         if(result.ret==0)
         {
             trace(result.ret);
         }
         成功时返回数据key值和返回码0,例如 {ret:0,key:"000000004f55d48f"}。
         失败时返回错误代码,例如{"ret":5}
         
deleteData()method 
public function deleteData(filters:Array):Object

删除数据

Parameters

filters:Array — 过滤器数组,即删除的条件,保存CloudFilter对象数组。

Returns
Object — 返回调用是否成功,是一个Object对象,具体属性如下。

ret: int类型 返回码 0=成功,非0值失败,具体请参考错误代码。

See also

queryData()method 
public function queryData(filters:Array):Object

查询数据

Parameters

filters:Array — 过滤器数组,查询的条件。数组中为CloudFilter对象。

Returns
Object — 返回查询结果,是一个Object对象,具体属性如下

ret: int类型 返回码 0=成功,非0值失败,具体请参考错误代码。

data: Array类型 查询结果,保存在数组中。数组的元素为CloudData对象。具体格式参考 CloudData对象

See also


Example
         //查询某一时间段内的数据
         var dt = new Date();
         var filterTime = new CloudFilter();
         filterTime.field=CloudFilter.FIELD_CREATE_TIME;
         filterTime.op=CloudFilter.FILTER_OP_GREATER;
         filterTime.value=Math.ceil(dt.getTime() / 1000 - 600);
         filterTime.condition=CloudFilter.FILTER_CD_NONE;
         var result:Object = YY.instance.cloud.queryData([filterTime]);
         if(result.ret==0)
         {
             trace("查询到数据个数:"+result.data.length);
         }
         成功时返回数据,示例如下
         ret:0,data:[
          {key:"4f55d3d7",createTime:"2012-03-06 17:07:35",updateTime:"2012-03-06 17:07:35",creatorUid:1710881282,intValue1:1,intValue2:100,stringValue:"你好,简单存储!hello cloud"},
          {key:"4f55d48f",createTime:"2012-03-06 17:10:39",updateTime:"2012-03-06 17:10:39",creatorUid:1710881282,intValue1:1,intValue2:100,stringValue:"可存可取"},
          {key:"4f55d57d",createTime:"2012-03-06 17:14:37",updateTime:"2012-03-06 17:14:37",creatorUid:1710881282,intValue1:1,intValue2:100,stringValue:"this is test"}
         }
         成功时但没有查询到数据,格式如下{"ret":0,"data":[]}
         失败时返回错误代码,例如{"ret":5}
         
updateData()method 
public function updateData(intValue1:uint, intValue2:uint, stringValue:String, filters:Array):Object

修改数据

Parameters

intValue1:uint — 被修改的数据的新值
 
intValue2:uint — 被修改的数据的新值
 
stringValue:String — 被修改的数据的新值
 
filters:Array — 过滤器数组,保存CloudFilter对象数组,找到要修改的数据。

Returns
Object — 返回调用是否成功,是一个Object对象,具体属性如下。

ret: int类型 返回码 0=成功,非0值失败,具体请参考错误代码。

See also