Scripting Introduction

主要功能如下：
1、$() 获得页面参数值
2、addOptions and removeAllOptions 初始化下拉框
3、addRows and removeAllRows 填充表格
4、getText  取得text属性值
5、getValue 取得form表单值
6、getValues 取得form多个值
7、onReturn
8、selectRange
9、setValue
10、setValues
11、toDescriptiveString
12、useLoadingMessage
13、Submission box

1。$();
功能 : 相当于 document.getElementById(id);
参数 : id 或 name 属性值 ;
例 :
<script>
         Var ele=$(txt_test);
         Var str=DWRUtil.toDescriptiveString(ele,1)
         DWRUtil.debug(str);
</script>

2。DWRUtil.getValue();
功能 : 获得指定元素 value 值
参数 : id 或 name 属性值 ;
注意 : 该函数只能用于有 value 属性的元素
例 :
<script>
         var val=DWRUtil.getValue(“txt_test”);
         DWRUtil.debug(val);
</script>

3。 DWRUtil.getValues();
功能 : 获得一组指定元素的 value 值 ;
参数 :id 或 name 构成的数组对象
例 :
<script>
         Var arr_=DWRUtil.getValues({“txt_name”:null,”txt_pswd”:null});
         Var str=DWRUtil.toDescriptiveString(arr,1)
         DWRUtil.debug(str);
</script>

4。DWRUtil.setValue();
功能 : 设置指定元素的 value 值
参数 : id 或 name 属性值
例 :
<script>
         DWRUtil.setValue(“txt_test”,”wiley”);
</script>

5。 DWRUtil.setValues();
功能 : 设置一组指定元素的值
参数 : id 或 name 构成的数组对象
例 :
<script>
         DWRUtil.setValues({“txt_name”:”wiley”,”txt_pswd”:”wiley”});
</script>

6。 DWRUtil.getText();
功能 : 获得 select 元素的文本值
参数 : id 或 name 属性值
例 :
<script>
         Var txt=DWRUtil.getText (“sel_test”);
         Var val=DWRUtil.getValue(“sel_test”);
         DWRUtil.debug(“Text:”+txt+”\tValue:”+val);
</script>

7。DWRUtil.addRows();
功能 : 指定表格添加行
格式 :DWRUtil.addRows(id,items, functions);
参数 :
第一个参数 :table 或 tbody 的 id 属性值
第二个参数 : 数组或链表 ( 可能用词不是很适合 )
第三个参数 : 函数链表
例:
<script>
         Var arr_={“wiley’s blog”,”wiley 中国 ”};
         DWRUtil.addRows(“tby_test”,arr_,[function(arr_){return arr_}]);
</script>

<script>
         Var items=[{“name”:”wiley 中国 ”,”add”:”wiley-cn.com”}];
         DWRUtil.addRows(“tby_test”,items,[function(item){return item.name}, function(item){return item.add}]);
</script>

8。DWRUtil.romoveAllRows();
功能 : 删除指定表格行
参数 :table 或 tbody 的 id 属性值
<script>
         DWRUtil.romoveAllRows(“tby_test”);// 每次添加前将原有数据行删除 , 防止数据重叠
         Var items=[{“name”:”wiley 中国 ”,”add”:”wiley-cn.com”}];
         DWRUtil.addRows(“tby_test”,items,[function(item){return item.name}, function(item){return item.add}]);
</script>

9。DWRUtil.addOptions();
功能 : 添加 select 元素的 option 子元素
格式 :DWRUtil.addOption(id,items) 或 DWRUtil.addOption(id,items,valueProp,textProp);
参数 :
第一个参数 :select 的 id 或 name 属性值
第二个参数 : 数组或链表 ( 填充数据 )
第三、四个参数 : 链表节点的属性 , 第三个填充 value 值，第四个填充 text 值
    <script>
         Var arr_={“wiley”,”wiley 中国 ”};
         DWRUtil.addRows(“sel_test”,arr_);// 此时 value 与 text 值相同
         DWRUtil.romoveAllOptions(“sel_test”);
         Var items=[{“name”:”wiley 中国 ”,”add”:”wiley-cn.com”}];
         DWRUtil.addRows(“sel_test”,”add”,”name”);// 此时 value 与 text 不相同
</script>

10。DWRUtil.romoveAllOptions();
功能 : 删除指定 select 元素的 option 子元素
参数 :select 元素的 id 或 name 属性值
例 : 前面例子有用到

11。DWRUtil.debug();
功能 : 等价于 alert()
例 : 前面例子有用到

12。DWRUtil.toDescriptiveString();
功能：将对象序列化成字符串 , 主要用于调试
带debug信息的toString，第一个为将要debug的对象，第二个参数为处理等级。等级如下：

     0: Single line of debug 单行调试 
     1: Multi-line debug that does not dig into child objects 不分析子元素的多行调试 
     2: Multi-line debug that digs into the 2nd layer of child objects 最多分析到第二层子元素的多行调试

     <input type="text" id="text">
     DWRUtil.toDescrīptiveString("text",0);

13。DWRUtil.useLoadingMessage();
    功能：当发出ajax请求后,页面显示的提示等待信息;
    例：
    function searchUser(){
        var loadinfo = "loading....."
        regUser.queryAllUser(userList);
        DWRUtil.useLoadingMessage(loadinfo); 
     }

<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>
    <servlet-name> dwr-invoke </servlet-name>
    <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页面中加入

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

通过在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:

遍历方法2:

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

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

如果知道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当作数组来处理
AAA.bbb(stu,callBack);

并且在dwr.xml中增加如下的配置段(刚才试验了下，不加也可以)

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

例参数是javabean的Map,key是String,value是javabean,如下:

并且在dwr.xml中增加如下的配置段(刚才试验了下，不加也可以)