DWR搭建以及使用教程
DWR(DirectWebRemoting)是一个Ajax的开源框架,用于改善web页面与Java类交互的远程服务器端的交互体验,可以帮助开发人员开发包含AJAX技术的网站。它可以允许在浏览器里的代码使用运行在WEB服务器上的JAVA函数,就像它就在浏览器里一样。
从DWR官网下载最新版本的jar包,地址:
http://directwebremoting.org/dwr/downloads/index.html
将jar包放入WEB-INF的lib文件夹下。同时,dwr依赖于commons-logging.jar这个包,所以必须将这个jar包也放入到WEB-INF的lib文件夹相爱。
首先是配置dwr的环境:
1.web.xml文件:
查看源码
打印?
02 | < servlet-name >dwr-invoker</ servlet-name > |
03 | < servlet-class >uk.ltd.getahead.dwr.DWRServlet</ servlet-class > |
05 | < param-name >debug</ param-name > |
06 | < param-value >true</ param-value > |
11 | < servlet-name >dwr-invoker</ servlet-name > |
12 | < url-pattern >/dwr/*</ url-pattern > |
2.从官网的jar.war文件中利用winRAR等软件提取出dwr.xml文件,并将其放入到WEB-INF文件夹下。
dwr.xml是dwr的核心配置文件,主要的标签有:<converter>、<convert>、<create>这三个标签。
<converter>标签是dwr中内置的转换器。我们也可以使用自己写的转换器,不过dwr提供的转换器已经足够了,所以这个标签,一般不会自己去写。
<convert>标签是将converter中定义的转换器映射到的具体类型,如:
查看源码
打印?
1 | < converter id = "date" class = "org.directwebremoting.convert.DateConverter" /> <!--注册了date转换器--> |
2 | <!--注意:converter标签必须放到<init>标签内,而convert是放在<allow>标签内,这里只是示例,并不是完整的dwr.xml--> |
3 | < convert converter = "date" match = "java.util.Date" /> <!--将注册的date转换器应用到java.util.Date类型 |
<create>标签是dwr中重要的标签,用来描述java(服务器端)与javascript(客户端)的交互方式。其基本格式如下:
查看源码
打印?
2 | < create creator = "..." javascript = "..." scope = "..." > |
3 | < param name = "..." value = "..." /> |
4 | < auth method = "..." role = "..." /> |
其中,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:使用EJB3sessionbean(v2.0+)
关于这几个属性如何使用,这里就不在详细阐述了。我只列出一个与spring整合的例子:
查看源码
打印?
01 | < create creator = "spring" javascript = "backUpDocumentService" > |
02 | < param name = "beanName" value = "testDWR1" /> |
03 | < include method = "modifyBackUpFiles" ></ include > |
04 | < include method = "isSafeCodeRight" ></ include > |
07 | <!--加include可以具体指定java类中关的方法,不加则默认类中全部为public的方法--> |
08 | < create creator = "spring" javascript = "testDWR2" > |
09 | < param name = "beanName" value = "testDWR2" /> |
spring配置文件
查看源码
打印?
1 | < bean id = "testDWR1" class = "com.test.testDWR1" ></ bean > |
2 | < bean id = "testDWR2" class = "com.test.testDWR2" ></ bean > |
3.页面配置
在jsp页面添加三个js文件,分别是
查看源码
打印?
1 | < script type = 'text/javascript' src = 'js/util.js' ></ script > |
2 | < script type = 'text/javascript' src = 'js/engine.js' ></ script > |
3 | < script type = 'text/javascript' src = 'dwr/interface/testDWR1.js' > |
其中engine.js必须要,如果需要用到dwr提供的一些方便的工具要引用util.js,然后是dwr自动生成的js文件,名字必须和dwr.xml中create标签的javascript属性值一样,且是dwr/interface开头的目录
4.接下来就可以分别写javascript和java代码了。
javascript代码:
查看源码
打印?
3 | testDWR1.testFun(name,returnFun); //调用java方法,第二个参数是回调函数 |
4 | } function returnFun(data){ //data对应着java方法的返回值 |
java代码:
查看源码
打印?
4 | public Stringtest(Stringstr){ |
5.其他
dwr可以设置是否采用异步方式访问java代码,其代码为:
查看源码
打印?
1 | dwr.engine.setAsync( false ); //false为同步,true(默认)为异步 |
以及dwr对于异常的处理,这里我只列出个简单的全局性异常捕获,具体到针对某个方法的异常捕获,大家可以自己上网找找。
查看源码
打印?
1 | dwr.engine.setErrorHandler(errh); |
2 | function errh(errorString,exception){ |
dwr同样支持参数为对象的方法,这需要在dwr.xml中配置下<convert>标签:
查看源码
打印?
1 | < convert converter = "bean" match = "com.example.Person" /> |