DWR框架搭建以及使用

末蓝、 2022-06-14 05:53 446阅读 0赞

## **1，DWR介绍** ##

DWR（Direct Web Remoting）是一个用于改善web页面与Java类交互的远程服务器端Ajax开源框架，可以帮助开发人员开发包含AJAX技术的网站。它可以允许在浏览器里的代码使用运行在[WEB服务器][WEB]上的JAVA函数，就像它就在浏览器里一样。

它包含两个主要的部分:允许[JavaScript][]从[WEB服务器][WEB]上一个遵循了[AJAX][]原则的[Servlet][]中获取数据.另外一方面一个JavaScript库可以帮助[网站开发][Link 1]人员轻松地利用获取的数据来动态改变网页的内容.

## 2，安装配置 ##

### **2.1安装dwr.jar包和commos-loggings.jar包** ###

dwr.jar包是DWR框架的核心包。可在官网下载：

地址：[http://directwebremoting.org/dwr/downloads/index.htm][http_directwebremoting.org_dwr_downloads_index.htm][l][http_directwebremoting.org_dwr_downloads_index.htm]

![Center][]

### dwrdemo.war是官方提供的参考war包，有基本DWR框架的配置，也有dwr.jar包和commos-loggings.jar包。 ###

### 2.2 配置wel.xml ###

<?xml version="1.0" encoding="utf-8"?>
    <!DOCTYPE web-app PUBLIC
        "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
        "http://java.sun.com/dtd/web-app_2_3.dtd">
    <web-app id="dwr">
      <servlet>
        <servlet-name>dwr-invoker</servlet-name>
        <display-name>DWR Servlet</display-name>
        <description>Direct Web Remoter Servlet</description>
        <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>
    </web-app>

规定这样配置，复制即可。

注意：<url-pattern>/dwr/\*</url-pattern>中的dwr就是页面（下图）的src路径中dwr。

![Center 1][]

### 2.3 dwr.xml配置 ###

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 3.0//EN" "http://getahead.org/dwr/dwr30.dtd">
    <dwr>
    
    <allow>
            
            
            <create creator="new" javascript="test">
                <param name="class" value="com.dwr.DwrTest" />
            </create>
            
           <convert match="com.dwr.User" converter="bean"/>  
        </allow>
    </dwr>

dwrdemo.war包中有配置模板，可以复制过来做修改即可。

### 2.4 jsp页面配置 ###

![Center 2][]

jsp页面如果要使用DWR框架，需提交上图的代码，src路径中的dwr是web.xml文件中<url-pattern>/dwr/\*</url-pattern>节点的dwr.       engine.js,util.js,interface是规定格式，test是dwr.xml配置文件javascript属性的值test。

以下是dwr.xml配置的补充，了解即可。

**<create>标签是dwr中重要的标签，用来描述java（服务器端） 与javascript （客户端）的交互方式。其基本格式如下：**

**creator属性** 是必须的 \-它用来指定使用那种创造器。

默认情况下DWR1.1有8种创造器。它们是：

· new: 用Java的new关键字创造对象。

· none: 它不创建对象，看下面的原因。 (v1.1+)

· scripted: 通过BSF使用脚本语言创建对象，例如BeanShell或Groovy。

· spring: 通过Spring框架访问Bean。

· jsf: 使用JSF的Bean。 (v1.1+)

· struts: 使用Struts的FormBean。 (v1.1+)

· pageflow: 访问Beehive或Weblogic的PageFlow。 (v1.1+)

如果你需要写自己的创造器，你必须在init部分注册它。

**javascript属性** 用于指定浏览器中这个被创造出来的对象的名字。你不能使用Javascript的关键字。

**scope属性** 非常类似servlet规范中的scope。它允许你指定这个bean在什么生命范围。选项有"application", "session", "request" 和"page"。这些值对于Servlet和JSP开发者来说应该相当熟悉了。

scope属性是可选的。默认是"page"。如果要使用"session"需要cookies。当前的DWR不支持ULR重写。

**param元素** 被用来指定创造器的其他参数，每种构造器各有不同。例如，"new"创造器需要知道要创建的对象类型是什么。每一个创造器的参数在各自的文档中能找到。请查看上面的链接。

**include和exclude元素** 允许创造器来限制类中方法的访问。一个创造器必须指定include列表或exclude列表之一。如果是include列表则暗示默认的访问策略是"拒绝"；如果是exclude列表则暗示默认的访问策略是"允许"。

例如要拒绝防范除了*setWibble()*以外的所有方法，你应该把如下内容添加到dwr.xml中。

对于加入到create元素中的类的所有方法都是默认可见的。

**auth元素** 允许你指定一个J2EE的角色作为将来的访问控制检查:

## 3，DWR的简单使用 ##

### 3.1 java DWR实现类DwrTest ###

### `package com.dwr; import java.util.List; import java.util.Map; /*** * DWR的实现类 * @author ZhongBingLin * */ public class DwrTest { /** * * @param list 存有实体类User对象的list对象 页面传过来的值 * @return list 存有实体类User对象的list对象 在页面可以得到 */ public List<User> list(List<User> list) { for (User user : list) { System.out.println(user.toString()); } return list; } /** * * @param map Map<String,User>对象 页面传过来的值 * @return map Map<String,User>对象 在页面可以得到 */ public Map<String,User> map(Map<String,User> map) { for (String str: map.keySet()) { System.out.println(str+","+map.get(str).toString()); } return map; } }`         ###

### 3.2 javaBean类User ###

package com.dwr;
    
    public class User {
    	private int id;
    	private String name;
    	private String addr;
    	public int getId() {
    		return id;
    	}
    	public void setId(int id) {
    		this.id = id;
    	}
    	public String getName() {
    		return name;
    	}
    	public void setName(String name) {
    		this.name = name;
    	}
    	public String getAddr() {
    		return addr;
    	}
    	public void setAddr(String addr) {
    		this.addr = addr;
    	}
    	public String toString() {
    		return "[id=" + id + ", name=" + name + ", addr=" + addr + "]";
    	}	
    }

### 3.3 Jsp页面 test.jsp ###

<%@ page language="java" contentType="text/html; charset=utf-8"
        pageEncoding="utf-8"%>
    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
    <html>
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>dwr test</title>
    <script type="text/javascript" src="<%=request.getContextPath()%>/dwr/engine.js"></script>
    <script type="text/javascript" src="<%=request.getContextPath()%>/dwr/util.js"></script>
    <script type="text/javascript" src="<%=request.getContextPath()%>/dwr/interface/test.js"></script>
    </head>
    <script type="text/javascript">
    function list()
    {
    	var a = {id:1,name:"肖亮亮",addr:"湖南永州"};
    	var b = {id:2,name:"唐为强",addr:"广东深圳"};
    	test.list([a,b],function(userList)
    	{
    		 for(var i=0;i<userList.length;i++){
    		     alert("id="+userList[i].id+",name="+userList[i].name+",addr="+userList[i].addr);
    		  }
    	});
    }
    function map()
    {
    	var a = {id:1,name:"肖亮亮",addr:"湖南永州"};
    	var b = {id:2,name:"唐为强",addr:"广东深圳"};
    	test.map({"id1":a,"id2":b},function(userMap){
    		for(var key in userMap){
    			alert(key+": "+userMap[key].id+","+userMap[key].name+","+userMap[key].addr);
    		}
    	});
    }
    </script>
    <body>
    	<button οnclick="list()">list</button>
    	<button οnclick="map()">map</button>
    </body>
    </html>

### 3.4页面效果 ###

图1：

![Center 3][]

图2：

![Center 4][]

页面点击list按钮触发事件，js中test对象调用了DwrTest类的list方法，打印图1效果，传了一个参数list对象，返回值userList传入回调函数，在函数中跳出图效果。

点击map按钮有类似效果，这里就不再描述了。

[WEB]: http://baike.baidu.com/view/460250.htm
[JavaScript]: http://baike.baidu.com/view/16168.htm
[AJAX]: http://baike.baidu.com/subview/1641/5762264.htm
[Servlet]: http://baike.baidu.com/view/25169.htm
[Link 1]: http://baike.baidu.com/view/71517.htm
[http_directwebremoting.org_dwr_downloads_index.htm]: http://directwebremoting.org/dwr/downloads/index.html
[Center]: /images/20220614/66dd55bc27774bc7a0ae302f4af8035b.png
[Center 1]: /images/20220614/3f5580bd15324648ae905dfb2dbd5e44.png
[Center 2]: /images/20220614/2995408552f34a3db40e5827ff3e7fa6.png
[Center 3]: /images/20220614/9d851115b1044dbdb0ef97fda93eeff9.png
[Center 4]: /images/20220614/9c0083666cbd4911920837c81f9c7bad.png