Ruby 教程 之 Ruby Web Service 应用 - SOAP4R 2
Ruby Web Service 应用 - SOAP4R
什么是 SOAP?
简单对象访问协议(SOAP,全写为Simple Object Access Protocol)是交换数据的一种协议规范。
SOAP 是一种简单的基于 XML 的协议,它使应用程序通过 HTTP 来交换信息。
简单对象访问协议是交换数据的一种协议规范,是一种轻量的、简单的、基于XML(标准通用标记语言下的一个子集)的协议,它被设计成在WEB上交换结构化的和固化的信息。
SOAP4R 客户端
ruby 中使用 SOAP::RPC::Driver 类开发 SOAP 客户端。接下来我们来详细看下 SOAP::RPC::Driver 类的使用。
调用 SOAP 服务需要以下信息:
SOAP 服务 URL 地址 (SOAP Endpoint URL)
服务方法的命名空间(Method Namespace URI)
服务方法名及参数信息
接下来我们就一步步来创建 SOAP 客户端来调用以上的 SOAP 方法:add 、 div:
第一步 - 创建 SOAP Driver 实例
我们可以通过实例化 SOAP::RPC::Driver 类来调用它的新方法,如下所示:
SOAP::RPC::Driver.new(endPoint, nameSpace, soapAction)
以下是参数的描述:
参数 描述
endPoint 连接 SOAP 服务的 URL 地址
nameSpace 命名空间用于 SOAP::RPC::Driver 对象的所有 RPC .
soapAction 用于 HTTP 头部的 SOAPAction 字段值。如果是字符串是"" 则默认为 nil
第二步 - 添加服务方法
为 SOAP::RPC::Driver 添加 SOAP 服务方法,我们可以通过实例 SOAP::RPC::Driver 来调用以下方法:
driver.add_method(name, *paramArg)
以下是参数的说明:
参数 描述
name 远程web服务的方法名
paramArg 指定远程程序的参数
第三步 - 调用SOAP服务
最后我们可以使用 SOAP::RPC::Driver 实例来调用 SOAP 服务:
result = driver.serviceMethod(paramArg...)
serviceMethod SOAP服务的实际方法名,paramArg为方法的参数列表。
实例
基于以上的步骤,我们可以编写以下的 SOAP 客户端:
实例
!/usr/bin/ruby -w
require 'soap/rpc/driver'
NAMESPACE = 'urn:ruby:calculation'
URL = 'http://localhost:8080/'
begin
driver = SOAP::RPC::Driver.new(URL, NAMESPACE)
Add remote sevice methods
driver.add_method('add', 'a', 'b')
Call remote service methods
puts driver.add(20, 30)
rescue => err
puts err.message
end