1. XML-RPC
a)
原理:XML-RPC是以XML的方式来发送RPC调用,他使用HTTP作为传输协议,把需要发送的请求和请求的结果封装到HTTP的消息当中。
由于RPC调用也是方法调用,只是被调用的一方不是在本地而已,虽然是这样,但是不能改变的是调用的本质,对于调用方,他需要提供所调用的方法和方法的参数,而对于被调用方,她通过解释调用方的请求,执行响应的调用,并将结果返回。这就是方法调用的本质。
RPC只是在调用和返回之间增加了网络传输和编码解码部分,而XML-RPC则是规定了编码和解码必须使用XML格式,而网络传输必须使用HTTP协议,仅此而已。
2. XML-RPC的请求和响应格式
a)
请求:
POST /rpchandler HTTP/1.0
User-Agent: AcmeXMLRPC/1.0
Host: xmlrpc.example.com
Content-Type: text/xml
Content-Length: 165
<?xml version="1.0"?>
<methodCall>
<methodName>getCapitalCity</methodName>
<params>
<param>
<value><string>England</string></value>
</param>
</params>
</methodCall>
b)
响应:
HTTP/1.1 200 OK
Date: Sun, 29 Apr 2001 12:08:58 GMT
Server: Apache/1.3.12
(Unix) Debian/GNU PHP/4.0.2
Connection: close
Content-Type: text/xml
Content-length: 133
<?xml version="1.0"?>
<methodResponse>
<params>
<param>
<value><string>Michigan</string></value>
</param>
</params>
</methodResponse>
c)
错误:
HTTP/1.1 200 OK
Date: Sun, 29 Apr 2001 12:08:58 GMT
Server: Apache/1.3.12
(Unix) Debian/GNU PHP/4.0.2
Connection: close
Content-Type: text/xml
Content-length: 133
<?xml version="1.0"?>
<methodResponse>
<fault>
<value>
<struct>
<member>
<name>faultCode</name>
<value><int>802</int></value>
</member>
<member>
<name>faultString</name>
<value><string>Unknown
country, 'Engand'.</string></value>
</member>
</struct>
</value>
</fault>
</methodResponse>
3. XML-RPC实例
a)
发送请求:
i.
说明:使用XmlRpcClient可以发送请求,在请求当中我们需要提供所需要调用的方法名,以及方法参数,且参数需包装到一个集合当中。
ii.
代码:
XmlRpcClient client = new
XmlRpcClient("http://127.0.0.1:6666");
Vector<String> pars = new
Vector<String>();
pars.addElement("nick");
Object result = client.execute("service.hello", pars);
System.out.println("The Result is
: " + result);
b)
发布服务:
i.
说明:通过WebServer我们可以很方便的发布服务。其中添加到addHandler()当中的实例就是服务体,而“service”就表示服务名称。当请求到达时,他会根据请求的名称与查找服务体,然后在返回的实例上调用execute()方法。
ii.
代码:
WebServer server = new WebServer(6666);
server.addHandler("service",
new Service());
server.start();
public class Service implements XmlRpcHandler {
public
Object execute(String methodName, Vector args) throws Exception {
if
("service.hello".equals(methodName)) {
return
hello((String) args.get(0));
}
return
"";
}
private
String hello(String name) {
return
"Hello " + name;
}
}