假如这个世界上只剩下你一个人，当你正坐在屋子里的时候，这时突然响起了敲门声...

【原创】用jabsorb(json) for java编写AJAX应用程序

上一篇 / 下一篇 2008-07-04 11:10:16 / 个人分类：web

本文为原创，如需转载，请注明作者和出处，谢谢！
!M,ZJjYG!Y2O0
vfu;J)Z*VXU0

jabsorb是一种基于Ajax/Web 2.0的简单轻便的框架，可用于在Web浏览中通过HTTP请求向服务端发送请求，并获得响应数据。实际上jabsorb就是json的升级版（不仅改了个名，而且包名都改了），目前最新版本是1.3。

老版本的json可以从http://oss.metaparadigm.com/jsonrpc/download.html下载。

jabsorb可以从http://jabsorb.org/Download下载。

jabsorb在json基础上有了很大的改进，从1.2版开始支持ORB和循环引用（Circular References）。使用jabsorb至少有以下两个好处：
\7S!\s3IPJP0ITPUB个人空间MX+l}-]2c%@(`1V t
1. 在jabsorb中已经支持IE, Mozilla , Firefox , Safari , Opera, Konqueror等浏览器，因此，使用jabsorb编写的AJAX程序也就可以跨不同的Web浏览器。

2. 使用jabsorb在客户端和服务端传递数据非常方便。在客户端可以象使用本地对象一样使用服务端的对象。ITPUB个人空间~Yt;{.QH-S

Y^9H1a%RJ,|$hvj(B+r0

下面我们就来看一下如何使用jabsorb来编写基于AJAX的Web程序。本文使用Tomcat6.x作为Web服务器，读者可以根据需要使用其他的Web服务器。

3o(@!C3Ls6R7D0一、jabsorb的安装

安装jabsorb需要如下几步：ITPUB个人空间_r,DmK
ITPUB个人空间$AJO_o8o1F
第1步：加入jar包

jabsorb需要三个jar包：jsonrpc-1.0.jar、jsonrpc-1.0.jar和slf4j-api-1.4.2.jar，这三个文件都可以在jabsorb的压缩包中找到。将这三个文件放到<Tomcat安装目录>"lib目录中，或是放到<Web根目录>"WEB-INF"lib目录中。

第2步：配置web.xml

打开<Web根目录>"WEB-INF"web.xml，并加入如下的配置代码：

  <servlet>
    <servlet-name>JSONRPCServlet</servlet-name>
    <servlet-class>org.jabsorb.JSONRPCServlet</servlet-class>

    <init-param>
      <param-name>gzip_threshold</param-name>
      <param-value>0</param-value>
    </init-param>
  </servlet>
  <servlet-mapping>
    <servlet-name>JSONRPCServlet</servlet-name>
    <url-pattern>/JSON-RPC</url-pattern>
  </servlet-mapping>

这段代码配置了一个jabsorb引擎，实际上就是一个Servlet（和Struts1.x类似，也是通过Servlet作为入口的）。其中gzip_threshold可以取-1、0和一个正整数。如果值为-1，表示不会对响应的内容进行压缩，如果为0，表示对响应的所有内容进行压缩，如果为一个正整数，表示当响应内容超过这个整数时,进行压缩。

但当浏览器不支持gzip压缩格式，或是经过压缩后的尺寸要比不压缩的尺寸还大时（当响应内容比较少时可能发生这种情况），jabsorb就不会对响应内容进行压缩。因此，最好将这个值设为0，但这样做所付出的代价是可能会对所有的响应内容进行压缩。具体要设成什么值，读者可根据自己的具体情况决定。

第3步将jsonrpc.js复制到<Web根目录>"script中，读者也可以将其放到<Web根目录>中的其他可访问的位置。这个文件也可以在jabsorb的压缩包中找到。
)ciA!r8Z\$~0
G5zq&z[B!~-x0

二、编写一个简单的jabsorb应用程序

第1步编写一个用客户端访问的Java类。

package invoke;

public class Message implements java.io.Serializable
{
    public String getMessage(String s)
    {
        return "你好  " + s;
    }
}

第2步编写JSP代码

<%--  index.jsp  --%>

<%@ page language="java" import="java.util.*" pageEncoding="GB18030"%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
    <head>
<script type="text/javascript" src="script/jsonrpc.js"></script>
<script type="text/javascript">
function onLoad()
{
    jsonrpc = new JSONRpcClient("JSON-RPC");
}
window.onload = onLoad;

function invoke()
{
    var text = document.getElementById("text");
    var result = jsonrpc.msg.getMessage(text.value);
    alert(result);
}
</script>
<jsp:useBean id="JSONRPCBridge" scope="session"
   class=" org.jabsorb.JSONRPCBridge " />
<jsp:useBean id="message" scope="session"
     class="invoke.Message" />
<%
JSONRPCBridge.registerObject("msg", message);
%》
</head>

    <body>
    <input type="text" id="text"/>
    <input type="button" value="获得信息" onclick="invoke()" />
    </body>
</html>

在这个jsp文件中需要做如下四件事才能调用getMessage方法。

1 引用jsonrpc.js文件。

2 在onLoad函数中创建JSONRpcClient对象。JSONRpcClient类的构造方法的参数值就是在web.xml中配置的JSON-RPC。

3 使用<jsp:userBean>创建了org.jabsorb. JSONRPCBridge和invoke.Message对象

4 使用JSONRPCBridge的registerObject方法注册Message类，其中第一个参数可以是任意的字符串（这个参数是注册名），第二个参数是Message对象实例。registerObject方法可以对同一个注册名使用多次，但后一个将覆盖前一个对象。

在做完上述工作后，就可以使用jsonrpc.msg.getMessage来调用getMessage方法了。

三、在Servlet中使用jabsorb

除了在JSP中使用jabsorb外，也可以在Servlet中使用它。代码如下：

public void service(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException
    HttpSession session = request.getSession();
    JSONRPCBridge bridge = (JSONRPCBridge) session.getAttribute("JSONRPCBridge");
    if(bridge == null)
    {
bridge = new JSONRPCBridge();
session.setAttribute("JSONRPCBridge", bridge);
    }
    bridge.registerObject("msg", message);

}

从上面的代码可以看出，在Servlet中使用jabsorb，实际上就是使用registerObject方法来注册Message类。然后可以forward到使用jabsorb的JSP页面，也可以使用PrintWriter在当前Servlet中输出相应的javascript和html代码。

四、注册全局对象ITPUB个人空间5n;Le ?1U:mI-i

hv~3m9G{3N%X;t0 使用registerObject注册的对象只能在当前页面访问。如果想注册一次，就可以任何运行在当前Web服务器的页面（JSP、HTML等）中使用这个对象，就需要使用如下的代码来注册Message对象：
k {? dRryF&q0
}MjR*Z5x _D0

JSONRPCBridge.getGlobalBridge().registerObject("globalMsg", message);

读者可以将上面的相应代码换成这行代码，然后另建立一个test.jsp，然后使用如下的代码调用getMessage方法：

但经笔者测试，在firefox中访问test.jsp，竟然可以访问msg对象，但在IE里就会抛出对象错误异常。

五、访问集合类型

如果反回的数据很多的话，可以使用Java提供的集合类型，如将Message因扩展为如下形式：

package invoke;

public class Message implements java.io.Serializable
{
    public String getMessage(String s)
    {
        return "你好  " + s;
    }
    public java.util.List getList()
    {
        java.util.List list = new java.util.LinkedList();
        list.add("中国");
        list.add(1234);
        return list;
    }

    public java.util.Map getMap()
    {
        java.util.Map map = new java.util.HashMap();
        map.put("bird", "鸟");
        map.put("human", "人类");
        return map;
    }
}

index.jsp中可加入如下的代码来访问getList、getMap方法中的数据：

alert(jsonrpc.globalMsg.getList().list[1]);
l'D8RQ;Nx)|@0 alert(jsonrpc.globalMsg.getMap().map['bird']);

</script>

六、异步调用
]PU8s kSDI3g,k0
il%^e]E%w't0 上面的代码都是同步调用，也就是在反回结果之前，客户端程序会被阻塞。为了在网络环境不畅的环境下Web程序仍然能运行良好，这就需要进行异步调用。也就是说，客户端在发送请求后立即返回，直接服务端返回信息，才会调用另一个“回调函数”来获取结果。

回调函数必须有两个参数，第一个参数表示返回值，第二个参数表示异常信息。如果无异常信息，第二个参数值为null。下面是一个回调函数：ITPUB个人空间g"ig4}7xI-IUwcD
ITPUB个人空间 _y6A&T/k1r