DWR使用总结

这两天学了下DWR，现在总结一下。
DWR是方便使用AJAX连接JS和JAVA的的一个框架,把服务器端Java对象的方法公开给JavaScript代码。
如果是用dwr2.0的jar包，还需要同时导入 log4j.jar和commons-loggin.jar,勿忘!!
web.xml和dwr.xml放在WEB-INF下!
-----------------------------
配置web.xml:WEB工程启动的时候会在这个里面找到具体所用到的类的路径，由此进行加载

<servlet>
<servlet-name> dwr-invoke </servlet-name>
<servlet-class> uk.ltd.getahead.dwr.DWRServlet </servlet>
<init-param>//这个是调试用，如果正式发布请该为false，不过听说2.0就默认为true了
<param-name> debug </param-value>
<param-value> true </param-value>
</init-param>
<init-param>//这个是DWR2.0必须的,不然会报java.lang.IllegalArgumentException
<param-name> classes </param-value>
<param-value> java.lang.Object </param-value>
</servlet>

<servlet-mapping>
<url-pattern> /dwr/* </url-pattern>
</servlet-mapping>

-----------------------------
配置dwr.xml: dwr.xml的作用是让你告诉DWR哪些class中的哪些方法你需要暴露给前台使用，当DWR启动时候根据dwr.xml这个文件把java类中的方法转成js中可用的类中方法，使前台可以使用。

注:以下是不全按dwr2.0写的，如果用的是DWR2.0，那java里暴露类(蓝字显示)不能写在<create>属性里，应删除后写在<include method="" />前，<param name="class" value="***java里暴露的class,必须写完整路径***" />。


<dwr>
<allow>
<create creator="new" javascript="***js调用的class***" class="***java里暴露的class,必须写完整路径***">
<include method="***java暴露类里要公开的方法，如果不写默认全部公开***" />
</create>
</allow>
</dwr>

-----------------------------
在html或js页面中加入
<script src="<%=basePath %>dwr/interface/java里暴露的class"></script>//切记不能<script *** />这样写
<script src=" <%=basePath %> dwr/engine.js"></script> //Dwr的脚本驱动Js,以上两个必写
dwr/util.js"></script>//这是个工具包，可以不调用
<script type="text/javascript">
function doMethod()
{
//调用方法:若公开的类是AAA,公开的AAA里的方法是bbb([参数]);
AAA.bbb([参数],callBack);//回调函数callBack()
}
function callBack(data)//data是后台返回的值，名字自取，也可省略，因为JS允许
处理方法……;//如果callBack()没有写明返回值，可以通过argments[0]拿到
</script>


其实我们调用AAA.bbb([参数],callBack);就是做了以下这一步：
(下面红字是包装好的，不在前台，所以即使你没有创建html或者jsp来调用，也可以通过localhost:8080/工程名/dwr 来看到你暴露的java类进行测试)
function AAA() { };
AAA.bbb = function([参数],callback)
{
DWREngine._execute('/dwr/dwr','AAA','bbb',[参数],callback);
}

通过在dwr.xml暴露的方法得到js里的方法，当我们调用AAA.bbb时候再通过/dwr/dwr转到DWRServlet中去用JAVA里的AAA.bbb方法，然后返回值到callback中(中间经过dwr.xml的convert)


----------------------------
上面对dwr的工作大致分析了下，现在对于参数类型的不同，对dwr.xml也要进行修正。

DWR自动地在Java和JavaScript表示之间调整简单数据类型,这些类型包括Java原生类型和它们各自的封装类表示，还有String、Date、数组和集合类型。但如果参数类型非简单数据类型，则要通过转换。

调用返回JavaBean的java 方法

在dwr.xml的<allow>标签中加入

<convert converter="bean" match="***一般来说是javabean***"> //int,String,list等不需要显式的转换就可以被js拿到
<param name="include" value="***javabean中的属性，用','隔开***" />//这句可以不写
</convert>

<creator>标签负责公开用于Web远程的类和类的方法，<convertor>标签则负责这些方法的参数和返回类型。 convert元素的作用是告诉DWR在服务器端Java 对象表示和序列化的JavaScript之间如何转换数据类型。

这样在js端回调函数直接拿到的data就是一个javabean,可以直接通过data.xxx拿到bean的属性xxx。

调用有JavaBean参数的java 方法

dwr.xml配置同上。

在JS端，把要传入的参数写成javabean方式，例：要传入一个名为student的javabean,参数有name,password,则
var stu = {name:"zhangsan",password:"zspassword"};//这是json的表示方法
AAA.bbb(stu,callBack);

调用返回List、Set或者Map的java方法

dwr.xml配置同上。如果Collection里的数据是简单数据类型，则可不需要写<convert>

在JS端，以 List，里面数据是bean为例，data是一个List型，只要用for循环就可以依次拿到数据。
遍历方法1:
for(var i=0;i<data.length;i++)
/*对于java方法的返回值为List(Set)的情况，DWR将其转 化为Object数组，传递个javascript*/
{
alert(data[i].name+":"+data[i].password);
}

遍历方法2:
for(var property in data)//property为序号,从0开始
{
var bean = data[ ];
alert(bean.name+":"+bean.password);
}

相比返回为javabean多了一个遍历而已。

如果java方法的返回值为 Map,则如下

for(var property in data)//property为key值
/*对于 java方法的返回值为Map的情况，DWR将其转化为一个Object，
其中Object的属性为原Map的key值，属性值为原Map相应的 value值*/
var bean = data[property];
alert(bean.username);
alert(bean.password);
如果知道key值，则可直接用:data.key拿到value

调用有List、Set或者Map参数的java方法

在dwr.xml的<dwr>标签内加入:<signatures>标签。

<signatures>标签是用来声明java方法中List、Set或者Map参数所包含的确切类，以便java代码作出判断，是js-->java的。

例参数是javabean的List,则只要在参数为javabean的例子里构造时候加上[]即可，如下：

var stu = [{name:"zhangsan",password:"zspassword"},{name:"lisi",password:"lspassword"}];
//把List当作数组来处理
(刚才试验了下，不加也可以)

<signatures>
<![CDATA[
import java.util.List;
import com.dwr.AAA; //AAA的包路径要写完整
import com.dwr.TestBean; //javabean
AAA.bbb(List<TestBean>);
]]>
</signatures>

Map, key是String,value是javabean, 如下:
var stu =

{
"key1":{name:"zhangsan",
"key2":{name:"lisi",password:"lspassword"}
};

Map<String,TestBean>); ]]> </signatures>