从DWR官网下载最新版本的jar包,地址:http://directwebremoting.org/dwr/downloads/index.html
云盘下载:http://pan.baidu.com/s/1pLxS77X
dwr.xml是dwr的核心配置文件,主要的标签有:<converter>、<convert>、<create>这三个标签。
<converter>标签是dwr中内置的转换器。我们也可以使用自己写的转换器,不过dwr提供的转换器已经足够了,所以这个标签,一般不会自己去写。
<convert>标签是将converter中定义的转换器映射到的具体类型,如:
<converter id="date"class="org.directwebremoting.convert.DateConverter"/><!-- 注册了 date 转换器 -->
<!-- 注意:converter标签必须放到<init>标签内,而convert是放在<allow>标签内,这里只是示例,并不是完整的dwr.xml -->
<convert converter="date"match="java.util.Date"/><!-- 将注册的 date 转换器应用到 java.util.Date 类型
-->
<create>标签是dwr中重要的标签,用来描述 java(服务器端) 与 javascript (客户端)的交互方式。其基本格式如下:
<allow>
<create creator="..." javascript="..." scope="...">
<param name="..." value="..."/>
<auth method="..." role="..."/>
<exclude method="..."/>
<include method="..."/>
</create>
...
</allow>
其中,creator和javascript是必须属性,其他可以忽略。creator包含有以下几个值:
new:Java用“new”关键字创造对象
none:它不创建对象 (v1.1+)
scripted:通过BSF使用脚本语言创建对象,例如BeanShell或Groovy
spring:通过Spring框架访问Bean
struts:使用Struts的FormBean (v1.1+)
jsf:使用JSF的Bean (v1.1+)
pageflow:访问Weblogic或Beehive的PageFlow (v1.1+)
ejb3:使用EJB3 session bean (v2.0+)
关于这几个属性如何使用,这里就不在详细阐述了。我只列出一个与spring整合的例子:
<create creator="spring" javascript="backUpDocumentService">
<param name="beanName" value="testDWR1" />
<include method="modifyBackUpFiles"></include>
<include method="isSafeCodeRight"></include>
</create>
<!-- 加include可以具体指定java类中关的方法,不加则默认类中全部为public的方法 -->
<create creator="spring" javascript="testDWR2">
<param name="beanName" value="testDWR2" />
</create>
spring配置文件
<bean id="testDWR1" class="com.test.testDWR1"></bean>
<bean id="testDWR2" class="com.test.testDWR2"></bean>
3. 页面配置
在jsp页面添加三个 js 文件,分别是
<script type='text/javascript' src='dwr/util.js'></script>
<script type='text/javascript' src='dwr/engine.js'></script>
<script type='text/javascript' src='dwr/interface/Test.js'>
5. 其他
dwr可以设置是否采用异步方式访问java代码,其代码为:
dwr.engine.setAsync(false); //false为同步,true(默认)为异步
以及dwr对于异常的处理,这里我只列出个简单的全局性异常捕获,具体到针对某个方法的异常捕获,大家可以自己上网找找。
dwr.engine.setErrorHandler(errh);
function errh(errorString, exception) {
errorFlag = true;
alert("操作失败!");
}
dwr同样支持参数为对象的方法,这需要在dwr.xml中配置下<convert>标签:
<convert converter="bean" match="com.example.Person"/>
那么关于dwr我也只介绍到这里了,这基本就是dwr的基本内容了,可以满足普通的项目需求了。
其中engine.js必须要,如果需要用到dwr提供的一些方便的工具要引用util.js ,然后是dwr自动生成的js文件,名字必须和dwr.xml中create标签的javascript属性值一样,且是dwr/interface开头的目录
实例:
1.web.xml文件:
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0"
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">
<display-name></display-name>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<!-- 配置dwr环境 -->
<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>
</web-app>
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.dx.dwr.Test"></param>
<include method="testFun"/>
</create>
</allow>
</dwr>
Test.java
package com.dx.dwr;
public class Test {
public String testFun(String name){
System.out.println(name);
String str = "hello "+name;
return str;
}
}
index.jsp
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>My JSP 'index.jsp' starting page</title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
<meta http-equiv="description" content="This is my page">
<script type="text/javascript" src="dwr/engine.js"></script>
<script type="text/javascript" src="dwr/util.js"></script>
<script type="text/javascript" src="dwr/interface/Test.js"></script>
<script>
function testFun(){
var name="aaa";
Test.testFun(name,returnFun);//调用java方法,returnFun回调函数
}
function returnFun(data){
alert(data);
}
testFun();
</script>
</head>
<body>
</body>
</html>