DWR(Direct Web Remoting)介绍

### DWR (Direct Web Remoting) 介绍与应用 #### 一、概述 DWR（Direct Web Remoting）是一个开放源代码的项目，遵循Apache许可协议。它为开发者提供了一个强大的工具集，使得通过JavaScript调用Java方法变得简单直接。在DWR中，主要包含了以下几个部分：服务器端Java库、DWR servlet以及客户端JavaScript库。DWR的设计目标是简化Ajax应用的开发过程，并且提供了一种更加优雅的方式来处理客户端与服务器之间的交互。 #### 二、DWR的特点 尽管DWR并非Java平台上唯一的Ajax-RPC工具包，但它却是最成熟和功能最为丰富的之一。DWR的特点包括： 1. **简化远程调用**：DWR允许前端JavaScript代码直接调用后端Java方法，无需编写额外的XML或JSON序列化代码。 2. **完整的Ajax应用程序支持**：DWR不仅支持传统的异步请求，还支持更高级的全双工通信模式，如长轮询(long polling)和WebSocket。 3. **安全性和权限控制**：DWR提供了一套完善的机制来控制哪些JavaScript方法可以访问哪些Java方法，确保了应用的安全性。 4. **自动生成JavaScript代理类**：DWR能够根据Java接口自动生成相应的JavaScript代理类，从而减少了大量的编码工作。 #### 三、DWR的配置与使用示例 为了更好地理解DWR的工作原理及其配置方式，我们将通过一个简单的例子来详细介绍DWR的基本配置和使用流程。 ##### 1. 配置dwr.xml ```xml <dwr> <allow> <create creator="new" javascript="testClass"> <param name="class" value="com.dwr.TestClass"/> <include method="testMethod1"/> </create> </allow> </dwr> ``` 在上面的示例中，`<allow>`标签用于指定哪些操作被允许。`<create>`标签定义了一个名为`testClass`的JavaScript对象，该对象对应于Java中的`com.dwr.TestClass`类。通过`<include>`标签指定了允许被JavaScript调用的方法名称。 ##### 2. JavaScript代码 接下来是在客户端的JavaScript代码中调用DWR服务的例子： ```javascript <script src='dwr/interface/testClass.js'></script> <script src='dwr/engine.js'></script> <script src='dwr/util.js'></script> function callTestMethod1() { testClass.testMethod1(); } ``` 在此示例中，我们加载了由DWR自动生成的`testClass.js`文件，这个文件包含了对`TestClass`类的JavaScript代理。然后，我们定义了一个名为`callTestMethod1`的函数来调用`testClass.testMethod1()`。 #### 四、示例扩展 为了进一步演示DWR的强大功能，下面我们将展示如何在客户端JavaScript代码中传递参数给Java方法，以及如何处理返回值。 ##### 1. 使用回调函数处理返回值 ```xml <dwr> <allow> <create creator="new" javascript="testClass"> <param name="class" value="com.dwr.TestClass"/> <include method="testMethod2"/> </create> </allow> </dwr> ``` ```javascript function callTestMethod2() { testClass.testMethod2(callBackForTestMethod2); } function callBackForTestMethod2(data) { alert("The return value is " + data); } ``` 在本例中，`testMethod2`接受一个回调函数`callBackForTestMethod2`作为参数。当`testMethod2`执行完成后，会调用此回调函数并传递结果。 ##### 2. 处理复杂的Java对象 ```xml <dwr> <allow> <create creator="new" javascript="testClass"> <param name="class" value="com.dwr.TestClass"/> <include method="testMethod3"/> </create> </allow> </dwr> ``` ```javascript function callTestMethod3() { var complexObject = new ComplexObject("foo", 42); testClass.testMethod3(complexObject, function(result) { console.log(result); }); } ``` 在这个例子中，我们向`testMethod3`传递了一个名为`ComplexObject`的复杂Java对象。DWR会自动处理这个对象的序列化和反序列化过程，使得我们可以轻松地在客户端和服务器之间传递复杂数据结构。 #### 五、结论 DWR提供了一种简洁而强大的方式来实现Ajax应用程序中的远程方法调用。它不仅可以极大地提高开发效率，还可以帮助开发者构建出更加强大和灵活的Web应用程序。通过以上介绍和示例，相信读者已经对DWR有了一个全面的认识。