
修炼修炼再修炼 成长成长再成长
可以在可访问的方法旁边的文本框中输入参数值并点击 Execute 按钮调用方法。服务器的响应将在警告框中用 JSON 标注显示出来,如果是简单值,就会内联在方法旁边直接显示。这个测试页非常有用。它们不仅允许检查公开了哪个类和方法用于远程,还可以测试每个方法是否像预期的那样工作。
如果对远程方法的工作感到满意,就可以用 DWR 生成的 JavaScript 存根从客户端代码调用服务器端对象。
调用远程对象
远程 Java 对象方法和对应的 JavaScript 存根函数之间的映射很简单。通用的形式是 JavaScriptName.methodName(methodParams ..., callBack),其中 JavaScriptName 是 creator 的 javascript 属性指定的名称,methodParams 代表 Java 方法的 n 个参数,callback 是要用 Java 方法的返回值调用的 JavaScript 函数。如果熟悉 Ajax,可以看出这个回调机制是 XMLHttpRequest 异步性的常用方式。
在示例场景中,我用清单 3 中的 JavaScript 函数执行搜索,并用搜索结果更新用户界面。这个清单还使用来自 DWR 的 util.js 的便捷函数。要特别说明的是名为 $() 的 JavaScript 函数,可以把它当作 document.getElementById() 的加速版。录入它当然更容易。如果您使用过 JavaScript 原型库,应当熟悉这个函数。
清单 3. 从客户机调用远程的 findItems()
/*
* Handles submission of the search form
*/
function searchFormSubmitHandler() {
// Obtain the search expression from the search field
var searchexp = $("searchbox").value;
// Call remoted DAO method, and specify callback function
catalog.findItems(searchexp, displayItems);
// Return false to suppress form submission
return false;
}
/*
* Displays a list of catalog items
*/
function displayItems(items) {
// Remove the currently displayed search results
DWRUtil.removeAllRows("items");
if (items.length == 0) {
alert("No matching products found");
$("catalog").style.visibility = "hidden";
} else {
DWRUtil.addRows("items",items,cellFunctions);
$("catalog").style.visibility = "visible";
}
}
在上面的 searchFormSubmitHandler() 函数中,我们感兴趣的代码当然是 catalog.findItems(searchexp, displayItems);。这一行代码就是通过网络向 DWR servlet 发送 XMLHttpRequest 并用远程对象的响应调用 displayItems() 函数所需要的全部内容。
displayItems() 回调本身是由一个 Item 数组表示调用的。这个数组传递给 DWRUtil.addRows() 便捷函数,同时还有要填充的表的 ID 和一个函数数组。表中每行有多少单元格,这个数组中就有多少个函数。按照顺序使用来自数组的 Item 逐个调用每个函数,并用返回的内容填充对应的单元格。
在这个示例中,我想让商品表中的每一行都显示商品的名称、说明和价格,并在最后一列显示商品的 Add to Cart 按钮。清单 4 显示了实现这一功能的单元格函数数组:
在这里重要的是要记住,simpleContents 是一个把 String 映射到数字的 JavaScript 数组。每个字符串都是一个商品的名称,关联数组中的对应数字就是购物车中该商品的数量。所以表达式 cart.simpleContents[item] + " x " + item 可能就会计算出 “2 x Oolong 128MB CF Card” 这样的结果。
DWR 商店应用程序
图3 显示了这个基于 DWR 的 Ajax 应用程序的使用情况:显示了通过搜索检索到的商品,并在右侧显示用户的购物车:
图 3. 基于 DWR 的 Ajax 商店应用程序的使用情况
DWR 的安全性
DWR 设计时就考虑了安全性。使用 dwr.xml 明确地列出那些想做远程处理的类和方法,可以避免意外地把那些可能被恶意利用的功能公开出去。除此之外,使用调试测试模式,可以容易地审计所有公开到 Web 上的类和方法。
DWR 也支持基于角色的安全性。通过 bean 的 creator 配置,可以指定用户访问特定 bean 所必须属于的 J2EE 角色。通过部署多个 URL 受保护的 DWRServlet 实例,每个实例都有自己的 dwr.xml 配置文件,也可以提供拥有不同远程功能的用户集。
调用批处理
在 DWR 中,可以在一个 HTTP 请求中向服务器发送多个远程调用。调用 DWREngine.beginBatch() 告诉 DWR 不要直接分派后续的远程调用,而是把它们组合到一个批请求中。DWREngine.endBatch() 调用则把批请求发送到服务器。远程调用在服务器端顺序执行,然后调用每个 JavaScript 回调。
批处理在两方面有助于降低延迟:第一,避免了为每个调用创建 XMLHttpRequest 对象并建立相关的 HTTP 连接的开销。第二,在生产环境中,Web 服务器不必处理过多的并发 HTTP 请求,改进了响应时间。
DWR 的利弊
现在可以看出用 DWR 实现由 Java 支持的 Ajax 应用程序有多么容易了。虽然示例场景很简单,我实现用例的手段也尽可能少,但是不应因此而低估 DWR 引擎相对于自己设计 Ajax 应用程序可以节约的工作量。在前一篇文章中,我介绍了手工设计 Ajax 请求和响应、把 Java 对象图转化成 JSON 表示的全部步骤,在这篇文章中,DWR 替我做了所有这些工作。我只编写了不到 50 行 JavaScript 就实现了客户机,而在服务器端,我需要做的所有工作就是给常规的 JavaBean 加上一些额外方法。
当然,每种技术都有它的不足。同任何 RPC 机制一样,在 DWR 中,可能很容易忘记对于远程对象进行的每个调用都要比本地函数调用昂贵得多。DWR 在隐藏 Ajax 的机械性方面做得很好,但是重要的是要记住网络并不是透明的 —— 进行 DWR 调用会有延迟,所以应用程序的架构应当让远程方法的粒度比较粗。正是为了这个目的,addItemToCart() 才返回 Cart 本身。虽然让 addItemToCart() 作为一个 void 方法可能更自然,但是这样的话对它的每个 DWR 调用后面都必须跟着一个 getCart() 调用以检索修改后的 Cart 状态。
对于延迟,DWR 在调用的批处理中有自己的解决方案(请参阅侧栏的 调用批处理)。如果不能为应用程序提供适当粗粒度的 Ajax 接口,那么只要有可能把多个远程调用组合到一个 HTTP 请求中,就请使用调用批处理。
分离的问题
从实质上看,DWR 在客户端和服务器端代码间形成了紧密的耦合,这有许多含义:首先,远程方法 API 的变化需要在 DWR 存根调用的 JavaScript 上反映出来。第二(也是最明显的),这种耦合会造成对客户端的考虑会渗入服务器端代码。例如,因为不是所有 Java 类型都能转化成 JavaScript,所以有时有必要给 Java 对象添加额外方法,好让它能够更容易地远程化。在示例场景中,我通过把 getSimpleContents() 方法添加到 Cart 来解决这个问题。我还添加了 getCart() 方法,它在 DWR 场景中是有用的,但在其他场景中则完全是多余的。由于远程对象粗粒度 API 的需要以及把某些 Java 类型转化成 JavaScript 的问题,所以可以看到远程 JavaBean 会被那些只对 Ajax 客户有用的方法“污染”。
为了克服这个问题,可以使用包装器类把额外的特定于 DWR 的方法添加到普通 JavaBean。这意味着 JavaBean 类的 Java 客户可能看不到与远程相关联的额外的毛病,而且也允许给远程方法提供更友好的名称 —— 例如用 getPrice() 代替 getFormattedPrice()。图 4 显示的 RemoteCart 类对 Cart 进行了包装,添加了额外的 DWR 功能:
图 4. RemoteCart 为远程功能对 Cart 做了包装
最后,需要记住:DWR Ajax 调用是异步的,所以不要期望它们会按照分派的顺序返回。在示例代码中我忽略了这个小问题,但是在这个系列的第一篇文章中,我演示了如何为响应加时间戳,以此作为保证数据到达顺序的一种简单手段。
结束语
正如所看到的,DWR 提供了许多东西 —— 它允许迅速而简单地创建到服务器端域对象的 Ajax 接口,而不需要编写任何 servlet 代码、对象序列化代码或客户端 XMLHttpRequest 代码。使用 DWR 部署到 Web 应用程序极为简单,而且 DWR 的安全性特性可以与 J2EE 基于角色的验证系统集成。但是 DWR 并不是对于任何一种应用程序架构都适合,所以在设计域对象的 API 时需要做些考虑。
如果想学习用 DWR 进行 Ajax 的利弊的更多内容,最好的方式就是下载并开始实践。DWR 有许多我没有介绍的特性, 文章源代码 是把 DWR 投入使用的一个良好起点。请参阅 参考资料,学习关于 Ajax、DWR 和相关技术的更多内容。
这里要指出的最重要的一点是:对于 Ajax 应用程序,没有包治百病的解决方案。Ajax 是一个快速发展的领域,不断有新技术涌现。在这个系列的文章中,我的重点在于带您开始在 Ajax 应用程序的 Web 层中利用 Java 技术 —— 不管是选择基于 XMLHttpRequest 的带有对象序列化框架的技术,还是选择 DWR 这样的更高级抽象。