DWR-Getting Started.pdf

### DWR入门指南 #### 一、DWR简介 DWR (Direct Web Remoting) 是一个简化Ajax开发的Java框架，它使得JavaScript可以像调用本地对象一样远程调用服务器端的Java对象。通过这种方式，开发者可以更加方便地在客户端与服务器之间进行交互。 #### 二、安装DWR JAR文件 1. **下载DWR JAR文件**： - 访问DWR官方网站（http://getahead.org/dwr/getstarted）下载`dwr.jar`。 - 确保下载的是适合当前项目版本的DWR JAR文件。 2. **放置JAR文件**： - 将下载好的`dwr.jar`文件放入项目的`WEB-INF/lib`目录下。 - 如果你的项目中已经存在其他JAR文件，确保`dwr.jar`与这些文件在同一目录下。 #### 三、配置DWR 1. **编辑`web.xml`文件**： - 在`WEB-INF/web.xml`中添加以下内容： ```xml <servlet> <servlet-name>dwr-invoker</servlet-name> <display-name>DWRServlet</display-name> <servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class> <init-param> <param-name>debug</param-name> <param-value>true</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>dwr-invoker</servlet-name> <url-pattern>/dwr/*</url-pattern> </servlet-mapping> ``` - 如果使用的是DWR 1.x版本，则`servlet-class`应设置为`uk.ltd.getahead.dwr.DWRServlet`。 2. **创建`dwr.xml`配置文件**： - 在`WEB-INF`目录下创建名为`dwr.xml`的文件，并添加以下内容作为起点： ```xml <!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD DirectWebRemoting 2.0//EN" "http://getahead.org/dwr/dwr20.dtd"> <dwr> <allow> <create creator="new" javascript="JDate"> <param name="class" value="java.util.Date"/> </create> <create creator="new" javascript="Demo"> <param name="class" value="your.java.Bean"/> </create> </allow> </dwr> ``` - 对于DWR 1.x版本，`<!DOCTYPE>`中的版本号需相应调整为1.0和10。 #### 四、理解DWR配置文件 1. **`dwr.xml`结构解析**： - `<dwr>`：DWR配置文件的根元素。 - `<allow>`：允许特定的类被创建和远程调用。 - `<create>`：指定可被创建的类及其对应的JavaScript名称。 - `creator="new"`：表示创建新实例。 - `javascript="JDate"`：客户端JavaScript中使用的名称。 - `<param>`：定义创建对象时传递的参数。 2. **示例解释**： - 第一个`<create>`元素允许客户端创建`java.util.Date`对象，并将其命名为`JDate`。 - 第二个`<create>`元素允许创建自定义的Java Bean，并在客户端使用`Demo`来引用。 #### 五、DWR工作原理 1. **客户端调用**： - 客户端通过JavaScript调用`JDate`或`Demo`方法，就像调用本地函数一样简单。 - 实际上，这些调用会通过HTTP请求发送到服务器端的DWR Servlet。 2. **服务器端处理**： - DWR Servlet接收到请求后，根据`dwr.xml`中的配置找到对应的Java类实例，并执行相应的操作。 - 处理结果会被序列化成JSON格式返回给客户端。 #### 六、总结 通过以上步骤，你可以成功地将DWR集成到现有的Web应用程序中，实现Ajax功能的增强。DWR通过简化客户端与服务器之间的通信过程，使得开发者能够更加专注于业务逻辑的实现。此外，DWR还提供了丰富的文档和支持社区，帮助开发者更好地理解和利用这一强大的框架。