Jimmy Bogard在他的一系列博客帖子中表示：REST是一種定義良好的架構(gòu)風(fēng)格，它能夠?yàn)槲覀儙碓S多益處，但也經(jīng)常被誤用于描述各種各樣的Web API。他特別著重描述了實(shí)現(xiàn)一個(gè)從服務(wù)器到客戶端的端到端超媒體解決方案所必需的步驟，包括如何選擇一種富超媒體的媒體類型（media type）。

\\

Bogard是一位微軟的MVP，他強(qiáng)調(diào)說，REST以及超媒體這種REST的約束會(huì)大大提高客戶端與服務(wù)端API設(shè)計(jì)的復(fù)雜性。他認(rèn)為只有在某些場(chǎng)景中才值得這么做，尤其是在客戶端與服務(wù)端分別獨(dú)立進(jìn)行設(shè)計(jì)的情況下。如果客戶端與服務(wù)端代碼共存于一個(gè)源代碼控制庫，并且還是同時(shí)進(jìn)行部署的，那么超媒體在這種情況下為他提供不了多少價(jià)值。

\\

至于如何選擇一種媒體類型，Bogard認(rèn)為有這么三種選擇：

\\

• 選擇某個(gè)現(xiàn)有標(biāo)準(zhǔn)。 \\
• 對(duì)某個(gè)現(xiàn)有標(biāo)準(zhǔn)進(jìn)行擴(kuò)展。 \\
• 設(shè)計(jì)屬于自己的媒體類型。 \

考慮到設(shè)計(jì)一種媒體類型所需的精力，這已遠(yuǎn)不是在一個(gè)項(xiàng)目中就能夠完成的工作了，因此他傾向于盡可能選擇一種標(biāo)準(zhǔn)的媒體類型。在對(duì)不同的媒體類型的能力進(jìn)行比較時(shí)，他提到了Mike Amundsen所設(shè)計(jì)的H Factor，這項(xiàng)工具能夠衡量某個(gè)媒體類型對(duì)于超媒體的支持等級(jí)，幫助他做出適合于當(dāng)前場(chǎng)景的最佳選擇。不過，他往往發(fā)現(xiàn)所選擇的媒體類型無法滿足他的所有需求，因此不得不對(duì)所缺失的部分進(jìn)行擴(kuò)展。

\\

Bogard認(rèn)為服務(wù)端的設(shè)計(jì)與實(shí)現(xiàn)是非常直觀的，這與創(chuàng)建一個(gè)純粹的JSON API差別不大，只是增加了一個(gè)更豐富的超媒體模型的復(fù)雜性。通常來說，包含所選擇的媒體類型的API在實(shí)現(xiàn)之后還要接受調(diào)用者的檢驗(yàn)，從客戶端的角度對(duì)其進(jìn)行驗(yàn)收。

\\

至于客戶端方面，Bogard在文中提到，他所見到的大多數(shù)REST示例雖然包含了服務(wù)端的API，但往往未能提供實(shí)際的實(shí)例，使客戶端了解如何調(diào)用它們。在Bogard的示例中，他創(chuàng)建了一個(gè)web客戶端，其中包含了一個(gè)基本的導(dǎo)航視圖。 視圖中包括了一些信息表，用戶可通過這些信息配合在服務(wù)端響應(yīng)中所包含的關(guān)系與鏈接查看詳細(xì)的內(nèi)容。服務(wù)端返回的響應(yīng)中包括了大量的元數(shù)據(jù)，為了保持REST風(fēng)格所提供的松耦合能力，客戶端必須由這些元數(shù)據(jù)所驅(qū)動(dòng)。但Bogard依然認(rèn)為，客戶端應(yīng)當(dāng)為某個(gè)特定的目的而設(shè)計(jì)，要打造一個(gè)泛用目的的客戶端是非常無趣的。除了使用jQuery設(shè)計(jì)客戶端之外，他還描述了如何使用React設(shè)計(jì)并實(shí)現(xiàn)客戶端，由于React帶有面向組件的特性，因此在Bogard看來，它能夠非常完美地配合超媒體的使用。

\\

查看英文原文：Design of a Hypermedia REST API Server and Consuming Client

總結(jié)

以上是生活随笔為你收集整理的端到端的超媒体REST API设计的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。