在我们使用 OSDE 开发应用之前 , 让我们花些时间来了解这些预备知识。

什么是 OpenSocial

简而言之，OpenSocial 是基于开放标准的一组通用的 API，用于帮助 WEB 的开发者构建跨多个社交网站的社交应用程序。

要了解 OpenSocial 是什么 , 我们先弄清楚 OpenSocial 想要解决的问题是什么。目前，对于 WEB 开发者来说，如果各个社交网站都提供私有的 API，那么他们就必须单独为每一个社交网站开发一套应用程序。如图 1 所示，如果 Orkut，Linkedin，Hi5,Salesforce 所提供的 API 是不同的，我们就必须构建四个不同的应用，尽管这四个应用的功能是相同的。

OpenSocial 要做的事情就是提供开发者一套通用的 API，基于该通用 API 开发的社交应用程序可以运行在任意支持 OpenSocial 规范的社交网站上，这样一来，就可以大大简化程序员的开发工作，有了 OpenSocial，他们就不必要单独为每一个社交网站开发应用程序。

开发者可以使用标准的 HTML，JavaScript 技术来创建基于 OpenSocial 的社交应用，这些应用可以运行在任何实现了 OpenSocial APIs 社交 WEB 站点上 , 这些站点被称之为 OpenSocial 容器 ( 例如 Orkut,iGoogle 等 )，允许你的应用访问该站点的社交信息 ( 如 People, Friend, Activity 等 ) 。

OpenSocial 的 JavaScript APIs 主要包括：

• People and Friends Data API - 存取用户，朋友等与人有关的信息。
• Activities Data API – 发布，取得，分享用户的活动信息
• Persistence Data API – 提供存储机制，用于存储用户的社交信息。

关于更多的有关 OpenSocial 规范内容，请读者参考资源列表。

Shindig 简介

Shindig 是 OpenSocial 规范的引用实现，其主要的组件包括 :

• Gadget Server( 负责解析 Gadget XML, 转化成浏览器使用的 HTML/JS/CSS)
• OpenSocial Data Server( 提供 RESTful/RPC 协议的 Services)
• 可下载的 JavaScript 库 (OpenSocial 客户端 JavaScript 环境 , Gadget 客户端支持 )

图 3 是 Shindig 实现的组件图。

目前，在服务器端，Shindig 提供了 Java/PHP 两个实现版本，更多的内容，请读者参考资源列表。

回页首

使用 OSDE 开发 OpenSocial 应用

