dwr学习入门

DWR可以让你在浏览器中的Javascript代码调用Web服务器上的Java，就像是Java代码就在浏览器中一样。

DWR主要包括两部分：

在服务器上运行的Servlet来处理请求并把结果返回浏览器。
运行在浏览器上的Javascript，可以发送请求，并动态改变页面。
DWR会根据你的Java类动态的生成Javascript代码。这些代码的魔力是让你感觉整个Ajax调用都是在浏览器上

发生的，但事实上是服务器执行了这些代码，DWR负责数据的传递和转换。
这一过程不需要额外的浏览器插件。

下载地址 http://directwebremoting.org/dwr/download

配置文件dwr.xml 默认情况下，应该把它放到WEB-INF下的lib目录(同web.xml的目录)下

结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dwr PUBLIC
    "-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN"
    "http://www.getahead.ltd.uk/dwr/dwr10.dtd">
<dwr>
  <!-- init is only needed if you are extending DWR -->
  <init>
    <creator id="..." class="..."/>
    <converter id="..." class="..."/>
  </init>

  <!-- without allow, DWR isn't allowed to do anything -->
  <allow>
    <create creator="..." javascript="..."/>
    <convert converter="..." match="..."/>
  </allow>

  <!-- you may need to tell DWR about method signatures -->
  <signatures>
    ...
  </signatures>
</dwr>

 我们必须理解一些术语 - 参数会被converted，远程bean会被created。所以如果你有一个叫A的bean，它

有一个方法叫A.test(B) 那么你需要一个A的creator和一个B的converter。

<allow>段落里面定义的是DWR可以创建和转换的类。

<create>定义我们要调用的每个类。creator有几种,比较通用的是new关键字和Spring。

<convert>一般来说JavaBean的参数需要一个<convert ...>定义,我们必须保证所有的参数都可以被转换。JDK中的多数类型已经有转换器了，但是你需要给DWR转换你的代码的权利。

默认情况下，如下类型不需要定义就可以转换：

• 所有的原生类型 boolean,int,double, 等等
• 原生类型的对象类型 Boolean,Integer,等等
• java.lang.String
• java.util.Date 和SQL中的Date
• 以上类型组成的数组
• 以上类型的集合类型 (Lists, Sets, Maps, Iterators, 等)
• 从DOM, XOM, JDOM 和 DOM4J中的DOM对象 (类似 Element 和 Document)

<init>可选的init部分用来声明创造bean的类和转换bean的类。多数情况下不需要用到他们。如果需要定义一个新的Creator 和 Converter ， 那么就需要在这里定义他们。但是建议先检查一下DWR是不是已经支持了。

在init部分里有了定义只是告诉DWR这些扩展类的存在，给出了如何使用的信息。这时他们还没有被使用。这中方式很像Java中的import语句。多数类需要在使用前先import一下，但是只有import语句并不表明这个类已经被使用了。每一个creator和converter都用id属性，以便后面使用。 

<signatures>DWR使用反射来找出在转换时应该用哪种类型。有时类型信息并不明确，这时就可以在这里写下方法的签名来明确类型。

其实，一个项目中可以有多个dwr.xml文件,每个文件中的定义会被加在一起。

DWR提供了两个Javascript库：

• engine.js: 处理所有与服务器的通信
• util.js: 帮你使用从服务器取来的数据改变页面(还有一些灵巧的小功能)

DWR不是一个通用的Javascript库，所以我们尽可能使那些非远程调用相关的功能清晰。尽管如此，util.js有一些小功能会使工作更加容易。

将dwr.jar放到应该把它放到WEB-INF下的lib目录下：

配置web.xml:

   <servlet>
     <servlet-name>dwr-invoker</servlet-name>
     <servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
  </servlet>
  <servlet-mapping>
     <servlet-name>dwr-invoker</servlet-name>
   <url-pattern>/dwr/*</url-pattern><!--dwr也可以写成别的，只是导入js时要注意路径-->
  </servlet-mapping>

 在页面上使用要用到dwr的javascript库：

<script type="text/javascript" src="dwr/engine.js"></script>
<script type="text/javascript" src="dwr/util.js"></script>

 相关要用的要自己导入，但要存在于interface包下，如：

 

<script type="text/javascript" src="dwr/interface/math.js"></script>

 上面的js文件来源于dwr.xml的配置：

<allow>
   <create javascript="math" creator="new">
       	<param name="class" value="java.lang.Math"></param>
   </create>
</allow>

 使用math.js:

//输出随机数
  function mm(){
  	math.random(getm);  <--使用Math的方法random-->
  }
  function getm(data){
  	alert(data);
  }

 

<button onclick="mm();">Math</button>

 

点击Math按钮即可得到一个随机数字。这就是dwr的简单使用。

想学dwr，http://wiki.javascud.org/display/dwrcn/Home是个好地方。