DWR(Direct Web Remoting)是在Apache许可下的一个开源项目,他是一个非常专业的Java EE
@H_502_7@
Ajax框架。通过使用DWR框架,可以将Java组件的方法直接暴露给JavaScript客户端。
DWR还提供了一套JavaScript函数集,可用于简化DOM元素的操作,例如动态修改表格,动态修改列表框、下拉菜单等。
DWR的专业还体现在与其他Java EE框架的整合上——DWR可以与Spring和无缝整合,允许直接调用Spring容器中的Bean。DWR框架主要包括以下两个部分:
- 客户端的JavaScript,这部分代码使客户端的JavaScript可以直接调用远程服务器的java方法。除此之外,DWR还提供了一些方便的工具函数来简化DOM操作。
- 服务器上运行的Servlet负责处理用户请求,并将用户请求委托到实际java对象进行处理,并负责把处理结果返回客户端。
DWR会根据java类动态的生成JavaScript代码,通过这些动态生成的JavaScript代码将服务器端的java方法直接暴露给客户端的JavaScript,让用户产生一种错觉,通过使用DWR框架的帮助,客户端JavaScript代码能够直接调用远程java方法。实际上DWR依然是依赖XMLHttpRequest对象和服务器进行通信的。其基本原理是:当开发者直接调用远程java方法时,DWR会负责将这种调用转换成对应的Ajax请求,并使用XMLHttpRequest将请求发送到远程服务器端。当服务器处理完成后,DWR负责将处理结果传回给客户端的JavaScript代码。在整个Ajax交互过程中,DWR负责数据的传递和转换。
@H_502_7@简单示例:
第一步:导入jar包commons-logging-1.0.4.jar、dwr.jar。
第二步:编写web.xml、dwrDWR.xml(默认和web.xml位置一样)<?xml version="1.0" encoding="utf-8"?> <web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> <!-- 配置DWR的核心Servlet --> <servlet> <!-- 指定DWR核心Servlet的名字 --> <servlet-name>dwr-invoker</servlet-name> <!-- 指定DWR核心Servlet的实现类 --> <servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class> <!-- 指定DWR核心Servlet处于调试状态 --> <init-param> <param-name>debug</param-name> <param-value>true</param-value> </init-param> </servlet> <!-- 指定核心Servlet的URL映射 --> <servlet-mapping> <servlet-name>dwr-invoker</servlet-name> <!-- 指定核心Servlet映射的URL --> <url-pattern>/cyqdwr/*</url-pattern> </servlet-mapping> </web-app>
<?xml version="1.0" encoding="GBK"?> <!-- 指定DWR配置文件的DTD等信息 --> <!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 3.0//EN" "http://getahead.org/dwr/dwr30.dtd"> <dwr> <allow> <!-- 使用new创建器创建hello JavaScript对象 --> <create creator="new" javascript="hello"> <param name="class" value="com.bohua.dwr.HelloDwr"/> </create> <!-- 对com.bohua.beans.Person类使用Bean转换器 --> <convert converter="bean" match="com.bohua.beans.Person"/> <!-- 对com.bohua.beans.Cat 使用Object转换器 --> <convert converter="object" match="com.bohua.beans.Cat"> <param name="force" value="true"/> </convert> </allow> <!-- 因为sendListNoGeneric方法中list没有指定参数类型,需要借助signatures标签指定其类型 --> <signatures> <![CDATA[ import java.util.List; import com.bohua.dwr.HelloDwr; import com.bohua.beans.Person; HelloDwr.sendListNoGeneric(List<Person>); ]]> </signatures> </dwr>
第三步:编写dwr处理类以及实体类
package com.bohua.dwr; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import com.bohua.beans.Cat; import com.bohua.beans.Person; /** */ public class HelloDwr { // 第一个简单的hello方法 public String hello(String name) { return name + ",您好!您已经开始了DWR的学习之旅,祝您学得开心..."; } // 使用一个JavaBean作为参数的方法 public String sendObj(Person p ) { return p.getName() + ",您好!您已经学会了使用JavaBean参数..."; } // 返回JavaBean实例的方法 public Person getBean (String name) { return new Person(name); } // 返回一个普通的Java对象,Cat对象为其属性提供setter和getter方法 public Cat getObject(String name) { return new Cat("服务器端" + name); } // 返回一个集合对象 public List<Person> getPersonList() { List<Person> result = new ArrayList<Person>(); result.add(new Person("集合aaaa")); result.add(new Person("集合bbbb")); result.add(new Person("集合cccc")); return result; } // 返回一个数组对象 public Person[] getPersonArray() { Person[] result = new Person[3]; result[0] = new Person("数组aaaa"); result[1] = new Person("数组bbbb"); result[2] = new Person("数组cccc"); return result; } // 返回一个Map对象 public Map<String,Person> getPersonMap() { // 创建一个Map对象 Map<String,Person> result = new HashMap<String,Person>(); // 填充Map对象的内容 result.put("first",new Person("Map aaaa")); result.put("second",new Person("Map bbb")); result.put("third",new Person("Map cccc")); // 返回Map return result; } // 远程方法的参数是集合 public String sendList(List<Person> pl) { String result = ""; for (Person p : pl) { result += p.getName() + "<br />"; } return result; } // 远程方法的参数是不带泛型的集合 public String sendListNoGeneric(List pl) { String result = ""; for (Object p : pl) { result += ((Person)p).getName() + "<br />"; } return result; } // 远程方法的参数是集合 public String sendMap(Map<String,Person> pmap) { String result = ""; for (String key : pmap.keySet()) { result += "键" + key + " 其值为:" + pmap.get(key).getName() + "<br />"; } return result; } }
package com.bohua.beans; /** */ public class Cat { //Cat类的私有属性 private String name; //构造器 public Cat(String name) { this.name = name; } }
package com.bohua.beans; /** */ public class Person { // 私有Field private String name; public Person(String name) // 初始化全部成员变量的构造器 { this.name = name; } // name的setter和getter方法 public void setName(String name) { this.name = name; } public String getName() { return this.name; } // 无参数的构造器 public Person() { super(); } }
第四步:编写js文件 hellodwr.js
// -------------发送简单字符串参数,返回普通字符串-------------- function sendMessage() { // 获取页面中name元素的值 var name = document.getElementById("name").value; // 调用远程方法,cb是回调函数 hello.hello(name,cb) } var cb=function (data) { document.getElementById("show").innerHTML = data; } // -----------发送一个JavaBean对象作为参数,返回普通字符串------------ function sendObject() { var nameValue = document.getElementById("name").value; // 调用远程方法,使用JavaScript对象作为参数 hello.sendObj({name:nameValue},cb); } // ----------------调用返回JavaBean方法----------------- function getBean() { var name = document.getElementById("name").value; // 调用远程方法,beanCb是回调函数 hello.getBean(name,beanCb) } function beanCb(data) { // 服务器方法返回JavaBean对象,客户端的data是JavaScript对象 document.getElementById("show").innerHTML = data.name + ",您好,您已经学会了使用JavaBean返回值"; } // ----------------调用返回getObject方法--------------- function getObject() { var name = document.getElementById("name").value; // 调用远程方法,objCb是回调函数 hello.getObject(name,objCb) } function objCb(data) { // 服务器方法返回非JavaBean式的对象,客户端的data是JavaScript对象 document.getElementById("show").innerHTML = data.name + ",是从服务器返回的猫的名字"; } // ---------------调用返回集合的方法-------------- function getBeanList() { // 调用远程方法,listCb返回回调函数 hello.getPersonList(listCb); } // 远程Java方法返回List对象,集合元素是JavaBean式的对象 // 此处的data是JavaScript对象数组 function listCb(data) { var result=''; // 遍历每个数组元素 for (var i = 0 ; i < data.length ; i ++) { result += data[i].name + "<br />"; } document.getElementById("show").innerHTML = result; } // ---------------调用返回数组的方法-------------- function getBeanArray() { hello.getPersonArray(arrayCb); } function arrayCb(data) { var result = ""; // 下面的data是远程Java方法的返回值, // data是个数组,遍历数组。 for (var i = 0 ; i < data.length ; i ++) { //依次访问数组元素,数组元素是JSON格式的对象,访问其name属性 result += data[i].name + "<br />"; } document.getElementById("show").innerHTML = result; } // ---------------调用返回Map对象的方法------------- function getBeanMap() { hello.getPersonMap(mapCb); } // 远程Java方法返回Map对象,集合元素是JavaBean式的对象 // 此处的data是JavaScript对象,且每个属性值都是JavaScript对象 function mapCb(data) { var result=''; for (var key in data) { result += "键为" + key + ",其值为:" + data[key].name + "<br />"; } document.getElementById("show").innerHTML = result; } // ---------------调用发送集合的方法------------------- function sendBeanList() { // 创建JavaScript数组 var args = [ {name:"客户端aaa"},{name:"客户端bbb"},{name:"客户端ccc"} ]; // Java方法需要List参数,以JavaScript数组作为参数调用远程方法 hello.sendList(args,sendListCb); } function sendListCb(data) { document.getElementById("show").innerHTML = data; } // ---------------调用发送无泛型限制的集合-------------------- function sendBeanListNoGeneric() { // 创建JavaScript数组 var args = [ {name:"客户端aaa"},{name:"客户端ccc"} ]; // Java方法需要List参数,以JavaScript数组作为参数调用远程方法 hello.sendListNoGeneric(args,sendListCb); } // ---------------调用发送Map的方法------------------------- function sendBeanMap() { // 创建JavaScript对象 var args = { first:{name:"客户端aaa"},second:{name:"客户端bbb"},third:{name:"客户端ccc"} }; // Java方法需要Map参数,以JavaScript对象作为参数调用远程方法 hello.sendMap(args,sendMapCb); } function sendMapCb(data) { document.getElementById("show").innerHTML = data; }
第五步:编写html文件
<!DOCTYPE html> <html> <head> <Meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>DWR入门</title> <!-- 导入DWR引擎的核心JavaScript代码库 --> <script type='text/javascript' src='/20150627Ajax_Dwr_Test1/cyqdwr/engine.js' charset="utf-8"></script> <!-- 导入开发者为本应用编写的JavaScript代码库 --> <script type='text/javascript' src='js/hellodwr.js' charset="utf-8"></script> <!-- 导入DWR为hello对象动态生成的JavaScript代码库 --> <script type='text/javascript' src='/20150627Ajax_Dwr_Test1/cyqdwr/interface/hello.js' charset="utf-8"></script> </head> <body> <h3>DWR入门</h3> 请输入您的名字 <input id="name" name="name" type="text" /> <br /> <input type="button" value="发送简单请求" onclick="sendMessage();" /> <input type="button" value="发送对象参数" onclick="sendObject();" /> <input type="button" value="返回JavaBean" onclick="getBean();" /> <br /> <input type="button" value="返回Object" onclick="getObject();" /> <input type="button" value="返回Bean集合" onclick="getBeanList();" /> <input type="button" value="返回Bean数组" onclick="getBeanArray();" /> <br /> <input type="button" value="返回Bean Map" onclick="getBeanMap();" /> <input type="button" value="发送Bean集合" onclick="sendBeanList();" /> <input type="button" value="发送不带泛型限制的Bean集合" onclick="sendBeanListNoGeneric();" /> <br /> <input type="button" value="发送Bean Map" onclick="sendBeanMap();" /> <hr /> 下面是服务器的回应: <br /> <div id="show"></div> </body> </html>