上面讲代码结构的时候讲到了一个获取好友列表的一个实例,下面就详细讲一下这个实例的代码详细流程:
首先需要创建一个DataRequest对象,由这个对象定义数据请求的对象,就是要请求什么数据,然后发送请求。
在发送请求的时候指定一个回调方法,数据请求完毕之后,通过DataResponse对象返回数据。
通过处理DataResponse里面的数据就可以把好友还有自己的个人信息都显示在页面上了。
<?xml version="1.0" encoding="UTF-8" ?>
<Module>
<ModulePrefs title="List Friends Example">
<Require feature="opensocial-0.7"/>
</ModulePrefs>
<Content type="html">
<![CDATA[
<script type="text/javascript">
function getData() {
var req = opensocial.newDataRequest(); //创建一个DataRequest对象
//newFetchPersonRequest:创建项目以向服务器请求用户 ID 的个人资料
req.add(req.newFetchPersonRequest(opensocial.DataRequest.PersonId.VIEWER), 'viewer');//数据存储在Person对象中
//newFetchPersonRequest:创建项目以向服务器请求好友
req.add(req.newFetchPeopleRequest(opensocial.DataRequest.Group.VIEWER_FRIENDS), 'viewerFriends');//数据存储在Collection<Person>对象中
//'viewer' or 'viewerFriends' 要将生成的响应数据映射至的键
req.send(onLoadFriends); //向服务器发送数据请求以获取数据响应
};
//使用回调函数处理数据
//dataResponse是DataResponse类型的数据
//dataResponse是回调函数的返回值
function onLoadFriends(dataResponse) {
//getData() 将返回成功请求的实际响应数据
//当请求查看者或所有者时,会返回 opensocial.Person 对象
//当请求一组好友时,会得到 opensocial.Person 对象的 opensocial.Collection
var viewer = dataResponse.get('viewer').getData();
var html = 'Friends of ' + viewer.getDisplayName();
html += ':<br><ul>';
var viewerFriends = dataResponse.get('viewerFriends').getData();
//相当于C#的Foreach方法
viewerFriends.each(function(person) {
html += '<li>' + person.getDisplayName() + '</li>';
});
html += '</ul>';
document.getElementById('message').innerHTML = html;
};
gadgets.util.registerOnLoadHandler(getData);
</script>
<div id="message"> </div>
]]>
</Content>
</Module>