今天学习了一下DWR(Direct Web Remoting),是Ajax一个开源框架,封装了Ajax一些底层用法,如XMLHttpRequest对象的创建,请求的发送以及响应。简单的说,DWR 是一个引擎,能够在javascript直接调用java类和方法。
现在来写个简单的入门的示例:
首先,需要下载dwr.jar(我下的是dwr2.0)和commons-logging.jar
新建一个web project,将dwr.jar和commons-logging.jar放入WEB-INF/lib下
接下来就是配置dwr了,那么如何配置呢?
1.修改web.xml,添加dwr映射配置
<servlet> <servlet-name>dwr-invoker</servlet-name> <servlet-class>uk.ltd.getahead.dwr.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>
添加debug参数,DWR默认这个参数值为false,如果选择true,我们可以通过http://${ip}:${port}/${app}/dwr看到你部署的每个DWR Class.并且可以测试java代码的每个方法是否运行正常。为了安全考虑,在正式环境下你一定把这个参数设为false。
2.添加一个dwr.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN" "http://www.getahead.ltd.uk/dwr/dwr20.dtd"> <dwr> <allow> <create creator="new" javascript="sayHelloTo" > <param name="class" value= "com.me.dwr.HelloWorld" /> <include method="sayHello"/> </create> </allow> </dwr>
配置说明:
<allow> 标签中包括可以暴露给 javascript 访问的东西。
<create> 标签中指定 javascript 中可以访问的 java 类,并定义 DWR远程调用类的实例。 creator="new" 属性指定 java 类实例的生成方式, new 意味着 DWR 应当调用类的默认构造函数来获得实例,其他的还有 spring 方式,通过与 IOC 容器 Spring 进行集成来获得实例等等。 javascript=" sayHelloTo" 属性指定 javascript代码访问对象时使用的名称。
<param> 标签指定要公开给 javascript 的 java 类名。
<include> 标签指定要公开给 javascript 的方法。不指定的话就公开所有方法。
<exclude> 标签指定要防止被访问的方法。
java类(定义了一个sayHello方法):
package com.me.dwr;
public class HelloWorld {
public String sayHello(String name){
return "hello,"+name;
}
}
DWR可以通过2中dwr.xml配置在javascript中调用HelloWorld中的sayHello方法。
在javascript中调用之前,我们先来测试一下,我们dwr配置以及方法是否正确,我们发布工程,启动tomcat,在地址栏中输入http://${ip}:${port}/${app}/dwr(参考1中注解)
如果你看到Dwr Test Index页面说明你配置成功了。
那么在javascript中如何dwr中配置的类和方法呢?
<%@ page language="java" pageEncoding="gbk"%>
<html>
<head>
<title>Dwr 调用测试</title>
<!--这里sayHelloTo.js 是通过dwr.xml中配置的create标签中javascript配置的值是一致的 -->
<script src='dwr/interface/sayHelloTo.js'></script>
<script src='dwr/engine.js'></script>
<script src='dwr/util.js'></script>
<script type="text/javascript">
function btn_onClick(){
var username = document.myform.name.value;
//调用dwr.xml中配置的类方法,回调函数callback带有返回的结果集
sayHelloTo.sayHello(username,callback);
}
function callback(data){
document.getElementById("info").innerText=data;
}
</script>
</head>
<body>
<form name="myform" method="post">
<input type="text" id="name" name="name"/>
<input type="button" value="sayHello" οnclick="btn_onClick()"/>
<div id="info"></div>
</form>
</body>
</html>
我在下面附件中给大家提供了dwr2.0.jar,commons-logging.jar。