Web框架——DWR中signatures标签的使用

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>