本指導教學顯示如何使用控管啟用設定檔來控管現有的 REST 服務,以及控制其可見性並在整個組織內使用。
您應該可以做些什麼
本指導教學結束後,您應該能夠:
- 在 WSRR 中登錄現有的 REST 服務與其 REST 服務介面,以及其端點。
- 識別及定義服務所提供的商業功能。
- 提供用以支援此現有服務版本的範圍設定及規劃資訊。
- 提供現有服務版本的完整規格,包括可由其他服務使用的服務等級定義。
- 完成服務生命週期,以確保可在各種環境中顯示並啟用服務端點。
簡介
使用 REST 來進行消費者與提供者之間的互動愈來愈普遍。市場上有許多競爭的規格可用來代表 REST。REST 模型代表與控管相關的概念,而不是任何一個規格的表示法。
WSRR 提供如何控管 REST 系統的指引,且有足夠的彈性,讓您可執行對該表示法所需執行的作業。本指導教學會檢查如何達到這個目標。
REST 以下列方式表示:
- 介面的說明 - 本說明可以使用其中一個 REST 規格的格式來詳細建模,也可以是控管文件內含的簡單文字說明。
WSRR REST 模型會實作 REST 服務介面。
- 端點表示法 - 一項 REST 服務,就像任何其他服務一樣,具有含網址的端點。這個項目的建模方式與 WSRR 中的所有其他端點相同,
因此其狀態(不管是連線或離線)都可以受控管。REST 服務可以由執行時期系統(例如,ESB)來查詢。WSRR REST 模型使用 REST 服務端點來表示這個項目。
- 實現功能版本 - 與「功能版本」可以實現為「Web 服務」或「SCA 模組」的方式相同,
其也可以由 REST 服務實現。這可讓 REST 服務在完整的控管案例中負責某個部分。
SOA 控管程序可以使用下列一種方式來啟動:
- 企業根據從上而下的服務生命週期,規劃其所需的服務。
- IT 部門發現並歸類其所使用的服務,因而控管並控制現有的服務。
在本指導教學中,我們考慮第二個選項;搜尋型錄的單一 REST 服務目前已部署在正式作業環境上,其可搜尋各種不同種類,例如書籍。「型錄搜尋」服務是由單一 XML 檔所定義,其中包括所需參數的說明。這個定義檔中沒有部署資訊,
因為該定義檔中定義的 URL 被視為實際部署 REST 服務的相對位置;這個基本可定址的位置會使用 REST 服務端點來表示。請注意,這個檔案的格式並不是其中一個現有的規格,其僅供說明使用。許多組織會以基本文字文件來定義其 REST 互動。「REST 服務介面」物件用來表示及參照這個定義檔,因為其會將與服務用戶端的互動格式加以編碼。
如果您已啟用安全,您可以對每一個角色(商業、SOA 控管、開發及作業)建立個別的使用者 ID,並使用 WSRR 安全將每一個使用者 ID 指派給其角色,來讓本指導教學更具真實性。
然後,在指導教學的每一階段因為要由不同角色來執行動作而需要變更視景時,請登出 WSRR Web 使用者介面,再以適當的使用者 ID 登入。
您可以使用 Web 使用者介面將使用者指派給角色;如需相關資訊,請參閱新增及移除角色的主體。
組成本指導教學的各項作業,分成許多循序的區段。如果您要完成所有作業,請嚴格依照顯示的順序完成這些區段;不過,您也可以練習特定的區段作為參考。