dwr.xml配置样例和详细说明

Dwr.xml模板:

<?xml version="1.0" encoding="UTF-8"?><!-- 说明这是一个xml文档，1.0版本，文档采用UTF-8的编码格式 -->

<!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD Direct Web Remoting 2.0//EN" "http://getahead.ltd.uk/dwr/dwr20.dtd">

<!-- 说明这个xml文档要遵循的格式是dwr配置文件的格式，格式要求要符合"http://getahead.ltd.uk/dwr/dwr20.dtd"的格式 -->

<dwr><!-- dwr标签内的内容将被dwr解析，而且dwr内的格式要严格遵循dwr的格式要求 -->

  <allow>  

   <!-- allow内，放置dwr要转化成js的class，以及每个class要用到的javabean 

   allow内主要的标签式：

        create :用于将后台class变成前台的js方法

        convert :用于转换后台class方法用到的javabean对象。

   -->  

    <create creator="spring" javascript="LabelManageAction" scope="application">

       <param name="beanName" value="labelManageAction" />

    </create>

    <!-- create标签的作用和用法：

       作用：用于将后台class变成前台的js方法

       creator:指定采取哪种创建方式，主流的要两个：new 和 spring，new的方式是每次都通过new一个实例化对象，然后返回该实例，spring是采用spring的管理放置创建对象

       javascript：指定在前台调用的名称。根据经验，最好和后台的class是同名，便于使用开发工具快速查找。必填。

       scope:js方法的作用域。包括：page,request,session.application四个作用域。scope是可选属性，默认是page。

       creator标签的子标签param：该标签式用来定义creator标签的部分参数的。

       param标签的name属性：指定参数名称，通常情况下，如果创造器采用new,那么param的name属性通常是class，表示参数calss需要指定值，value属性指定哪个后台class

           如果采用spring的构造器，那么param的name属性通常是beanName，value属性指定是哪个spring的bean。

       createor标签的include子标签和exclude子标签：

           <include method="funName1,funName2,funName3"/> 显示定义前台可以访问的方法只有funName1,funName2和funName3三个方法，其他的方法在前台将访问不到。

           </exclude method="funName1,funName2,funName3"> 显示定义前台不可以访问的方法有funName1,funName2和funName3三个方法，其他的方法在前台可以访问到。

           默认情况下可以访问所有的后台方法。

     -->

    <convert converter="bean" match="org.jasig.cas.bean.CasUser"/>

    <!-- convert转换器的作用和使用方法：

    作用：将自定义的javabean对象映射成dwr可以解析的对象，(基本数据类型例如String，Integer等等dwr已经自己映射)

    convert的converter属性和match属性都比较固定：converter="bean" match="your.full.package.beanName"

    我们经常用到的就是bean转换器。该转换器可以将后台的标准的带有getter和setter方法的javabean对象转换成js对象

       然后用match属性指定匹配对象，指向后台javabean。

       简写：<convert converter="bean" match="your.full.package.*"> 这样将转换包内所有的javabean。      

     -->

  </allow>

  <signatures>

    <![CDATA[ 

    import java.util.*;

    import javax.servlet.http.HttpServletRequest;

    

    ]]>

</signatures>

    <!-- signatures 标签是用来让dwr明确集合中存放的数据类型的。

    例如：demo.class有一个test(List<User> list)方法，为让dwr明确test方法的List参数中存放的是什么类型的对象，

    我们会用到signatures标签。用法：

    <signatures>

    <![CDATA[ 

    import java.util.List;//或者 import java.util.*;

    import com.demo;//引入class

    import com.bean.User;//引入javabean

    demo.test(List<User> list);//指定泛型的存储的类型是User对象。

    ]]>

    </signatures>

    --!>

</dwr>