最近写ajax写烦了,想着能不能有个更简单的“ajax”,一问就问到这个dwr了。赶紧去官网学习了下,这里写个博客记录一下实例。
测试环境:tomcat6.0
1、新建一个web项目(这里比较简单,我就不赘述了),我这里的是TestWeb。
2、安装dwr。
主要用到两个jar包。
一个是dwr.jar:这个是dwr的主要文件,可以去官网下载。
下载链接:http://directwebremoting.org/dwr/downloads/index.html。
另一个是commons-logging.jar,这个jar包比较常用,那个版本的都没问题。我这里用的是commons-logging-1.0.4.jar。
将commons-logging-1.0.4.jar和dwr.jar拷贝到TestWeb项目的/WEB-INF/lib目录下。
至此安装完毕。
3、将dwr用到的servlet配置到web.xml中。
DWR Servlet dwr-invoker org.directwebremoting.servlet.DwrServlet debug true dwr-invoker /dwr/*
也可以从http://directwebremoting.org/dwr/introduction/getting-started.html中拷贝。
4、添加dwr.xml。
在/WEB-INF新建dwr.xml,名称必须为dwr.xml不能随便取。内容为:
具体什么意思可以先不了解,也可以去官网上看或者下载附件进行了解。 官网链接: http://directwebremoting.org/dwr/introduction/getting-started.html。
我这里除了定义了一个系统自带的java.util.Date,还有一个自定义的com.wjl.test.Base64,其代码如下:
public class Base64 { // 加密 public static String encode(String str) { byte[] b = null; String s = null; try { b = str.getBytes("utf-8"); } catch (UnsupportedEncodingException e) { e.printStackTrace(); } if (b != null) { s = new BASE64Encoder().encode(b); //据RFC 822规定,每76个字符,还需要加上一个回车换行去掉换行符 s = s.replaceAll("[\\s*\t\n\r]", ""); } return s; } // 解密 public static String decode(String s) { byte[] b = null; String result = null; if (s != null) { BASE64Decoder decoder = new BASE64Decoder(); try { b = decoder.decodeBuffer(s); result = new String(b, "utf-8"); } catch (Exception e) { e.printStackTrace(); } } return result; } }
5、新建jsp页面进行调用。
a、在webRoot根目录下新建testDwrDemo.jsp,html代码为:
当前月份:
加密数据:
加密后:
以上代码定义了两个两个方法,分别用来测试第4步中的两个类。
b、在jsp页面引入JS文件:
这里有几个注意点:
第一点:所有的js文件必须以dwr开头,即便项目中并不存在dwr文件夹,也不存在以上的四个js。
第二点:engine.js必须要引用。utils.js可以不引用,只有当需要用到其中的方法时才引用。
第三点:后面两个js文件是自己添加的,这种自己添加的js必须带interface目录,也就是自定义js必须以dwr/interface目录开头。(系统的以dwr就OK了)
第四点:自定义JS文件的命名:dwr.xml中javascript属性定义的名称+.+js。我的dwr.xml中javascript属性一个为JDate一个Base64,所以两个js的名称为JDate.js和Base64.js。
c、使用js调用java类中的方法。
function getMonth(){ /* //JDate:与自定义的js文件名称相同,也与dwr.xml文件中定义的javascript属性值相同 JDate.getMonth(function(data){ alert("当前月份:"+(data+1)); document.getElementById("curMonth").innerHTML=(data+1); }); */ //也可以写成: JDate.getMonth(callback); } function callback(data){ alert("当前月份:"+(data+1)); document.getElementById("curMonth").innerHTML=data; } //该方法用来加密 function encode(){ var str = document.getElementById("encodeStr").value; var str2 = Base64.encode(str,function callback(returnData) { alert(returnData); document.getElementById("encodeResult").value=returnData; }); }
6、使用tomcat进行调试。
a、java类中的方法调试:
发布项目启动tomcat,在浏览器中输入:http://127.0.0.1:8080/TestWeb/dwr,然后回车。
浏览器中显示所有配置在dwr.xml中的类。点击某个类名,可以查看这个类中的方法。如我这里点击Base64,结果如图:
Base64.java中定义了这两个类,且都是公开的,所以在这里显示 了(至于怎么让它不显示,可以看最下边的PS)。
我在encode的括号中输入abc,点击右侧的"Execute"按钮,会自动给我显示加密后的结果,如图:
这个调试是不是很有用?
当然想关闭这种调试也很简单,将web.xml中关于dwr的配置中的debug参数值改成false即可,这样子访问http://127.0.0.1:8080/TestWeb/dwr/将会出现404错误,自然也就不能调试了。是不是很方便。
b、JS方法调试。
这个很简单,点击页面按钮看看结果对不对就知道啦。
PS:关于让指定的方法不显示,可以通过
如:
不指定的话就公开所有方法。
如:< exclude method="decode"/>,那么在JS中就不可以调用该方法decode。
include和exclude不能同时存在。
至于上面的例子各个标签的含义,附件中的帮助文档说的很清楚啦,这里就不赘述了。