使用Dojo开发定制Business Space小部件，第4部分

使用Dojo开发定制Business Space小部件，第4部分2011-01-21 IBM Divya Satyavarapu我们为本系列开发的定制小部件是基于 WebSphere V7.0 支持的 Business Space（以下简称 Business Space）中附带的 Dojo 版本，已经在 Mozilla Firefox 3.0.11 中测试过了。只是，我们开发的通用框架概念甚至可以应用到使用 Dojo 的应用程序中，但却不能用于 Business Space。学习本系列需要具备 DOJO 和 iWidget 框架的基本知识。

我们将讨论在基于 Dojo 的应用程序中经常遇到的主题。本系列分为以下几部分：

第 1 部分：使用通用的 markup 处理程序生成 DOJO markup

第 2 部分：使用通用的网格处理程序创建具有分页功能的 Dojo DataGrid 组件

第 3 部分：在 iWidget 中使用多个模板和从基本小部件继承

第 4 部分：使用通用 REST 处理程序从 iWidget 发出可配置的 REST 调用

在第 4 部分，您将学习如何使用一个通用 REST 处理程序从 iWidget 调用一个 REST 服务，该 REST 处理程序基于以下原理设计：

REST URI 通常是动态的，且在调用 REST 服务之前 URI（URL 参数）的一部分将被 iWidget 动态替换。我们的设计根据相应的 REST 关键字从 JSON 文件读取 REST URI。

查询参数是动态替代的。

REST 处理程序目前支持 JSON，但是根据需要很容易增强，支持 XML 和其他类型。

REST 处理程序支持 GET、POST/RAWPOST、PUT、RAWPUT 和 DELETE 操作，也支持文件上传和下载操作。

在本文中，我们将介绍 REST 处理程序的实现以及在您的 iWidget 中如何使用它。

以下文件在 Part4SampleCode.zip 中提供下载：

JSONRestHandler.js：通用 REST 处理程序 Javascript 类。

restURI.json：包含 REST URI 的 JSON 文件。

testJSONRestHandler.js：Javascript 类，展示如何在您的代码中使用 JSONRestHandler。

处理程序的实现

JSONRestHandler Javascript 类加载 loadRESTConfig（）方法中含有 REST URI 信息的 JSON 文件。

loadRESTConfig（）方法接受以下参数：

type：操作类型，如 GET/POST/PUT，等等。

restCallKey：JSON 文件中的 keyName，例如 EmployeeList。

restEndPoint：运行 REST 应用程序的 REST 端点；例如 http://<server>:<ip>/restAPI。

loadMethod：此方法在 REST URI 成功加载时调用。

errorMethod：如果调用 REST URI 出现错误，该方法被调用。

syncFlag：REST 调用应该是同步或异步（true 或 false）。

thisVar：调用类的引用。

parameters：含有 3 个变量（urlParameters、queryParameters、content）。如果 URI 有 URL 或查询参数，该对象需要用相应的值进行设置。

只有在 POST 请求时内容才被发送。