也许朋友们会以为这是DWR官方发布的什么帮助,但非常遗憾这不是。现在不少朋友在使用DWR开发项目,我也是其中之一,但苦于关于DWR的帮助文档实在太少,很多问题都不得不自己去钻研DWR的源码才能解决或理解。经过一段时间的苦苦钻研,总结出那么一点点心得,现在从DWR源码实现的角度详细讲解DWR的使用,写出来与大家分享。今天我先讲一讲dwr.xml的配置。 一、为什么要配置dwr.xml
要理解dwr.xml的配置首先要理解DWR的基本功能。DWR其功能的强大在于它可以用一种前所未有的便利方式将前端页面中的js与后端服务器中的java程序进行直接的转换。比如,它可以将java程序中的某个XxxBus转换成js中的一个对象,并将XxxBus中的某个方法如getXXX()转换成js中的一个名为XxxBus.getXXX()的function。同时,它可以将java中的值对象或其它数据包转换成js中的对象。理解这一点非常重要。配置文件dwr.xml就是让你告诉DWR哪些Bus你需要在页面中调用,以及你需要调用这些Bus中的哪些方法,哪些方法你不需要调用。一旦告诉了DWR这些信息,你似乎就可以在页面中像写java程序一样的直接调用Bus,而跳过了MVC层(如struts中的action和actionform)以及MVC层的繁琐配置与编程。为了帮助你理解这一点我举一个例子,已经清楚的朋友可以跳过。
假如我在项目的BUS层写了一个类叫DepartmentBus并在这个类中定义了一个方法getDepartment(String id),那么我们先把这个类和它的方法配置到dwr.xml中(如何配置我后面再讲)。当DWR启动的时候,它会将java中的DepartmentBus及其方法getDepartment(String id)转换成js中的DepartmentBus及其方法getDepartment(String id)。更具体地说,它会动态产生一个叫DepartmentBus.js的文件(这个文件可以在测试状态下从“项目地址端口/dwr/test/DepartmentBus”中看到)。在这个文件中,会创建一个DepartmentBus的对象,一个叫DepartmentBus.fincDepartment(p0, callback)的函数。如果你在页面中引入了DepartmentBus.js文件,你就可以在该页面的 中调用DepartmentBus.fincDepartment(p0, callback)方法,DWR就可以通过Ajax的方式直接去调用服务器端的DepartmentBus中的fincDepartment(String id)。同理,如果DepartmentBus中还有其它的函数,如createDepartment(Department vo)、updateDepartment(Department vo)等,DWR也会做如此的转换。
前面我们提到,DWR可以将服务器端java中的对象及其方法转换成客户端的js中的对象及其方法,一个棘手的问题就出现了。在java中的许多方法都是将某个对象作为它参数或返回值。这些对象往往都是一个个的JOPO,即它们有许多的属性,其中包含了需要传递的数据(最典型的就是值对象)。当js在调用java的某个方法时需要提供这个对象参数,同时在调用完成时需要将对象返回值以js可以接受的方式返回。怎样做到这一点呢?最简单的方式当然是让DWR再做一次转换,将这些java对象转换成js的对象,或者将js的对象转换成java对象。Ok,经过DWR这样的两次转换,我们就可以在页面与后台间自由地进行函数调用和数据交换。
二、如何配置dwr.xml文件
讲到这里,我们现在重新回到dwr.xml文件。前面我们提到,如果你需要在页面中调用服务器端的某个类中的方法,你需要在dwr.xml中注册这个类及其方法,注册方法如下:
- <create creator="spring" javascript="DepartmentBus" scope="script">
- <param name="beanName" value="departmentBus"/>
- 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中加入: - <exclude method="createDepartment"/>
method部分写的是这些方法不带括号的方法名,如果有多个就写多行exclude;include则规定页面只能调用某些方法。
在dwr.xml中注册了需要调用的对象及其方法以后,你应当注册其所有方法的参数和返回值所涉及的对象,注册方法如下:
xml 代码
- <convert match="com.htxx.demo.datasource1.model.Department"
- 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 代码
- <convert match="com.htxx.demo.model.Address" javascript="Address" converter="hibernate3">
- <param name="exclude" value="employee"/>
- </convert>
Value部分是需要转换的属性,如果有多个则用逗号隔开就可以了。(一个dwr+spring+hibernate的示例)
分享到:
相关推荐
`dwr.xml`是DWR的核心配置文件,用于定义哪些Java类和方法可以被前端JavaScript访问,以及如何进行转换。 在DWR的工作机制中,`dwr.xml`配置文件起到了关键的作用。通过配置,你可以指定哪些服务器端的Java类(例如...
**DWR2.0.dtd** 是DWR2.0的文档类型定义(DTD),它定义了DWR.xml文件的结构和元素。DTD用于验证XML文件是否符合特定的语法规则,确保配置文件的正确性。当编辑DWR.xml时,DTD可以帮助开发者遵循正确的格式和属性,...
此外,开发者也需要在Web应用的配置文件(如web.xml)中添加相应的DWR配置,以启用和定制DWR的行为。 DWR的工作流程主要包括三个主要部分: 1. **配置**:在服务器端,你需要在web.xml中配置DWR的Servlet,定义允许...
dwr.xml文件是DWR框架的核心配置文件之一,通过上述分析可以看出,它主要包含了DWR Servlet的配置信息,如Servlet的名称、类名、初始化参数以及映射的URL路径等。这些配置对于DWR框架正常运行至关重要,通过合理的...
4. **配置文件**:DWR的配置主要在`dwr.xml`文件中进行,这里可以定义允许的远程方法、映射路径、安全策略等。 5. **自动生成的JavaScript**:DWR能够根据服务器端的Java接口自动生成对应的JavaScript接口,使得...
"DWR.xml配置文件说明书.doc"是关于DWR核心配置文件的详细指南。DWR.xml文件是DWR框架的核心配置,它定义了哪些服务器端的Java对象可以被JavaScript访问,以及这些对象的映射、安全设置和其他配置选项。通过配置这个...
DWR的配置主要涉及两个文件:`web.xml`和`dwr.xml`。 - **web.xml**:这是Web应用的部署描述符,用于配置DWR的初始化参数,如安全设置、日志级别、插件启用等。例如,可以通过设置`dwr.debugMode`参数开启调试模式...
### DWR.xml配置文件详解 #### 一、DWR配置文件结构与作用 DWR(Direct Web Remoting)是一个开源的Ajax框架,它允许在浏览器端JavaScript代码直接调用服务器端Java方法,从而简化了传统的AJAX编程。DWR.xml是DWR...
标题 "dwr2.0.2.jar + bsf-2.3.jar+xml-apis.jar" 暗示了这是一个关于Web应用程序开发中的某些组件的集合,主要涉及Direct Web Remoting (DWR) 和 Java脚本引擎接口。描述与标题相同,进一步确认了这可能是一个包含...
### DWR入门指南 #### 一、DWR简介 DWR (Direct Web Remoting) 是一个简化Ajax开发的Java框架,它使得JavaScript可以像调用...此外,DWR还提供了丰富的文档和支持社区,帮助开发者更好地理解和利用这一强大的框架。
`dwr.xml`文件是DWR的核心配置文件,用于指定哪些Java类可以被远程访问以及如何访问这些类。示例如下: ```xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE dwr PUBLIC "-//GetAhead Limited//DTD ...
### DWR.xml配置文件详解 #### 一、概述 DWR (Direct Web Remoting) 是一个简化Ajax开发的Java框架,它允许JavaScript直接调用服务器端的Java方法,从而简化了客户端与服务器之间的交互过程。在DWR中,配置文件dwr...
Maven依赖:【***.jar Maven依赖信息(可用于项目pom.xml).txt】 Gradle依赖:【***.jar Gradle依赖信息(可用于项目build.gradle).txt】 源代码下载地址:【***-sources.jar下载地址(官方地址+国内镜像地址).txt】...
通过分析这个war文件,开发者可以学习如何配置DWR的XML配置文件(dwr.xml),以及如何创建可从JavaScript调用的Java方法。 3. **DWR2.0中文说明文档**: 这份文档对于理解DWR的工作原理和使用方法至关重要,特别是...
- **配置文件**:DWR的配置文件(dwr.xml)用于定义哪些Java类和方法可以被远程调用。 - **JavaScript API**:DWR提供了一系列JavaScript库,如`dwr.engine`,用于与服务器进行交互。 4. **DWR的应用场景** - ...
为了正确配置DWR,你需要将这些jar文件添加到项目的类路径中,并根据DWR的官方文档配置web.xml文件,以启动DWR引擎和服务。 总的来说,DWR通过提供一种简单的方式,让Web开发者可以更便捷地在浏览器和服务器之间...
2. **配置DWR**:在Web应用的Web-INF目录下创建dwr.xml配置文件,设置允许的远程接口和方法,以及其他配置项。 3. **创建远程接口**:在服务器端定义一个公共的Java接口或类,包含你想在客户端调用的方法。 4. **...
DWR的核心在于XML配置文件,即`dwr.xml`,它是DWR与应用服务器交互的桥梁,定义了哪些Java对象可以被JavaScript访问,以及如何处理这些调用。对于学习Ajax的用户来说,理解并掌握`dwr.xml`的配置至关重要,因为它...