woaidongmao

SOAP

XML-RPC

REST

定义

SOAP 是用于在分散的分布式环境中进行信息交换的轻量级协议。该协议基于 XML，包括三个部分：信封、一组编码规则以及用于表示远程过程调用和响应的约定。

这是使用 HTTP 作为传输协议和使用 XML 作为编码方式的远程过程调用。XML-RPC 的设计力求简单，并同时允许传输、处理和返回复杂数据结构。

代表性状态传输旨在反映设计良好的 Web 应用程序的行为图像：由网页组成的网络，其中用户通过选择链接继续进行使用，选择链接将导致将下一页传输给用户并进行呈现，以供其使用。

目标

SOAP 可实现用户定义的数据类型，提供指定接收者的功能、消息特定的处理控制以及其他功能，从而对 XML-RPC 进行了扩展。

非常简单且条理清楚的可扩展格式。HTML 编码人员应该能够查看包含 XML-RPC 过程调用的文件，理解其进行的工作，并能够对其进行修改，只需一两次尝试就能使其正常工作。此协议非常容易实现，可以快速对其进行调整，以在其他环境或其他操作系统上运行。

创建 REST 的目的是为了提供有关 Web 应该如何运行的设计模式，并作为 Web 标准和设计 Web 服务的指导框架。

支持的数据类型

整数、Boolean、ASCII 字符串、双精度带符号浮点数、日期时间、结构、数组、字节数组、枚举、用户定义数据类型、多态访问器

整数、Boolean、ASCII 字符串、双精度带符号浮点数、日期时间、结构、数组。

特定于实现。通常支持的类型有整数、Boolean、ASCII 字符串、双精度带符号浮点数、日期时间、集合、列表、属性。

简单性

比 XML-RPC 略微复杂

易于理解和进行开发

特定于实现

稳定性

W3C 接受的标准

不是标准

体系结构参考。不需要标准

互操作性

无法与 REST/XML-RPC 互操作

无法与 REST/SOAP 互操作

无法与 SOAP/XML-RPC 互操作

工具

很多主要公司（包括 IBM 和 Microsoft）均已开始在其工具中支持 SOAP。

工具仍在开发中。

并没有很多工具支持。

自定义能力

高度可自定义，不受数据类型和协议限制

轻量级，只能在 HTTP 上工作，具有有限的数据类型支持

只能在 HTTP 上工作

库

有很多开放源代码库可用。

有很多开放源代码库可用。将在下面的部分进行说明

并没有很多实现库可用

库和包名称

说明

PDEL

Packet Design Embedded Library 是一个 C 库，其中通过 http_xml_send_xmlrpc 和 http_servlet_xmlrpc 方法包含了客户机和服务器的 XML-RPC 实现。这些函数将帮助通过 HTTP 传输协议发送自定义 XML 数据。这个包还包含很多 XML-RPC 之外的其他功能。

XMLRPC++

这是 XML-RPC 的 C++ 实现。其中提供了简单的服务器和客户机。通过使用面向对象的技术，我们可以集成这些服务器和客户机类，并实现我们自己的 XML-RPC 服务器，以将业务功能作为服务公开。在本文中，我们的示例实现及相关示例将使用这个库。

XMLRPC-C

这是一个 C 实现，可供 C 和 C++ 应用程序用于将这些方法作为服务公开。此包中包括一个 abyss Web 服务器。为了公开 C++ 方法，我们可以为所需的 C++ 方法编写 C 样式的包装，然后使用此库公开此方法。

class operations {

public:

   int add();

   operations(int i, int j);

private:

   int op1;//Operand 1

   int op2;//Operand 2

};

int operations::add()

{

        std::cout << "Sum of "<<op1<<" + "<<op2<<" = "<<op1+op2<<std::endl;

        return(op1 + op2);

}

类名称

用途

Operations

要公开的 add 方法在该类中实现

Add

调用 operations 的 add 方法的包装类。该类也从 myXmlRpcServerMethod 继承

myXmlRpcServerMethod

该类从 XML-RPC 库的 XmlRpcServerMethod 类继承。该类的 execute 将在 Add 类中通过继承覆盖。

xmlRpcServermethod

需要向服务器注册的每个方法都必须通过 myXmlRpcServerMethod 类从该类进行继承，并实现自己的 execute 方法。这个 execute 方法将为公开的实际服务的包装。服务器收到 XML-RPC 调用时，将会直接触发此包装类的 execute 方法。在我们的示例中，Add 将为包装类，从客户端调用“Add”服务时，将调用其 execute 方法。

