signatures段使DWR能确定集合中存放的数据类型。例如下面的定义中我们无法知道list中存放的是什么类型。
public class Check{
public void setLotteryResults(List nos){
...
}
}
signatures段允许我们暗示DWR应该用什么类型去处理。格式对以了解JDK5的泛型的人来说很容易理解。
<signatures> <![CDATA[ import java.util.List; import com.example.Check; Check.setLotteryResults(List<Integer> nos); ]]> </signatures>
DWR中又一个解析器专门来做这件事,所以即便你的环境时JDK1.3 DWR也能正常工作。
解析规则基本上会和你预想规则的一样(有两个例外),所以java.lang下面的类型会被默认import。
第一个是DWR1.0中解析器的bug,某些环境下不能返回正确类型。所以你也不用管它了。
第二个是这个解析器时"阳光(sunny day)"解析器。就是说它非常宽松,不想编译器那样严格的保证你一定正确。所以有时它也会允许你丢失import:
<signatures> <![CDATA[ import java.util.List; Check.setLotteryResults(List<Integer>); ]]> </signatures>
将来的DWR版本会使用一个更正式的解析器,这个编译器会基于官方Java定义,所以你最好不要使用太多这个不严格的东西。
signatures段只是用来确定泛型参数中的类型参数。DWR会自己使用反射机制或者运行时类型确定类型,或者假设它是一个String类型。所以:
//不需要signatures - 没有泛型参数:
public void method(String p);
public void method(String[] p);
//需要signatures - DWR不能通过反射确定:
public void method(List<Date> p);
public void method(Map<String, WibbleBean> p);
//不需要signatures - DWR能正确的猜出:
public void method(List<String> p);
public void method(Map<String, String> p);
//不需要signatures - DWR可以通过运行时类型确定:
public List<Date> method(String p);
没有必要让Javascript中的所有对象的key都是String类型 - 你可以使用其他类型作为key。但是他们在使用之前会被转换成String类型。DWR1.x用Javascript的特性把key转换成String。DWR2.0可能会用toString()方法,在服务段进行这一转换。
注:结合Spring的注入方法使用时,不需要另外导入类,可直接使用配置的名字
如下的TestDWR:
<dwr> <allow> <create javascript="TestDWR" creator="spring"> <param name="beanName" value="testDWR"></param> </create> <convert converter="bean" match="com.TestBean" /> <convert converter="bean" match="com.TestBean1" /> </allow> <signatures> <![CDATA[ import java.util.List; import com.TestBean; import com.TestBean1; TestDWR.doMethod(List<TestBean>, List<TestBean1>); ]]> </signatures> </dwr>