DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
XML-RPC 規範完整解析:遠端程序呼叫協定的訊息格式
編輯:XML詳解     

本規範說明了 XML-RPC 協定的實作方式,最早於 1999 年由 Dave Winer 發表,UserLand Frontier 5.1 即採用此協定。它是一份足以讓你完成 XML-RPC 實作的所有必要資訊來源。

前言

XML-RPC 是一種基於網際網路的遠端函式呼叫(RPC)協定。它的訊息都是 HTTP-POST 請求,請求主體是 XML,伺服器執行後的結果同樣以 XML 回傳。函式呼叫的參數可以是純量、數字、字串、日期,也可以是混合的記錄與結構。

請求格式

POST /RPC2 HTTP/1.0
User-Agent: Frontier/5.1.2 (WinNT)
Host: betty.userland.com
Content-Type: text/xml
Content-length: 181

<?xml version="1.0"?>
<methodCall>
  <methodName>examples.getStateName</methodName>
  <params>
    <param><value><i4>41</i4></value></param>
  </params>
</methodCall>

請求首行的 URI 格式並不特定,可為空或單一個斜線;若伺服器同時提供其他 HTTP 請求,URI 可協助推向特定的 XML-RPC 服務。User-Agent 與 Host 為必填,Content-Type 必須是 text/xml,Content-Length 也必須正確指定。

有效的格式

XML-RPC 是一個 <methodCall> 結構,必須包含字元型的 <methodName> 子元素以標示被呼叫的方法。方法名稱可由大小寫字母、數字、底線、點、冒號與斜線組成,如何解讀則由伺服器決定。若遠端呼叫接受參數,<methodCall> 就要包含 <params>,其中可含任意個 <param>,每個 <param> 再含一個 <value>。

純量值(Scalar)

值會被包在型別標籤中,支援的型別如下:

  • <i4> 或 <int>:四-byte 有號整數,例如 -12
  • <boolean>:0(false)或 1(true)
  • <string>:字串,例如 hello world
  • <double>:雙精度有號浮點數,例如 -12.214
  • <dateTime.iso8601>:日期時間,例如 19980717T14:08:55
  • <base64>:Base64 編碼的二進位

若未指定型別,預設為字串。

結構(struct)

參數值可以是 <struct>,每個 struct 含若干 <member>,每個 member 又含一個 <name> 與一個 <value>。struct 可遞迴使用,任何 value 裡都還能再放 struct 或後述的 array。

陣列(array)

<array> 簡單地含一個 <data> 元素,其中可放任何合法型別的值。array 元素沒有名稱,且可遞迴使用,其值可以是 array 或其他型別。

應答格式

<?xml version="1.0"?>
<methodResponse>
  <params>
    <param><value><string>South Dakota</string></value></param>
  </params>
</methodResponse>

除非底層作業出錯,否則一律回傳 200 OK,Content-Type 為 text/xml,Content-Length 必須正確。應答內容是單一 XML 結構;若發生錯誤,<methodResponse> 會改含一個 <fault>,其值為 struct,含值為 int 的 faultCode 與值為 string 的 faultString。<methodResponse> 不會同時含有 fault 與 params。

設計目標與常見問答

此協定的目標是在不同環境間建立相容的基礎,不提供超越 CGI 介面的新能力,讓防火牆能輕易辨識 Content-Type 為 text/xml 的 POST。它追求可被輕易發現、易於閱讀修改、也容易實作到各種環境與作業系統。

官方問答釐清了一些細節:procedure 執行成功時 params 不可省略(response 只能二擇一含 params 或 fault);boolean 是獨立型別;整數為 32 位元有號數,可帶正負號、前導零會摺疊、不允許空白;浮點數僅允許小數點表示法,無 infinity 或 NaN 表示;字串除 < 與 & 需轉義外可含任意字元,也能承載二進位;struct 不保留鍵的順序;fault 結構不可含 faultCode 與 faultString 以外的成員,且沒有全域 fault code 清單;dateTime.iso8601 不應預設時區,應由伺服器文件載明。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved