利用Ruby的SOAP4R编写SOAP服务器的教程

 什么是SOAP ?

简单对象访问协议（SOAP）是一个跨平台和语言无关的，基于XML的RPC协议，通常（但不一定）是HTTP。

它使用XML来编码信息使远程过程调用，HTTP在网络上从客户机到服务器来传输信息，反之亦然。

SOAP有几个优势超过其他技术，如COM，CORBA等为例，其相对廉价的部署和调试成本，它的可扩展性和易于使用,存在几种不同的语言和平台实现。

请参阅出简单的教程了解 SOAP

本教程将熟悉SOAP实现Ruby（SOAP4R）。这是一个基本的教程，所以如果需要深入细节，那么需要参考其他资源。
安装SOAP4R:

SOAP4R是由Hiroshi Nakamura编定，可以直接从网上下载Ruby的开发的SOAP实现：

注意：有可能已经安装了这个组件。

Download SOAP

如果知道 gem 实用工具，那么可以使用下面的命令安装SOAP4R和相关包。

$ gem install soap4r --include-dependencies

如果是在Windows上工作，那么需要下载一个压缩文件，从上面的位置，需要安装它使用标准的安装方法运行Ruby的 install.rb.
编写SOAP4R服务器：

SOAP4R支持两种不同类型的服务器：

    CGI/FastCGI based (SOAP::RPC::CGIStub)     Standalone (SOAP::RPC:StandaloneServer)

本教程将详细编写一个独立的服务器。涉及编写SOAP服务器有以下步骤：
第1步 - 继承SOAP::RPC::StandaloneServer 类:

要实现自己的独立服务器，需要编写一个新类，这将SOAP::StandaloneServer 类的子类，如下：

代码如下:class MyServer < SOAP::RPC::StandaloneServer
  ...............
end

注意：如果想编写一个基于FastCGI的服务器，那么需要继承SOAP::RPC::CGIStub 类, 其余步骤将保持相同。
第2步 - 定义处理程序方法：

第二步是编写Web服务方法，希望向外界公开。

它们可以写成简单的Ruby方法。例如，让我们写了两个两个两个数相加，两个数相除的方法：

class MyServer < SOAP::RPC::StandaloneServer  ...............  # Handler methods  def add(a, b)   return a + b  end  def div(a, b)    return a / b   endend

第3步 - 暴露处理程序方法：

下一步是我们定义的方法添加到我们的服务器。 initialize方法用于暴露服务的方法，用以下两种方法之一：

class MyServer < SOAP::RPC::StandaloneServer  def initialize(*args)   add_method(receiver, methodName, *paramArg)  endend

下面的参数说明：

 To understand the usage of inout or out parameters, consider the following service method that takes two parameters (inParam and inoutParam), returns one normal return value (retVal) and two further parameters: inoutParam and outParam: