Dwr入门操作手册
DWR配置和使用<o:p></o:p>
设置DWR的使用是简单的:将DWR的jar文件拷入Web应用的WEB-INF/lib目录中,在web.xml中增加一个servlet声明,并创建DWR的配置文件。<o:p></o:p>
DWR的分发中需要使用一个单独的jar文件。你必须将DWR servlet加到应用的WEB-INF/web.xml中布署描述段中去。<o:p></o:p>
<servlet></servlet>
<servlet-name></servlet-name>dwr-invoker<o:p></o:p>
<servlet-class></servlet-class>uk.ltd.getahead.dwr.DWRServlet
<init-param></init-param>
<param-name></param-name> debug
<param-value></param-value> true
<o:p></o:p>
<servlet-mapping></servlet-mapping>
<servlet-name></servlet-name>dwr-invoker
pattern>/dwr/*
<o:p></o:p>
一个可选的步骤是设置DWR为调试模式—象上面的例子那样—在servlet描述段中将debug参数设为true。当DWR在调试模式时,你可以从HTMl网页中看到所有的可访问的Java对象。包含了可用对象列表的网页会出现在/WEBAPP/dwr这个url上,它显示了对象的公共方法。所列方法可以从页面中调用,允许你,第一次,运行服务器上的对象的方法。下图显示了调试页的样子:<o:p></o:p>
<v:shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="if lineDrawn pixelLineWidth 0"></v:f><v:f eqn="sum @0 1 0"></v:f><v:f eqn="sum 0 0 @1"></v:f><v:f eqn="prod @2 1 2"></v:f><v:f eqn="prod @3 21600 pixelWidth"></v:f><v:f eqn="prod @3 21600 pixelHeight"></v:f><v:f eqn="sum @0 0 1"></v:f><v:f eqn="prod @6 1 2"></v:f><v:f eqn="prod @7 21600 pixelWidth"></v:f><v:f eqn="sum @8 21600 0"></v:f><v:f eqn="prod @7 21600 pixelHeight"></v:f><v:f eqn="sum @10 21600 0"></v:f></v:formulas><v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect"></v:path><o:lock v:ext="edit" aspectratio="t"></o:lock></v:shapetype><o:p></o:p>
调试页<o:p></o:p>
现在你必须让DWR知道通过XMLHttpRequest对象,什么对象将会接收请求。这个任务由叫做dwr.xml的配置文件来完成。在配置文件中,定义了DWR允许你从网页中调用的对象。从设计上讲,DWR允许访问所有公布类的公共方法,但在我们的例子中,我们只允许访问几个方法。下面是我们示例的配置文件:<o:p></o:p>
<dwr><o:p></o:p>
<allow><o:p></o:p>
<convert converter="bean" match="com.yd.pojos.Userss"/><o:p></o:p>
<create creator="new" javascript="userAction" class="com.yd.imp.UserCol"><o:p></o:p>
<include method="getALlUser"/><o:p></o:p>
create> <o:p></o:p>
allow><o:p></o:p>
dwr> <o:p></o:p>
上面的文件实现了我们例子中的两个目标。首先,<convert></convert>标记告诉DWR将com.yd.pojos.Userss对象的类型转换为联合数组,因为,出于安全的原因,DWR默认的不会转换普通bean。第二,<create></create>标记让DWR暴露出com.yd.imp.UserCol类给JavaScript调用;我们在页面中使用JavaScript文件被javascript属性定义。我们必须注意<include></include>标记,它指明了com.yd.imp.UserCol类的哪些方法可用。<o:p></o:p>
<o:p> </o:p>
1: 基本的客户端发送值和接受值
参见例子1 testDWR1之test1.jsp<o:p></o:p>
Dwr.xml<o:p></o:p>
<dwr><o:p></o:p>
<allow><o:p></o:p>
<create creator="new" javascript="TestDWR" class="com.yd.colbean.TestDWR"><o:p></o:p>
<include method="getHello"/><o:p></o:p>
create> <o:p></o:p>
allow><o:p></o:p>
dwr><o:p></o:p>
<o:p> </o:p>
Test1.jsp<o:p></o:p>
<script type='text/javascript' src='/TestDWR1/dwr/interface/TestDWR.js'>script><o:p></o:p>
<script type='text/javascript' src='/TestDWR1/dwr/engine.js'>script><o:p></o:p>
<script type='text/javascript' src='/TestDWR1/dwr/util.js'>script><o:p></o:p>
<SCRIPT type='text/javascript'>//这里的代码是从前面的调试页面复制过来的。<o:p></o:p>
<o:p></o:p>
function test1(){<o:p></o:p>
// var s=document.getElementById("username").value<o:p></o:p>
//通过方法得到值 <o:p></o:p>
var s=DWRUtil.getValue("username"); //使用getvalue方法得到id为username的值<o:p></o:p>
TestDWR.getHello(s,del)//调用getHello方法,第一个参数为传递的值,最后一个参数为回调程序<o:p></o:p>
}<o:p></o:p>
//回调程序,参数为返回的结果<o:p></o:p>
function del(data){ <o:p></o:p>
//将值保存在页面的变量中间<o:p></o:p>
DWRUtil.setValue("a",data); //调用setValue方法来设置值<o:p></o:p>
DWRUtil.setValue("rst",data);<o:p></o:p>