java DWR(Direct Web Remoting)
原文地址:http://fanzhongyun.iteye.com/blog/1222398
DWR(Direct Web Remoting)是一个用于改善web页面与Java类交互的远程服务器端 Ajax开源框架,可以帮助开发人员开发包含AJAX技术的网站.它可以允许在浏览器里的代码使 用运行在WEB服务器上的JAVA函数,就像它就在浏览器里一样。
DWR包含两个主要的部分:允许JavaScript从WEB服务器上一个遵循了AJAX原则的Servlet 中获取数据.另外一方面一个JavaScript库可以帮助网站开发人员轻松地利用获取的数据来 动态改变网页的内容.因为DWR框架也是遵循AJAX原则的,因此使用DWR框架也是能实现页面不刷新,不跳转,而改变页面内容的。下面来看一下DWR的实现过程.
首先来写一个测试类,这个类是将要被DWR框架调用的:
- package com.dwr;
- import java.text.Format;
- import java.text.SimpleDateFormat;
- import java.util.Date;
- public class Information {
- public static String getInformation(){
- Date date = new Date();
- Format frm = new SimpleDateFormat("yyyyMMddHHmmss");
- String nowTime = frm.format(date);
- String year = nowTime.substring(0,4) + "年";
- String month = nowTime.substring(4,6) + "月";
- String day = nowTime.substring(6,8) + "日";
- String hour = nowTime.substring(8,10) + ":";
- String minue = nowTime.substring(10,12) + ":";
- String second = nowTime.substring(12,14);
- return year + month + day + hour + minue + second;
- }
- public static String getInformation(String parameter){
- return "My name is " + parameter;
- }
- }
配置一下WEB-INF目录下的web.xml文件:
- <servlet>
- <servlet-name>dwr-invoker</servlet-name>
- <servlet-class>org.directwebremoting.servlet.DwrServlet</servlet-class>
- <init-param>
- <param-name>debug</param-name>
- <param-value>true</param-value>
- </init-param>
- <init-param>
- <param-name>crossDomainSessionSecurity</param-name>
- <param-value>false</param-value>
- </init-param>
- <init-param>
- <param-name>allowScriptTagRemoting</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>
接着需要在WEB-INF目录下新建一个dwr.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>
- <allow>
- <create javascript="obtainMsg" creator="none">
- <param name="class" value="com.dwr.Information" />
- </create>
- </allow>
- </dwr>
dwr配置属性参考:
creator属性 是必须的 - 它用来指定使用那种创造器。
默认情况下DWR1.1有8种创造器。它们是:
•new: 用Java的new关键字创造对象
•none: 它不创建对象
•scripted: 通过BSF使用脚本语言创建对象
•spring: 通过Spring框架访问Bean
•jsf: 使用JSF的Bean
•struts: 使用Struts的FormBean
•pageflow: 访问Beehive或Weblogic的PageFlow
javascript属性 用于指定浏览器中这个被创造出来的对象的名字。注意不能使用Javascript的关键字
param元素 被用来指定创造器的其他参数
param元素中value属性的值是所要调用的类的url,即类所在的路径
接下来可以先将DWR所需要的dwr.jar和commons-logging.jar两个包导入项目中,这两个包在下面的附件中已经有了的。
好了,工作做得差不多了,先将项目部署好,然后在浏览器中访问以下地址:
http://localhost:5981/DWR/dwr
注:我的Tomcat端口是5981,项目名是DWR
这时候会进入到http://localhost:5981/DWR/dwr/index.html这个地址,接下来是将这个页面上的超链接点开,下面是该页面顶部的部分信息,你需将页面上与js连接相关的代码拷贝下来以备后用。
以下是打开超链接后的页面上的部分内容:
Methods For: obtainMsg (com.dwr.Information)
To use this class in your javascript you will need the following script includes:
<script type='text/javascript' src='/DWR/dwr/interface/obtainMsg.js'></script>
<script type='text/javascript' src='/DWR/dwr/engine.js'></script>
In addition there is an optional utility script:
<script type='text/javascript' src='/DWR/dwr/util.js'></script>
— —— 比如我需要拷贝的代码是:
<script type='text/javascript' src='/DWR/dwr/interface/obtainMsg.js'></script>
<script type='text/javascript' src='/DWR/dwr/engine.js'></script>
<script type='text/javascript' src='/DWR/dwr/util.js'></script>
新建一个测试的jsp,并将拷贝的代码粘贴到这个jsp中:
- <%@ page language="java" import="java.util.*" pageEncoding="gb2312"%>
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
- <html>
- <head>
- <title>DWR Page</title>
- <script type='text/javascript' src='/DWR/dwr/interface/obtainMsg.js'></script>
- <script type='text/javascript' src='/DWR/dwr/engine.js'></script>
- <script type='text/javascript' src='/DWR/dwr/util.js'></script>
- <script type="text/javascript">
- function btn(){
- var uname = document.getElementById("username").value;
- //下面是通过DWR来访问刚才的测试类Information的
- //其中参数time是调用方法后的返回值,uname是传过去的参数,myname是返回值
- //需要注意的是以DWR的方式来调用方法的时候需要用到回调函数来处理
- obtainMsg.getInformation(function(time){
- obtainMsg.getInformation(uname,{callback:function(myname){
- document.getElementById("msg").innerHTML = "<HR><BR>" + myname + "<BR>" + time;
- }
- });
- });
- }
- </script>
- </head>
- <body>
- name:
- <input type="text" id="username" />
- <input type="button" οnclick="btn()" value=" Submit " />
- <br><br>
- <div id="msg"></div>
- </body>
- </html>
好了,DWR到此就完成了。
需要补充说明一下的是,需要连接的js脚本除了像上面那种通过访问拷贝得到之外,你也可以自己来写,注意,是只需要写js的链接代码就行了,源码是由dwr框架提供的,不需要你自己来写的。其中有两个js脚本是不能少的:
<script type='text/javascript' src='/DWR/dwr/engine.js'></script>
<script type='text/javascript' src='/DWR/dwr/util.js'></script>
另外的那些js脚本,是根据dwr.xml配置文件中的javascript属性的值来确认的,比如我在我的dwr.xml文件中配置的是javascript="obtainMsg",因此,我需要连接的js就是:
<script type='text/javascript' src='/DWR/dwr/interface/obtainMsg.js'></script>
同时dwr.xml文件中配置的javascript属性的值(我这里配置的是javascript="obtainMsg")obtainMsg也是一个类或者是一个对象,我们在DWR中就是通过这个名字(obtainMsg)来访问这个类或者是对象里面的方法的