如何配置dwr.xml文件

 

讲到这里，我们现在重新回到dwr.xml文件。前面我们提到，如果你需要在页面中调用服务器端的某个类中的方法，你需要在dwr.xml中注册这个类及其方法，注册方法如下：

1. <create creator="spring" javascript="DepartmentBus" scope="script">  
2.       <param name="beanName" value="departmentBus"/>  
3. create>  

Creator是创建这个对象所使用的构建器，如果你希望使用传统的new方法就写成new，如果你希望使用spring来创建则写成spring。当然也有其它的创建方法，有哪些方法呢？你可以打开dwr.jar，在org.directwebremoting包中找到一个dwr.xml的文件。在该文件init下的create中可以看到。

Javascript是用于你在js中调用这个对象时使用什么名称，强烈建议你使用首字母大写，这样在页面中很容易看出这是一个与后台对应的对象。

如果你使用了spring并且在creator中选择了spring，那么你需要一个叫beanName的参数，而其值就是在spring配置文件中配置的beanName，如departmentBus。

另外2个非常有用的参数是exclude和include，exclude可以禁止页面调用后台的某个或某些方法，具体的写法是在create中加入：

1. <exclude method="createDepartment"/>  

method部分写的是这些方法不带括号的方法名，如果有多个就写多行exclude；include则规定页面只能调用某些方法。

在dwr.xml中注册了需要调用的对象及其方法以后，你应当注册其所有方法的参数和返回值所涉及的对象，注册方法如下：

xml 代码

1. <convert match="com.htxx.demo.datasource1.model.Department"   
2. javascript="Department" converter="hibernate3"/>  

match用于告诉DWR你将需要把java中的哪些类转换成js。你可以写成com.htxx.demo.model.*，但我并不推荐大家这样使用。为什么呢？如果你像前面那样一个一个地注册对象，则就可以在页面使用这个的语句初始化一个对象：

var dep = new Department();

如果你使用后一种方法去批量注册对象，那么你就不能这样初始化这个对象而只能这样手动注册：

Var dep = {departmentId:null, departmentName:null, ……};

我推荐大家采用第一种方法的好处可以在我后面写的《DWR帮助说明－如何编写通用的单行编辑框》充分展现出来。但采用这种方法在DWR的现有版本中似乎还有点儿BUG，如何解决这个BUG我也将在后面的《DWR帮助说明－dwr的bug及其解决方法》中解答。

Javascript用于说明你在页面中使用这个对象的名称，也强烈建议大家使用首字母大写。

Converter用于告诉DWR用什么DWR的类来执行转换，常用的转换器有bean、object、hibernate2、hibernate3等。DWR有哪些转换器可以在dwr.jar的dwr.xml（该文件的位置见前文）中找到。我需要强调的是，如果朋友们使用了hibernate，那么你需要将需要使用的所有值对象都通过转换器注册。但是我在网上看见很多朋友都使用bean转换器来注册。如果你使用bean来转换值对象，在运行程序的时候会出现很多问题（这些问题我就不详述了），同时还会出现效率的问题，因为DWR会将该值对象的所有属性，及其这些属性的所有属性，所有属性的属性，都以穷举的方式取出来。熟悉hibernate的朋友应当马上明白这样将是数据库操作的一个灾难。如果你使用hibernate2或hibernate3作为转换器将不会发生这样的事，同时，hibernate3还较好地解决了延迟查询的问题，但DWR官方建议我们使用hibernate的openSessionInViewFilter，这我也不再详述，不清楚的朋友可以查阅hibernate3的帮助文档。但另一个问题我不得不提，DWR在使用延迟查询的时候其实还是有问题的。譬如有一个值对象Employee包含一个Department的属性，根据延迟查询的规则，在get某个Employee时，属性Department不会马上装载，即使执行getDepartment()也不会装载。必须到真正对这个Department操作的时候才会装载。既然如此，问题就来了，我们使用DWR执行查询的时候，常常是真正到页面才会读取Department，这时已经是脱离服务器端到页面端了而不能再得到Department。这个问题怎么办呢，最好的办法是在服务器端就提前装载页面需要使用的属性，因为作为开发者他肯定知道哪些属性要在客户端使用，哪些属性不需要。至于如何在服务器端就提前装载，感兴趣的朋友在我的示例中看到。

另外一个需要提的是，与creator一样，转换器也可以一样地设置exclude和include参数。但是与creator不同的是，它们说明DWR在转换对象的时候需要转换或不转换某些属性。这个参数对于hibernate的一对一关联非常重要。在hibernate中一对一关联是不做延迟查询的，假如有一个值对象Employee与值对象Address是一对一关联，那么Employee中有Address的属性，而Address中有Employee的属性。由于一对一关联不做延迟查询，当DWR在转换一个Employee是会装载它的属性Address，然后在装载Address的时候，又会去装载Address中的Employee属性。如此这样，就会形成一个死循环，最后以堆栈溢出告终。解决这个问题的办法就是禁掉Address中的Employee属性，避免产生死循环。具体写法如下：

xml 代码

1. <convert match="com.htxx.demo.model.Address" javascript="Address" converter="hibernate3">  
2.     <param name="exclude" value="employee"/>  
3. </convert>  

Value部分是需要转换的属性，如果有多个则用逗号隔开就可以了。