OSDE 是一个 Eclipse 的插件，提供了开发者基于 Eclipse 的 OpenSocial 开发环境。 OSDE 使用 Shindig Server 提供本地的开发与调试，用 Java H2 数据库 (http://www.h2database.com/html/main.html) 存储管理 Social 数据。接下来，本节将一步步详解怎样在 Eclipse 中使用 OSDE 进行 OpenSocial 的应用开发。

安装 OSDE

OSDE 的安装要求 Eclipse3.4.1 版本 ( 或者更高版本 ) 以及使用 J2SE1.5( 或者更高版本 ) 。读者可以使用 Eclipse 的 updatesite 机制，连接到 "http://opensocial-development-environment.googlecode.com/svn/update-site/site.xml". 站点，安装 OSDE 。

构建 OpenSocial 应用

首先，我们启动 Shindig 服务器，添加我们测试所需要的 Social 数据。

在启动 Shindig 服务器之后，转到 OpenSocial 透视图 (Perspective)，在 People View，往 H2 数据库增加我们调试使用的 People 数据。

当然，你也可以选择 [OSDE] -> [Create sample data in Shindig] 菜单 , 让 OSDE 来帮助你创建 Social 数据。

在我们的这个例子中，增加了四个数据样本：canonical，john.doe，jane.doe 和 george.doe, john.doe，jane.doe 和 george.doe 都是 canonical 的朋友。

在我们准备好了这些后台的 Social 数据后，就可以在 Eclipse 里创建 OpenSocial 工程了。

选择 [File] -> [New] -> [Project...] 菜单，打开如图 3 所示的对话框，选择创建 OpenSocial 工程。

如图 6 所示，选择 OpenSocial Project, 点击下一步，OpenSocial 工程创建向导启动，帮助你完成工程的创建。

图 7 选择了让向导帮我们自动生成样例代码，获取 Social 数据 (Fetching a person data and friends) 。

当你的工程创建好之后，你可以通过 OSDE 提供的菜单运行它，如图 4 所示。

运行的结果如图 5 所示。

当我们点击” Fetch people and friends ”按钮，我们的 OpenSocial 应用会从 H2 数据库中查出数据，并显示在该页面。

代码分析

OpenSocial 工程创建向导给我们生成的样例代码如清单 1 所示。

<?xml version="1.0" encoding="UTF-8"?> 
 <Module> 
  <ModulePrefs title="test" author_email="lisanh@cn.ibm.com"> 
    <Require feature="opensocial-0.8" /> 
    <Require feature="dynamic-height" /> 
  </ModulePrefs> 
  <Content type="html" view="canvas"><![CDATA[ 

 <!-- Fetching People and Friends --> 
 <div> 
  <button onclick='fetchPeople();'>Fetch people and friends</button> 
  <div> 
    <span id='viewer'></span> 
    <ul id='friends'></ul> 
  </div> 
 </div> 
 <script type='text/javascript'> 
 function fetchPeople() { 
  var req = opensocial.newDataRequest(); 
  req.add(req.newFetchPersonRequest(opensocial.IdSpec.PersonId.VIEWER), 'viewer'); 
  var params = {}; 
  params[opensocial.IdSpec.Field.USER_ID] = opensocial.IdSpec.PersonId.VIEWER; 
  params[opensocial.IdSpec.Field.GROUP_ID] = 'FRIENDS'; 
  var idSpec = opensocial.newIdSpec(params); 
  req.add(req.newFetchPeopleRequest(idSpec), 'friends'); 
  req.send(function(data) { 
    var viewer = data.get('viewer').getData(); 
    document.getElementById('viewer').innerHTML = viewer.getId(); 
    var friends = data.get('friends').getData(); 
    document.getElementById('friends').innerHTML = ''; 
    friends.each(function(friend) { 
      document.getElementById('friends').innerHTML += '<li>' + friend.getId() + '</li>'; 
    }); 
    gadgets.window.adjustHeight(); 
  }); 
 } 
 </script> 
  ]]></Content> 
 </Module>

<Module> 表示 gadget.xml XML 文件描述的是一个 Gagdet 。 <ModulePrefs> 包括一些附加的信息，比如 Gadget 的标题，作者，文字描述等等。 <Require feature="opensocial-0.8" /> 表示这个 Gadget 会使用 Opensocial API 0.8 的功能。还可以添加其他 <Require> 标签让平台提供更多的功能以供这个 Gadget 使用。 <Content type="html"> 表示这个 Gadget 中的内容类型是基于 HTML 的。一般来说，对于大部分 OpenSocial 平台来说推荐使用这种类型。 <![CDATA[ … ]]>

是 Gadget 的主要内容，包含了一段 HTML，CSS 和 JavaScript 代码，形式就像一个正常网页中 <body> 内的部分。

“ Fetch people and friends ”逻辑实现在 fetchPeople 的函数里。 OpenSocial 使用了 VIEWER 和 OWNER 两个角色来定义 OpenSocial 用户：

• VIEWER：是正在观看这个 Gadget 的人，通常就是浏览器前的用户。一般都使用第一人称“我”。
• OWNER：是呈现这个 Gadget 的页面的人，是正被 VIEWER 观看的人，一般使用第三人称直呼其名。

在 fetchPeople 函数里，我们得到的是 VIEWER( 这里的 VIEWER 就是 canonical) 的朋友列表，并把他们显示成为 HTML 内容。

回页首

参考资源 (resources)

• OpenSocial for Java developers, by Chris Schalk, Jason Cooper
• OSDE Tutorial
• OpenSocial Specification 0.8
• Apache Shindig

关于作者

为本文评分

评论

回页首

内容

• 使用 OSDE 开发 OpenSocial 应用
• 参考资源 (resources)
• 关于作者
• 建议