AJAXRPC让B/S开发类似C/S

最新推荐文章于 2023-12-19 23:48:02 发布

转载最新推荐文章于 2023-12-19 23:48:02 发布 · 1k 阅读

文章标签：

#function #user #javascript #button #string #input

web开发专栏收录该内容

22 篇文章

订阅专栏

AJAXRPC是一种简便的JavaScript远程方法调用技术，支持多种服务端语言如Java、.Net、PHP等，允许开发者像编写传统的C/S程序一样开发WEB程序。本文介绍了其工作原理及如何在不同场景下进行同步和异步调用。

AJAXPRC是快速、简单的Javascript远程方法调用。它允许你使用Javascript调用服务端方法，基于JSON数据协议，开源授权(LGPL)，可同步和异步调用。

使用AJAXRPC，您可以像开发传统的C/S程序一样，来开发WEB程序，让WEB开发更简单和高效。

支持服务端语言：Java、.Net、PHP。
支持浏览器：IE、FireFox、Opera、Safari、Chrome。

下载： Java .Net PHP
博客
提交BUG
Developer Guide：English Chinese Japanese

最新版本: 1.0
最近更新: 2010-10-10

使用AJAXRPC

首先，我们在服务端定义了一个类和静态方法：

public class Test { public static String sayHello(String name){ return "hello, " + name; } }

注意：必须是公开的静态方法。

然后，我们使用AJAXRPC客户端，对服务端的方法进行调用。

注意：在调用RPC方法时，如果没有传递回调函数，则是同步调用；如果传递回调函数，则是异步调用。

同步调用

<mce:script type="text/javascript"></mce:script>

不传递回调函数，以try…catch来处理错误。在同步调用模式下，如果有网络错误、业务逻辑错误等，会抛出一个异常。

异步调用

<mce:script type="text/javascript"></mce:script>

传递回调函数作为参数。如果只有一个回调函数, 则默认是成功的回调函数。

当我们通过Javascript调用服务端方法时，会传递一些参数，这些参数有一个约定的类型转换，如下表。

数据类型映射表

AJAXRPC支持基本数据类型、自定义类，不支持泛型。

Javascript	Java	.Net	Php	说明
Number	Short,short Integer,int Long,long Float,float Double,double	short,Int16 int,Int32 long,Int64 float Double,double	Integer Float Double	数字类型之间没有严格的界限,可以任意转换
Boolean	Boolean,boolean	Boolean,bool	Boolean
String	String	String,string	String
Date	Date	DateTime	String	日期字符串”Y-m-d/TH:i:s“格式,php需要额外处理
Object	HashMap,Map	Hashtable,IDictionary	Object
Array	ArrayList,List	ArrayList,IList	Array
null	null	null	NULL

AJAXRPC完整示例

首先我们有一个服务端的类，和一些静态方法：

public class Test { //test Date public static Date getTime(){ return new Date(); } //test Number public static int add(int a, int b){ return a + b; } //test String public static String sayHello(String name){ return "hello, " + name; } //test Boolean public static Boolean isTrue(Boolean b){ return b == true; } //test Object public static String addUser(Map user){ String id = UUID.randomUUID().toString(); user.put("id", id); //insert to database //... return id; } //test Array public static List getUsers(String name){ List users = new ArrayList(); for(int i=0; i<20; i++){ Map user = new HashMap(); user.put("name", name+i); user.put("gender", i%2); user.put("birthday", new Date()); users.add(user); } return users; } //test user defined class public static User updateUser(User user) { user.birthday = new Date(); //update to database... return user; } //test user defined class array public static User[] saveUsers(User[] users) { for (int i = 0, l = users.length; i < l; i++) { User user = users[i]; user.name = "Server" + i; user.birthday = new Date(); //update to database... } return users; } }

使用AJAXRPC只需要几个简单的步骤，依次为：描述RPC，发布RPC，生成RPC客户端代理脚本，创建Javascript RPC客户端对象并调用服务端方法。

1.rpc_config.xml

用于描述RPC

<?xml version="1.0″ encoding="UTF-8″?> <services> <service id="Test" class="Test"/> </services>

说明:
1.class是服务端的类名, id是javascript中使用到的类名, id可以自定义别名
2.class上定义的公开静态方法, 被全部发布到客户端
3.在php中，必须为service指定一个文件路径,如：<service id="Test" class="Test" path="/test/Test.php"/>
4.在java中，rpc_config.xml被放在web.xml的同级目录。

2.ajaxrpc/Service.jsp

发布RPC服务端方法，如ajaxrpc/Service.jsp。

<%@ page import="org.ajaxrpc.*" %> <% HttpContext.setCurrent(request, response); AJAXRPC_Server server = new AJAXRPC_Server("rpc_config.xml"); server.run(); %>

3.ajaxrpc/Script.jsp

自动生成RPC的客户端代理脚本，如ajaxrpc/Script.jsp。

<%@ page import="org.ajaxrpc.*" %> <% HttpContext.setCurrent(request, response); AJAXRPC_Script script = new AJAXRPC_Script("rpc_config.xml"); response.getWriter().write(script.getScripts()); %>

4.使用Javascript调用服务端方法

这里做几件事:

1)引入AJAXRPC.js;
2)自动生成调用脚本ajaxrpc/Script.jsp;
3)创建AJAXRPC_Client客户端对象new AJAXRPC_Client("ajaxrpc/Server.jsp");
4)直接调用服务端方法

<html> <head> <title>Test AJAXRPC</title> </head> <body> <input type="button" value="test Date" onclick="testDate()" /><br /> <input type="button" value="test Number" onclick="testNumber()" /><br /> <input type="button" value="test String" onclick="testString()" /><br /> <input type="button" value="test Boolean" onclick="testBoolean()" /><br /> <input type="button" value="test Object" onclick="testObject()" /><br /> <input type="button" value="test Array" onclick="testArray()" /><br /> <input type="button" value="test User Class" onclick="testUserClass()" /><br /> <input type="button" value="test UserClass Array" onclick="testUserClassArray()" /><br /> </body> </html> <mce:script src="scripts/AJAXRPC.js" mce_src="scripts/AJAXRPC.js" type="text/javascript"></mce:script> <mce:script src="ajaxrpc/Script.jsp" mce_src="ajaxrpc/Script.jsp" type="text/javascript"></mce:script> <mce:script type="text/javascript"></mce:script>

AJAXRPC的使用是如此简单，但是能极大的简化WEB AJAX程序的复杂性，帮助人们更好更快的完成AJAX开发工作。