DWR文档之开始使用 DWR

原文出处: http://www.javatang.com/archives/2006/10/20/254879.html
翻译: Jet Mah
声明: 请维持文章的完整性任意转载

开始使用 DWR

有两种方法来开始 DWR 的学习,最简单的做法是下载官方提供的 WAR 文件然后对此深入研究。不过这种方式不能使你感到将 DWR 整合到你现有的 web 程序有多么的简单,所以我们推荐你跟随下面三个步骤:

1. 安装 DWR JAR 包
下载 dwr.jar 文件,然后将它放在 web 程序的 WEB-INF/lib 目录下面,很可能在这个目录下已经有一些 jar 文件了。

2. 编辑 config 文件

将下面的代码添加到 WEB-INF/web.xml 文件中,<servlet>需要放在另外的<servlet>之后,<servlet-mapping>也是如此。

<servlet>
  <servlet-name>dwr-invoker</servlet-name>
  <display-name>DWR Servlet</display-name>
  <servlet-class>uk.ltd.getahead.dwr.DWRServlet</servlet-class>
  <init-param>
     <param-name>debug</param-name>
     <param-value>true</param-value>
  </init-param>
</servlet>

<servlet-mapping>
  <servlet-name>dwr-invoker</servlet-name>
  <url-pattern>/dwr/*</url-pattern>
</servlet-mapping>

接下来创建 dwr.xml 文件并将此放在 web.xml 所在的 WEB-INF 目录下。文件中类似下面的内容:

<!DOCTYPE dwr PUBLIC
    ”-//GetAhead Limited//DTD Direct Web Remoting 1.0//EN”
    ”http://www.getahead.ltd.uk/dwr/dwr10.dtd”>

<dwr>
  <allow>
    <create creator=”new” javascript=”JDate”>
      <param name=”class” value=”java.util.Date”/>
    </create>
    <create creator=”new” javascript=”Demo”>
      <param name=”class” value=”your.java.Bean”/>
    </create>
  </allow>
</dwr>

DWR 配置文件定义了由 DWR 创建和被 Javascript 远程使用的类。在上面的例子中我们在远程创建了2个类,并且给出了在 Javascript 中的类名。

上面使用的 new creator 使用了所有的 JavaBeans 必须含有的公有(public)无参(no-args)的构造函数。值得一提的是, DWR 还有一些限制:

  • 避免使用 JavaScript 保留字;以保留字命名的方法将自动被排除。大多数 JavaScript 的保留字同时也是 Java 的保留字,因此无论如何你也不能使用一个名为 “try()” 的方法。但是最常用的一个词 “delete()”,在 JavaScript 中有特殊的含义而在 Java 中没有。
  • 重载方法(Overloaded methods)将会在调用的时候陷入未知的状况,因此应该避免重载方法。3. 访问下面的地址
    http://localhost:8080/[YOUR-WEBAPP]/dwr/

    你应该会看到一个页面,上面显示了刚才你在第二步所创建的类。进入一个链接之后你会看到所有等待调用方法的列表。这些动态产生的例子你也能通过 DWR 来实现。

    亲自尝试和体会下吧。

    怎样应用到你的 Web 程序中?

    在侧边栏有很多例子演示了怎样改变网页中的文本、更新列表、操作表单和动态修改表格。每一个例子都有详细的说明。

    另外一个开始方法就是从页面中查看源代码,这些页面你刚刚浏览过:

  • 进入 http://localhost:8080/[YOUR-WEBAPP]/dwr/ 然后点击你创建的类;
  • 查看源代码然后定位到你所感兴趣的方法的代码行;
  • 将这些文本粘贴到你 Web 程序的一个 HTML 或 JSP页面中;
  • 包含下面的 javascrip 文件:

    <script src=’/[YOUR-WEBAPP]/dwr/interface/[YOUR-SCRIPT].js’></script>
    <script src=’/[YOUR-WEBAPP]/dwr/engine.js’></script>

    你可以根据实际情况修改 /[YOUR-WEBAPP]/ 部分。

    关于怎样书写 DWR 控制的 Javascript 代码请查看 脚本简介

    不能运行怎么办?

    我们专门有一个 常见问题及解答,应该首先查看这个地方。

    如果依然有问题请 加入新闻组然后在此提问。

    英文出处:
    http://getahead.org/dwr/getstarted
    DWR文档翻译文档列表:
    http://www.javatang.com/dwr-chinese-documents/

  • 3 thoughts to “DWR文档之开始使用 DWR”

    发表评论

    电子邮件地址不会被公开。 必填项已用*标注