xmlRpc客户端例子

1&＃xff0c;The xmlrpcclient-----xmlrpc客户端

在说XML-RPC server前&＃xff0c;我们需要拥有一个XmlRpcClient的实例。

它是一个无状态&＃xff0c;线程安全的对象。客户端通过设置如下对象来进行配置&＃xff1a;

A,ClientConfig&＃xff1a;这个对象是XmlRpcClientConfig的实例。它有许多的原子属性&＃xff0c;定义了如SERVER URL,credentials,字符集等等详细设置。

B,TransportFactory&＃xff1a;它的任务是创建一个用于与服务端通信的对象&＃xff0c;这个对象使用clientConfig的设置进行配置。

C,XmlWriterFactory&＃xff1a;它是一个用来创建XML的对象。

客户端的一个例子&＃xff1a;

import org.apache.xmlrpc.client.XmlRpcClient;

import org.apache.xmlrpc.client.XmlRpcClientConfigImpl;

XmlRpcClientConfigImpl config &＃61; new XmlRpcClientConfigImpl();

config.setServerURL(new URL("http://127.0.0.1:8080/xmlrpc"));

XmlRpcClient client &＃61; new XmlRpcClient();

client.setConfig(config);

Object[] params &＃61; new Object[]{new Integer(33), new Integer(9)};

Integer result &＃61; (Integer) client.execute("Calculator.add", params);

这个示例展示我了我们调用远端的Calculator对象的add方法&＃xff0c;参数由params指定&＃xff0c;result作为方法的返回值。

这个示例默认使用的是java.net.URLConnection类来与服务端进行连接。假如你想要使用HTTPClient包来与服务端连接&＃xff0c;则只需要做一个修改:

import org.apache.xmlrpc.client.XmlRpcClient;

import org.apache.xmlrpc.client.XmlRpcClientConfigImpl;

import org.apache.xmlrpc.client.XmlRpcCommonsTransportFactory;

XmlRpcClientConfigImpl config &＃61; new XmlRpcClientConfigImpl();

config.setServerURL(new URL("http://127.0.0.1:8080/XmlRpcServlet"));

XmlRpcClient client &＃61; new XmlRpcClient();

client.setTransportFactory(new XmlRpcCommonsTransportFactory(client));

client.setConfig(config);

Object[] params &＃61; new Object[]{new Integer(2), new Integer(3)};

Integer result &＃61; (Integer) client.execute("Calculator.add", params);

换句话说,transport factory决定了客户端如何与服务端进行通信&＃xff0c;最重要的tansprot factory如下&＃xff1a;

A&＃xff0c;XmlRpcSunHttpTransprotFactory&＃xff1a;这是默认的transport factory&＃xff0c;通过使用java.net.HttpURLConnection来与HTTP服务端 建立连接。

B&＃xff0c;XmlRpcCommonsTransportFactory&＃xff1a;另一个HTTP transport factory&＃xff0c;通过使用the jakarta commons httpclient来与服务端进行通信。

C&＃xff0c;XmlRpcLiteHttpTransportFactory&＃xff1a;这也是一个HTTP transport factory&＃xff0c;它是基于一个私有的&＃xff0c;非常轻量的HTTP客户端。它很可能是最快的transport factory。但是&＃xff0c;它不能支持HTTP/1.1&＃xff0c;因此不能使用keepalive连接。

D&＃xff0c;XmlRpcLocalTransportFactory&＃xff1a;这个transport factory 有一个内嵌的XML-RPC服务器&＃xff0c;可以通过直接的java调用来调用它。这个对于调试和开发是特别有用。

2&＃xff0c;Server-side XML-RPC(服务端XML-RPC)

对于服务端来说&＃xff0c;和客户端其实没太大区别。首先&＃xff0c;需要一个叫做XmlRpcServer的对象。这个对象的目的是接收和执行来自客户端的XML-RPC调用。XmlRpcServer能够被嵌入到一个servlet container或者另一个HTTP server中。就像the local transport一样&＃xff0c;XML-RPC server被嵌到了client application中。

就像XmlRpcClient,XmlRpcServer需要一个配置&＃xff0c;这个配置通过XmlRpcServerConfigImpl对象提供。