《系統(tǒng)對(duì)接設(shè)計(jì)》word版-文庫吧
2025-05-14 06:30 本頁面
【正文】 務(wù)提供者可通過版本區(qū)別同時(shí)支持多個(gè)版本的客戶端，從而使得組件服務(wù)的提供者和使用者根據(jù)實(shí)際的需要，獨(dú)立演進(jìn)，降低系統(tǒng)升級(jí)的復(fù)雜度，保證系 統(tǒng)具備靈活的擴(kuò)展和持續(xù)演進(jìn)的能力。 業(yè)務(wù)消息約定 請(qǐng)求消息 URI 中的參數(shù)采用 UTF8 編碼并經(jīng)過 URLEncode 編碼。 請(qǐng)求接口 URL 格式： {|}://{host}:{port}/ {app name}/{business ponent name}/{action} ；其中： ? 協(xié)議： HTTP REST 形式接口 ? host：應(yīng)用支撐平臺(tái)交互通信服務(wù)的 IP 地址或域名 TCP/IP底 層 承 載HTTP/HTTPS會(huì) 話 數(shù) 據(jù)業(yè) 務(wù) 消 息 ? port：應(yīng)用支撐平臺(tái)交互通信服務(wù)的端口 ? app name：應(yīng)用支撐平臺(tái)交互通信服務(wù)部署的應(yīng)用名稱 ? business ponent name：業(yè)務(wù)組件名稱 ? action：業(yè)務(wù)操作請(qǐng)求的接口名稱，接口名字可配置 應(yīng)答的消息體采用 JSON 數(shù)據(jù)格式編碼，字符編碼采用 UTF8。 應(yīng)答消息根節(jié)點(diǎn)為“ response”，每個(gè)響應(yīng)包含固定的兩個(gè)屬性節(jié)點(diǎn)：“ status”和“ message”。它們分別表示操作的返回值和返回消息描述，其他的同級(jí)子節(jié)點(diǎn)為業(yè)務(wù)返回對(duì)象屬性，根據(jù)業(yè)務(wù)類型的不同，有不同的屬性名稱。 當(dāng)客戶端支持?jǐn)?shù)據(jù)壓縮傳輸時(shí)，需要在請(qǐng)求的消息頭的“ AcceptEncoding”字段中指定壓縮方式 (gzip)，如消息可以被壓縮 傳輸則平臺(tái)將應(yīng)答的數(shù)據(jù)報(bào)文進(jìn)行壓縮作為應(yīng)答數(shù)據(jù)返回， ContentLength 為壓縮后的數(shù)據(jù)長(zhǎng)度。詳細(xì)參見HTTP/ RFC2616。 響應(yīng)碼規(guī)則約定 響應(yīng)結(jié)果碼在響應(yīng)消息的“ status”屬性中，相應(yīng)的解釋信息在響應(yīng)消息的“ message”屬性中。解釋消息為終端用戶可讀的消息，終端應(yīng)用不需要解析可直接呈現(xiàn)給最終用戶。響應(yīng)結(jié)果碼為 6 位數(shù)字串。根據(jù)響應(yīng)類型，包括以下幾類響應(yīng)碼。如表 41 中的定義。 表 41 響應(yīng)碼對(duì)應(yīng)表 響應(yīng)碼 描述 0 成功 1XXXXX 系統(tǒng)錯(cuò)誤 2XXXXX 輸入?yún)?shù)不合法錯(cuò)誤 3XXXXX 應(yīng)用級(jí)返回碼，定義應(yīng)用級(jí)的異常返回。 4XXXXX 正常的應(yīng)用級(jí)返回碼，定義特定場(chǎng)景的應(yīng)用級(jí)返回說明。 數(shù)據(jù)管理 業(yè)務(wù)數(shù)據(jù)檢查 接口應(yīng)提供業(yè)務(wù)數(shù)據(jù)檢查功能，即對(duì)接收的數(shù)據(jù)進(jìn)行合法性檢查，對(duì)非法數(shù) 據(jù)和錯(cuò)誤數(shù)據(jù)則拒絕接收，以防止外來數(shù)據(jù)非法入侵，減輕應(yīng)用支撐平臺(tái)系統(tǒng)主機(jī)處理負(fù)荷。 對(duì)于接口，其業(yè)務(wù)數(shù)據(jù)檢查的主要內(nèi)容有以下幾個(gè)方面： ? 數(shù)據(jù)格式的合法性：如接收到非預(yù)期格式的數(shù)據(jù)。包括接收的數(shù)據(jù)長(zhǎng)度，類型，開始結(jié)束標(biāo)志等
畢業(yè)設(shè)計(jì)相關(guān)推薦
鄂ICP備17016276號(hào)-1