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

让我们来看看每个函数的用途:

getPrimaryKeys 向此服务发布一个 getPrimaryKeys 请求来从 DB2 表检索所有主键并在事务完成后利用回调函数 displayJSONobj 显示检索结果。

getJSONDocumentByKey 使用一个键值向此服务发布一个 getDocumentByKey 来检索主键与这个输入值相匹配的一个 JSON 记录。回调函数 displayJSONobj 用来显示结果。

insertJSON 需要两个输入参数：主键的惟一键值与 JSON 格式的行数据。它向此服务发布一个请求来在 DB2 表内创建一个新行并在事务返回时用回调函数 response 来确认插入状态。

updateJSON 的作用是向此服务发布一个请求，用与输入键值相匹配的主键和指定为 JSON 格式的作为输入数据的更新后数据来更新一个 JSON 记录。它还将在事务完成时调用回调函数 response 来确认更新。

deleteDocument 的作用是根据指定的输入主键来将删除记录请求发布到此服务。它还能在请求完成后调用 response 回调函数来确认删除。

displayJSONobj 是一个抽象 JavaScript 函数，这个函数为开发人员提供了在浏览器中呈现调用结果的不同方式。

response 是一个用来处理非 JSON 返回值的函数。它采用了与 displayJSONobj 相似的策略 ，即需要开发人员用其自已的实现来覆盖这个函数。

上述函数会调用 doPOST 函数来提交它们的请求。doPOST 函数使用服务查询命令、查询输入值及一个回调函数来处理从这些服务返回的结果。它使用这些输入参数来构建 gadgets.io.makeRequest 服务调用。gadgets.io.makeRequest 是一个 OpenSocial 小工具函数，它为小工具从第三方站点获取数据和向第三方站点发布数据提供了支持。其语法类似于： gadgets.io.makeRequest(url, callback, opt_params)

编缉推荐阅读以下文章

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