DWR组件——基于远程过程调用实现Ajax

Posted 2020-09-09

转载请注明原文地址：http://www.cnblogs.com/ygj0930/p/6686115.html 

一：DWR的用途

    DWR(Direct Web Remoting)是一个Web远程调用框架，会根据java类动态生成javascript代码。

 

二：DWR实现Ajax的原理

    DWR是基于远程过程调用的组件，可以在浏览器端远程调用服务端的业务函数，并获取返回结果。而我们知道，浏览器端是不能直接运行Java代码的，但是可以运行JavaScript代码。DWR的作用就是：把服务端的业务函数转化成JS函数，然后在页面导入js文件，像使用普通JS函数一样调用。而页面在触发该函数时，就向服务端发出请求，服务器根据转换映射关系调用相应业务函数，并把结果返回个页面端的JS函数调用处。这样没有引发页面跳转，所以也是Ajax。

 

三：DWR使用步骤

（1）引入dwr.jar（核心包）、commons-logging-1.0.4.jar（依赖包）；

（2）在web.xml中配置DWR组件，DWR相当于是一个servlet；

 

    <servlet>
        <servlet-name>dwr</servlet-name>
        <servlet-class>
            org.directwebremoting.servlet.DwrServlet
        </servlet-class> 
    </servlet>    
    <servlet-mapping>
        <servlet-name>dwr</servlet-name>
        <url-pattern>/dwr/*</url-pattern>
   </servlet-mapping>

 

（3）定义异步处理函数类AjaxService，在其中定义一系列函数进行业务处理并返回结果；

（4）在与web.xml同目录下创建dwr.xml，配置AjaxService类的哪些方法、哪个DTO通过DWR“转换”成JS函数、JS对象给前端使用；

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN" "http://getahead.org/dwr/dwr20.dtd">
<dwr>
    <allow>
        <filter class="org.directwebremoting.filter.AuditLogAjaxFilter" />
        
        <!-- AjaxService类的转换 -->
        <create creator="new" javascript="_AjaxService_js">//转换得到的JS对象名，供前端调用方法时使用
            <param name="class" value="demo.AjaxService" />
            <include method="ajax1"/>//把哪些函数进行转换
            <include method="ajax2"/>
            <include method="ajax3"/>
        </create>
        
        <!-- 实体类的转换：把一个DTO转换成JS对象供前端使用 -->
        <convert converter="bean" match="model.AjaxDTO">
            <param name="include" value="username,name" />//把DTO的哪些属性提取出来转换成一个JS对象
        </convert>         
    </allow>
</dwr>

<create>标签中指定javascript中可以访问的java类，并定义DWR应当如何获得要进行远程的类的实例。

creator="new"属性指定java类实例的生成方式，new意味着DWR应当调用类的默认构造函数来获得实例。

javascript=""属性指定javascript代码进行函数调用时使用的对象名称。
<param>标签指定要公开给javascript的java类名。
<include>标签指定要公开给javascript的方法。不指定的话就公开所有方法。

 

<convertor>标签负责配置方法的参数和返回类型。告诉DWR在服务器端Java 对象表示和序列化的JavaScript对象之间如何转换。

converter="bean"属性指定转换的方式采用JavaBean命名规范

match=""属性指定要转换的javabean相对路径下名称

<param>标签指定要转换的JavaBean的属性，可以不把所有属性都转换，自己定制。

（5）在前端页面代码中导入DWR的JS引擎以及上面dwr.xml中AjaxService转换得到的JS函数文件，就可在js中通过转换后的函数名直接调用方法了。

    <!-- 导入dwr的JS引擎与JS文件 -->
    <script type="text/javascript" src="dwr/interface/_AjaxService_js.js"></script>
    <script type="text/javascript" src="dwr/engine.js"></script>
    <script type="text/javascript" src="dwr/util.js"></script>
    

 

四：页面中调用转换后方法：传参与回调

1：传参调用：通过  转换后对象名.方法名(参数列表，回调函数名)   的格式进行函数调用

AjaxService_js.ajax（parameters,callback);

 

2：回调接收结果：定义回调函数，回调函数的形参接收上面函数调用的返回值

function callback(data){

//data就是函数调用返回值，进行处理。在JS中，函数的形参变量是根据实际值来决定类型的，所以这里的data可以接收返回的普通类型、JavaBean、集合类等                                  
        }