### DWR中文文档v0.9 - DWR入门与实现
#### 1. DWR简介
DWR（Direct Web Remoting）是一个强大的Java开源库，它使得开发人员能够在客户端JavaScript中轻松地调用服务器端的Java方法，就像这些方法直接在客户端运行一样。通过这种方式，DWR极大地简化了AJAX应用程序的开发过程。
DWR的核心价值在于：
- **客户端与服务器之间的无缝通信**：通过DWR，开发者可以轻松实现客户端与服务器之间的数据交换，而无需关心底层的通信细节。
- **简洁易用**：DWR提供了一套完整的解决方案，包括服务器端组件、客户端脚本库等，使得开发者能够快速构建复杂的AJAX应用。
- **高效性**：DWR支持多种数据传输格式（如JSON），并采用高效的序列化技术，从而提高数据传输效率。
#### 2. DWR的主要组成部分
DWR主要由两大部分组成：
1. **服务器端组件**：该组件是一个运行在服务器上的Java Servlet，负责处理来自客户端的请求，并将结果反馈给客户端。它是DWR的核心部分，实现了远程调用的基本逻辑。
2. **客户端JavaScript库**：这部分代码运行在用户的浏览器中，负责发起请求并与服务器进行交互。客户端库还提供了许多高级特性，例如错误处理、事件监听等。
#### 3. DWR的工作原理
DWR的工作流程可以概括为以下几个步骤：
1. **初始化**：客户端加载DWR提供的JavaScript库。
2. **定义服务接口**：开发者需要定义哪些服务器端的Java方法可以通过DWR访问。这通常是在`dwr.xml`文件中完成的。
3. **远程调用**：客户端通过简单的JavaScript函数调用来触发服务器端的方法执行。
4. **回调处理**：服务器端方法执行完毕后，结果会通过回调函数返回给客户端，客户端可以根据这些结果更新页面状态。
#### 4. DWR与传统RPC的区别
- **透明性**：DWR提供了类似于本地调用的体验，隐藏了网络通信的复杂性。
- **异步性**：虽然Java本质上是同步的，但DWR通过异步回调机制实现了真正的异步通信。
- **无需插件**：DWR不依赖于任何额外的浏览器插件，可以在所有主流浏览器中正常工作。
#### 5. DWR入门示例：HelloWorld
为了帮助初学者快速上手DWR，下面提供了一个简单的“HelloWorld”示例，展示了如何在一个基本的Web项目中集成DWR。
##### 5.1 集成DWR
1. **下载DWR库**：从DWR官方网站下载最新版本的`dwr.jar`包，将其放置在项目的`WEB-INF/lib`目录下。
2. **复制JavaScript文件**：将`dwr-版本号-src.zip`中的`engine.js`和`util.js`文件解压后，复制到项目的`js`目录下。
##### 5.2 配置文件设置
1. **修改`web.xml`**：在项目的`WEB-INF`目录下找到`web.xml`文件，添加以下配置以注册DWR Servlet：
```xml
<servlet>
<servlet-name>dwr-invoker</servlet-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>
```
2. **创建`dwr.xml`**：同样在`WEB-INF`目录下新建一个名为`dwr.xml`的文件，用于定义可被客户端调用的服务接口。例如：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE direct-web-remoting SYSTEM "dwr.dtd">
<direct-web-remoting>
<create>
<param name="class">com.example.HelloWorldService</param>
<param name="name">helloWorld</param>
</create>
</direct-web-remoting>
```
在这个示例中，我们定义了一个名为`HelloWorldService`的服务接口，客户端可以通过`helloWorld`这个名字来调用它。
#### 6. 总结
DWR为开发高质量的AJAX应用程序提供了一个强大而灵活的框架。通过上述介绍，我们可以看到DWR不仅简化了客户端与服务器之间的通信过程，而且还大大提高了开发效率。无论是对于初学者还是经验丰富的开发者来说，掌握DWR都将是一个巨大的优势。