myXmlRpcServer

该类具有两个重要的私有变量

1. pm_serverMethods：指向在服务器中注册的 myXmlRpcServerMethods 的指针列表。
2. pm_xmlRpcServer：用于设置服务器 IP、端口和其他属性。

三个重要的方法

1. Class constructor：使用 IP/端口详细信息初始化服务器对象，并将其绑定。
2. pm_registerMethods：创建指向 Add 类的指针对象，并将其加入列表 pm_serverMethods 中。
3. run：xmlRpcServer 类中 work 方法的包装

xmlRpcServer

该类是创建服务器对象的 XML-RPC 服务器类。该类具有以下两个重要的方法

1. bindAndListen(port)：绑定并侦听指定的特定端口
2. work(...)：启动服务器

#include "myXmlRpcServer.h"

using namespace XmlRpc;

using namespace std;

myXmlRpcServer::myXmlRpcServer()

{

//call register methods

pm_registerMethods();

//set port bind and listen

int port = 8085;

pm_xmlRpcServer.bindAndListen(port);

std::cout<<"XmlRpcSever running in port "<<port<<std::endl;

}

void

myXmlRpcServer::pm_registerMethods()

{

        Add* a=new Add(&pm_xmlRpcServer);

        myXmlRpcServerMethod *p=a;

        pm_serverMethods.push_back(p); 

}

void

myXmlRpcServer::run()

{

        pm_xmlRpcServer.work(-1);

}

#include <iostream>

#include "myXmlRpcServerMethods.h"

#include "XmlRpc.h"

class myXmlRpcServer {

public:

        myXmlRpcServer();

        void run();

private: 

        void pm_registerMethods();

        XmlRpc::XmlRpcServer pm_xmlRpcServer;

        std::list< myXmlRpcServerMethod* > pm_serverMethods;

};

#include <iostream>

#include "myXmlRpcServer.h"

#include "operations.h"

using namespace std;

Add::Add(XmlRpcServer* s) : myXmlRpcServerMethod("Add", s) {};

Void Add::execute(XmlRpcValue & params, XmlRpcValue& result)

{

 operations a(10,12);

 try 

    {

      cout << "Inside Add::execute method\n";

      result = a.add();

    }

  catch(std::exception & stde)

    {

      throw XmlRpcException(stde.what());

    }

}

class myXmlRpcServerMethod : public XmlRpcServerMethod

{

public:

  myXmlRpcServerMethod

   (const char *name, XmlRpcServer * server):XmlRpcServerMethod(name, server) {}

   virtual void execute(XmlRpcValue & params, XmlRpcValue& result) {assert(0);}

};

class Add:public myXmlRpcServerMethod

{

public:

   Add(XmlRpcServer* s); 

   virtual void execute(XmlRpcValue & params, XmlRpcValue& result);

};

#include <iostream>

#include "myXmlRpcServer.h"

int main(int argc, char* argv[])

{

        myXmlRpcServer GeeBoomBaa;

        std::cout<<"About to run the server\n";

        GeeBoomBaa.run();

        return 0;

}

#include <iostream>

#include "XmlRpc.h"

using namespace XmlRpc;

int main(int argc, char* argv[])

{

        const char *server = "localhost";

        const int port = 8085;

        const char *uri = NULL;

        XmlRpcValue args, res;

        XmlRpcClient c( server, port, uri);

        c.execute("Add", args, res);

        std::cout<<"result is "<<res<<std::endl;

}

Karthik Subbian 目前在班加罗尔的 IBM India Software Laboratory 进行为制造企业构建优化产品方面的工作。他还具备帮助客户管理应用程序并将其迁移到 IBM 平台方面的经验。他感兴趣的软件领域包括网格计算、XML、Web 服务和 SOA。他曾与他人合著了多本有关网格计算技术的 IBM 红皮书。他是 IBM 认证 XML 解决方案开发人员和 Sun 认证 Java 程序员。

Ramakrishnan Kannan 在班加罗尔的 IBM India Software Laboratory 进行主机集成方面的工作。他曾担任过 IBM 个人通信和通信服务器产品方面的开发人员。除了承担的开发工作外，他还与 IBM 亚太区的客户合作进行为主机应用程序启用 Web 服务方面的工作。他曾为 Infosys 等 developerWorks 的业务合作伙伴举办过旨在提高 Web 服务意识的培训。他是 IBM 认证 XML 解决方案开发人员和 Sun 认证 Java 程序员。他感兴趣的领域包括主机集成、分布式计算、SOA 和网络。