什么是SOAP ?
簡(jiǎn)單對(duì)象訪問協(xié)議（SOAP）是一個(gè)跨平臺(tái)和語言無關(guān)的，基于XML的RPC協(xié)議，通常（但不一定）是HTTP。
它使用XML來編碼信息使遠(yuǎn)程過程調(diào)用，HTTP在網(wǎng)絡(luò)上從客戶機(jī)到服務(wù)器來傳輸信息，反之亦然。
SOAP有幾個(gè)優(yōu)勢(shì)超過其他技術(shù)，如COM，CORBA等為例，其相對(duì)廉價(jià)的部署和調(diào)試成本，它的可擴(kuò)展性和易于使用,存在幾種不同的語言和平臺(tái)實(shí)現(xiàn)。
請(qǐng)參閱出簡(jiǎn)單的教程了解 SOAP
本教程將熟悉SOAP實(shí)現(xiàn)Ruby（SOAP4R）。這是一個(gè)基本的教程，所以如果需要深入細(xì)節(jié)，那么需要參考其他資源。
安裝SOAP4R:
SOAP4R是由Hiroshi Nakamura編定，可以直接從網(wǎng)上下載Ruby的開發(fā)的SOAP實(shí)現(xiàn)：
注意：有可能已經(jīng)安裝了這個(gè)組件。
Download SOAP
如果知道 gem 實(shí)用工具，那么可以使用下面的命令安裝SOAP4R和相關(guān)包。
$ gem install soap4r --include-dependencies
如果是在Windows上工作，那么需要下載一個(gè)壓縮文件，從上面的位置，需要安裝它使用標(biāo)準(zhǔn)的安裝方法運(yùn)行Ruby的 install.rb.
編寫SOAP4R服務(wù)器：
SOAP4R支持兩種不同類型的服務(wù)器：
本教程將詳細(xì)編寫一個(gè)獨(dú)立的服務(wù)器。涉及編寫SOAP服務(wù)器有以下步驟：
第1步 - 繼承SOAP::RPC::StandaloneServer 類:
要實(shí)現(xiàn)自己的獨(dú)立服務(wù)器，需要編寫一個(gè)新類，這將SOAP::StandaloneServer 類的子類，如下：
注意：如果想編寫一個(gè)基于FastCGI的服務(wù)器，那么需要繼承SOAP::RPC::CGIStub 類, 其余步驟將保持相同。
第2步 - 定義處理程序方法：
第二步是編寫Web服務(wù)方法，希望向外界公開。
它們可以寫成簡(jiǎn)單的Ruby方法。例如，讓我們寫了兩個(gè)兩個(gè)兩個(gè)數(shù)相加，兩個(gè)數(shù)相除的方法：
class MyServer < SOAP::RPC::StandaloneServer ............... # Handler methods def add(a, b) return a + b end def div(a, b) return a / b endend
第3步 - 暴露處理程序方法：
下一步是我們定義的方法添加到我們的服務(wù)器。 initialize方法用于暴露服務(wù)的方法，用以下兩種方法之一：
class MyServer < SOAP::RPC::StandaloneServer def initialize(*args) add_method(receiver, methodName, *paramArg) endend
下面的參數(shù)說明：
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:
def aMeth(inParam, inoutParam) retVal = inParam + inoutParam outParam = inParam . inoutParam inoutParam = inParam * inoutParam return retVal, inoutParam, outParamend
現(xiàn)在，我們可以公開這個(gè)方法如下：
add_method(self, 'aMeth', [ %w(in inParam), %w(inout inoutParam), %w(out outParam), %w(retval return)])
第4步 - 啟動(dòng)服務(wù)器：
最后一步是通過實(shí)例的派生類的一個(gè)實(shí)例，并調(diào)用start方法來啟動(dòng)服務(wù)器。
myServer = MyServer.new('ServerName', 'urn:ruby:ServiceName', hostname, port)myServer.start這是必需的參數(shù)的描述：
例如：
現(xiàn)在使用上述步驟，讓我們寫一個(gè)獨(dú)立的服務(wù)器：
require "soap/rpc/standaloneserver"begin class MyServer < SOAP::RPC::StandaloneServer # Expose our services def initialize(*args) add_method(self, 'add', 'a', 'b') add_method(self, 'div', 'a', 'b') end # Handler methods def add(a, b) return a + b end def div(a, b) return a / b end end server = MyServer.new("MyServer", 'urn:ruby:calculation', 'localhost', 8080) trap('INT){ server.shutdown } server.startrescue => err puts err.messageend執(zhí)行時(shí)，服務(wù)器應(yīng)用程序開始一個(gè)獨(dú)立的SOAP服務(wù)在localhost上偵聽8080端口的請(qǐng)求。它暴露了一個(gè)服務(wù)方法：add 和 div ，這需要兩個(gè)參數(shù)并返回結(jié)果。
現(xiàn)在可以運(yùn)行這個(gè)服務(wù)器后臺(tái)如下：
$ ruby MyServer.rb&
編寫SOAP4R客戶端：
SOAP::RPC::Driver 類用于寫入SOAP客戶端應(yīng)用程序提供支持。本教程將介紹這個(gè)類，顯示其使用的應(yīng)用程序的基礎(chǔ)。
以下是最低要求的信息，需要調(diào)用SOAP服務(wù)：
現(xiàn)在我們將編寫一個(gè)SOAP客戶端調(diào)用服務(wù)定義的方法在上面的例子名稱為add和div。
以下是主要的步驟來創(chuàng)建一個(gè)SOAP客戶端：
步驟1 - 創(chuàng)建一個(gè)SOAP驅(qū)動(dòng)程序?qū)嵗?/strong>
我們創(chuàng)建一個(gè)實(shí)例 SOAP::RPC::Driver 通過調(diào)用 new 方法如下：
SOAP::RPC::Driver.new(endPoint, nameSpace, soapAction)
這是必需的參數(shù)的描述：
第2步 - 添加服務(wù)的方法：
要添加到SOAP SOAP服務(wù)方法到 SOAP::RPC::Driver 我們可以調(diào)用下面的方法使用 SOAP::RPC::Driver 實(shí)例:
driver.add_method(name, *paramArg)
下面的參數(shù)說明：
第3步 - 調(diào)用SOAP服務(wù)：
最后一步是調(diào)用SOAP服務(wù)使用 SOAP::RPC::Driver 實(shí)例如下:
result = driver.serviceMethod(paramArg...)
這里serviceMethod是實(shí)際的Web服務(wù)方法和paramArg...是列表參數(shù)需要通過在服務(wù)方法。
例如：
根據(jù)上述步驟，我們將編寫一個(gè)SOAP客戶端如下：
#!/usr/bin/ruby -wrequire '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.messageend新聞熱點(diǎn)
疑難解答
圖片精選
