Knight of the round table

          wansong

          Webservice - XML-RPC

          http://baike.baidu.com/view/643379.htm


          XML-RPC的全稱是XML Remote Procedure Call,即XML遠程方法調用。
            它是一套允許運行在不同操作系統、不同環境的程序實現基于Internet過程調用的規范和一系列的實現。
            這種遠程過程調用使用http作為傳輸協議,XML作為傳送信息的編碼格式。Xml-Rpc的定義盡可能的保持了簡單,但同時能夠傳送、處理、返回復雜的數據結構。
            XML-RPC是工作在Internet上的遠程過程調用協議。一個XML-RPC消息就是一個請求體為xml的http-post請求,被調用的方法在服務器端執行并將執行結果以xml格式編碼后返回。
            Request example
            Here's an example of an XML-RPC request:
            POST /RPC2 HTTP/1.0User-Agent: Frontier/5.1.2 (WinNT)Host: betty.userland.comContent-Type: text/xmlContent-length: 181
            <?xml version="1.0"?>
            <methodCall>
            <methodName>examples.getStateName</methodName>
            <params>
            <param>
            <value><i4>41</i4></value>
            </param>
            </params>
            </methodCall>
            Response example
            Here's an example of a response to an XML-RPC request:
            HTTP/1.1 200 OKConnection: closeContent-Length: 158Content-Type: text/xmlDate: Fri, 17 Jul 1998 19:55:08 GMTServer: UserLand Frontier/5.1.2-WinNT
            <?xml version="1.0"?>
            <methodResponse>
            <params>
            <param>
            <value><string>South Dakota</string></value>
            </param>
            </params>
            </methodResponse>
            二 XML-RPC入門程序
            以下的入門程序包括一個管理器(HelloHandler)、一個服務器(HelloServer)、一個客戶程序(HelloClient)。
            首先要做的是創建用于遠程過程調用的類和方法,人們常常稱之為管理器。Xml-rpc管理器是一個方法和方法集,它接受xml-rpc請求,并對請求的內容進行解碼,再向一個類和方法發出請求。
            //管理器類
            package xmlRpc;
            /**
            * @author trier
            *
            * <b><code>HelloHandler</code></b> is a simple handler than can
            * be registered with an XML-RPC server
            */
            public class HelloHandler {
            public String sayHello(String name){
            return "Hello " + name;
            }
            }
            服務器程序將創建的管理器注冊到服務器上,并為服務器指明應用程序其他特定的參數。
            //服務器類
            package xmlRpc;
            /**
            *
            * <b><code>HelloServer</code></b> is a simple XML-RPC server
            * that will take the <code>HelloHandler</code> class available
            * for XML-PRC calls.
            * <o:p
            */
            import org.apache.xmlrpc.WebServer;
            import org.apache.xmlrpc.XmlRpc;
            import java.io.IOException;
            public class HelloServer {
            public static void main(String[] args){
            if(args.length<1){
            System.out.println("Usage: java HelloServer [port]");
            System.exit(-1);
            }
            try{
            XmlRpc.setDriver("org.apache.xerces.parsers.SAXParser");
            //start the server
            System.out.println("Starting XML-RPC Server......");
            WebServer server = new WebServer(Integer.parseInt(args[0]));
            //register our handler class
            server.addHandler("hello",new HelloHandler());
            System.out.println("Now accepting requests......");
            }catch(ClassNotFoundException e){
            System.out.println("Could not locate SAX Driver");
            }catch(IOException e){
            System.out.println("Could not start server: "+e.getMessage());
            }
            }
            }
            //客戶程序
            package xmlRpc;
            /**
            *
            * <b><code>HelloClient</code></b> is a simple XML-RPC client
            * that makes an XML-RPC request to <code>HelloServer</code>
            */
            import java.io.IOException;
            import java.util.Vector;
            import org.apache.xmlrpc.XmlRpc;
            import org.apache.xmlrpc.XmlRpcClient;
            import java.net.MalformedURLException;
            import org.apache.xmlrpc.XmlRpcException;
            public class HelloClient {
            public static void main(String[] args){
            if(args.length<1){
            System.out.println("Usage: java HelloClient [your name]");
            System.exit(-1);
            }
            try{
            //Use the Apache Xereces SAX Driver
            XmlRpc.setDriver("org.apache.xerces.parsers.SAXParser");
            //Specify the server
            XmlRpcClient client = new XmlRpcClient("http://localhost:8585");
            //create request
            Vector params = new Vector();
            params.addElement(args[0]);
            //make a request and print the result
            String result = (String)client.execute("hello.sayHello",params);
            System.out.println("Response from server: "+ result);
            }catch(ClassNotFoundException e){
            System.out.println("Could not locate SAX Driver");
            }catch(MalformedURLException e){
            System.out.println("Incorrect URL fro xml-rpc server foramt:"+e.getMessage());
            }catch(XmlRpcException e){
            System.out.println("XmlRpcException :"+e.getMessage());
            }catch(IOException e){
            System.out.println("IOException:"+e.getMessage());
            }
            }
            }
            三 RPC和RMI的簡單比較
            在RMI和RPC之間最主要的區別在于方法是如何別調用的。在RMI中,遠程接口使每個遠程方法都具有方法簽名。如果一個方法在服務器上執行,但是沒有相匹配的簽名被添加到這個遠程接口上,那么這個新方法就不能被RMI客戶方所調用。在RPC中,當一個請求到達RPC服務器時,這個請求就包含了一個參數集和一個文本值,通常形成“classname.methodname”的形式。這就向RPC服務器表明,被請求的方法在為“classname”的類中,名叫“methodname”。然后RPC服務器就去搜索與之相匹配的類和方法,并把它作為那種方法參數類型的輸入。這里的參數類型是與RPC請求中的類型是匹配的。一旦匹配成功,這個方法就被調用了,其結果被編碼后返回客戶方。

          posted on 2011-01-05 11:23 w@ns0ng 閱讀(518) 評論(0)  編輯  收藏 所屬分類: J2EEweb service

          主站蜘蛛池模板: 黔东| 广元市| 平顺县| 北流市| 怀化市| 龙胜| 惠水县| 博罗县| 承德县| 晋宁县| 额尔古纳市| 翁牛特旗| 上栗县| 大关县| 安庆市| 韶山市| 许昌市| 阳山县| 灵武市| 镇坪县| 当雄县| 台中县| 伽师县| 杭锦后旗| 饶阳县| 乌鲁木齐市| 东乡| 郸城县| 卢氏县| 营口市| 红河县| 诸暨市| 西乌| 增城市| 东丽区| 福州市| 河北省| 秦皇岛市| 文成县| 乐平市| 田林县|