构建 pureXML 和 JSON 应用程序，第 3 部分: 为 pureXML 创建 OpenSocial 小工具

核心提示： 这些参数分别为：url — 是一个包含想要向其发送请求的站点的 URL 的字符串，您可以看到，构建 pureXML 和 JSON 应用程序，第 3 部分: 为 pureXML 创建 OpenSocial 小工具(4)，要构建这个 URL，doPOST 函数用 getString 方法

这些参数分别为：

url — 是一个包含想要向其发送请求的站点的 URL 的字符串。您可以看到，要构建这个 URL，doPOST 函数用 getString 方法从 prefs 对象检索两个字符串。（参数 pureXMLHostAddress 和 contextRoot 指的是这个小工具定义中的元素名称，我们将在 后面的部分 做介绍。）这两个字符串由 /query/ 和命令（插入、getDocumentByKey、更新、删除等）连接起来。例如，当 insertJSON() 函数调用 doPOST 时，这个 URL 是：
http://xmlim.watson.ibm.com:9080/JSONUniversalServices/query/insert

callback — 指的是当请求返回时将要调用的函数的引用。例如，response 是一个显示事务状态的回调函数；displayJSONobj 是一个显示所返回的 JSON 对象或消息（当对象为空时）的回调函数。

opt_params — 是一个包含这个调用（HTTP 方法和 POST 数据）的额外参数的 JavaScript 对象。我们将这个请求的 HTTP 方法设置为 gadgets.io.MethodType.POST 以表明它是一个 POST 方法。我们还要传递 postdata 对象（被指定为包括键/值对的一个对象，通过使用 gadgets.io.encodeValues() 格式化输入 args）内的 post 数据。

将 清单 1 保存为 PureJSON.js。我们将构建个这个小工具定义并在下一个步骤中加载这个文件。

OpenSocial 小工具定义

有了所需的 JavaScript 后，就可以创建小工具定义了。

创建一个小工具定义 XML

我们需要的是一个简单的小工具定义。清单 2 提供了这个示例小工具定义。每个小工具定义都被包括在一个 <Module> 标签中。<ModulePrefs> 定义了这个小工具的基本信息和特性。

清单 2. OpenSocial 小工具的 XML 定义

编缉推荐阅读以下文章

• 构建 pureXML 和 JSON 应用程序，第 2 部分: 为公开 JSON 的 pureXML 创建 Universal Services
• 构建 pureXML 和 JSON 应用程序，第 1 部分: 使用 DB2 pureXML 储存和查询 JSON