使用XML-RPC来访问Web服务

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;

     }

}