OpenSocial--使用OpenSocial开发iGoogle小工具：访问用户和个人资料

上面讲代码结构的时候讲到了一个获取好友列表的一个实例，下面就详细讲一下这个实例的代码详细流程：

首先需要创建一个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>