萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Ruby SOAP4R 實作 SOAP Server 與 Client 完整教學

SOAP(Simple Object Access Protocol)是跨平台、語言中立的 XML 型 RPC 協定。Ruby SOAP4R 函式庫支援建立獨立或 CGI/FastCGI 型 SOAP Server,以及 Client 呼叫。本文詳細說明 Server 繼承、方法暴露、啟動流程,以及 Client 驅動建立與呼叫步驟。

安裝 SOAP4R

gem install soap4r --include-dependencies

撰寫獨立 SOAP Server

  1. 繼承 SOAP::RPC::StandaloneServer
  2. 定義處理方法(如 add, div)
  3. 在 initialize 中用 add_method 暴露方法
  4. 實例化並呼叫 start
require "soap/rpc/standaloneserver"

class MyServer < SOAP::RPC::StandaloneServer
  def initialize(*args)
    super
    add_method(self, 'add', 'a', 'b')
    add_method(self, 'div', 'a', 'b')
  end

  def add(a, b); a + b; end
  def div(a, b); a / b; end
end

server = MyServer.new("MyServer", 'urn:ruby:calculation', 'localhost', 8080)
trap('INT') { server.shutdown }
server.start

啟動 Server

ruby MyServer.rb &

撰寫 SOAP Client

  1. 建立 SOAP::RPC::Driver 實例
  2. 用 add_method 加入遠端方法
  3. 直接呼叫方法
require 'soap/rpc/driver'

driver = SOAP::RPC::Driver.new('https://localhost:8080/', 'urn:ruby:calculation')
driver.add_method('add', 'a', 'b')
driver.add_method('div', 'a', 'b')

puts driver.add(5, 3)   # => 8
puts driver.div(10, 2)  # => 5

參數模式說明

add_method 參數模式:%w(in param)、%w(inout param)、%w(out param)、%w(retval return),支援輸入/輸出/輸入輸出/回傳值。

注意: SOAP4R 已停止維護,現代專案建議使用 REST/JSON API 或 savon、handsoap 等較新的 SOAP 函式庫。

copyright © 萬盛學電腦網 all rights reserved