當(dāng)創(chuàng)建web服務(wù)應(yīng)用程序時(shí),可以選擇使用REST或GraphQL作為通信模式。兩者都可能在HTTP上使用JSON,但有不同的優(yōu)點(diǎn)和缺點(diǎn)。
(資料圖片)
本文主要比較GraphQL和REST,以操作一個(gè)產(chǎn)品數(shù)據(jù)庫(kù)示例,比較兩種解決方案在執(zhí)行相同的客戶端操作時(shí)的差異:
創(chuàng)建處于草稿狀態(tài)的產(chǎn)品更新產(chǎn)品詳細(xì)信息獲取產(chǎn)品列表獲取單個(gè)產(chǎn)品及其訂單的詳細(xì)信息RESTREST(Representational State Transfer,代表性狀態(tài)傳輸)的主要數(shù)據(jù)元素稱為Resource。在本例中,資源是“產(chǎn)品”。
創(chuàng)建產(chǎn)品curl --request POST "http://localhost:8081/product" \--header "Content-Type: application/json" \--data "{ "name": "Watch", "description": "Special Swiss Watch", "status": "Draft", "currency": "USD", "price": null, "imageUrls": null, "videoUrls": null, "stock": null, "averageRating": null}"更新產(chǎn)品
curl --request PUT "http://localhost:8081/product/{product-id}" \--header "Content-Type: application/json" \--data "{ "name": "Watch", "description": "Special Swiss Watch", "status": "Draft", "currency": "USD", "price": 1200.0, "imageUrls": [ "https://graphqlvsrest.com/imageurl/product-id" ], "videoUrls": [ "https://graphqlvsrest.com/videourl/product-id" ], "stock": 10, "averageRating": 0.0}"獲取產(chǎn)品列表
curl --request GET "http://localhost:8081/product?size=10&page=0"
{ "id": 1, "name": "T-Shirt", "description": "Special beach T-Shirt", "status": Published, "currency": "USD", "price": 30.0, "imageUrls": ["https://graphqlvsrest.com/imageurl/1"], "videoUrls": ["https://graphqlvsrest.com/videourl/1"], "stock": 10, "averageRating": 3.5 }通過(guò)訂單獲取單個(gè)產(chǎn)品
要獲取產(chǎn)品及其訂單,通常需要先調(diào)用產(chǎn)品列表API,然后調(diào)用訂單資源以查找相關(guān)訂單:
curl --request GET "localhost:8081/order?product-id=1"
{ "id": 1, "productId": 1, "customerId": "de68a771-2fcc-4e6b-a05d-e30a8dd0d756", "status": "Delivered", "address": "43-F 12th Street", "creationDate": "Mon Jan 17 01:00:18 GST 2022"}
除了獲取所有產(chǎn)品的原始操作外,還需要對(duì)每個(gè)感興趣的產(chǎn)品執(zhí)行一次此操作,這會(huì)產(chǎn)生N+1的相關(guān)問(wèn)題。
GraphQLGraphQL API操作包含Queries和Mutations。Queries負(fù)責(zé)獲取數(shù)據(jù),Mutations用于創(chuàng)建和更新。
Queries和Mutations的Schema模式定義了客戶端可能的請(qǐng)求和響應(yīng)。
創(chuàng)建產(chǎn)品curl --request POST "http://localhost:8081/graphql" \--header "Content-Type: application/json" \--data \"{ "query": "mutation {saveProduct ( product: { name: \"Bed-Side Lamp\", price: 24.0, status: \"Draft\", currency: \"USD\" }){ id name currency price status} }"}"
{ "data": { "saveProduct": { "id": "12", "name": "Bed-Side Lamp", "currency": "USD", "price": 24.0, "status": "Draft" } }}更新產(chǎn)品
curl --request POST "http://localhost:8081/graphql" \--header "Content-Type: application/json" \--data \"{"query": "mutation {updateProduct( id: 11 product: { price: 14.0, status: \"Publish\" }){ id name currency price status } }","variables":{}}"
{ "data": { "updateProduct": { "id": "12", "name": "Bed-Side Lamp", "currency": "USD", "price": 14.0, "status": "Published" } }}獲取產(chǎn)品列表
curl --request POST "http://localhost:8081/graphql" \--header "Content-Type: application/json" \--data \"{ "query": "query {products(size:10,page:0){id name status}}"}"
{ "data": { "products": [ { "id": "1", "name": "T-Shirt", "status": "Published" }, ... ] }}通過(guò)訂單獲取單個(gè)產(chǎn)品
curl --request POST "http://localhost:8081/graphql" \--header "Content-Type: application/json" \--data \"{ "query": "query {product(id:1){ id name orders{customerId address status creationDate}}}"}"
{ "data": { "product": { "id": "1", "name": "T-Shirt", "orders": [ { "customerId": "de68a771-2fcc-4e6b-a05d-e30a8dd0d756", "status": "Delivered", "address": "43-F 12th Street", "creationDate": "Mon Jan 17 01:00:18 GST 2022" }, ... ] } }}GraphQL優(yōu)勢(shì)
GraphQL允許靈活和動(dòng)態(tài)的查詢:
客戶端只能請(qǐng)求Schema已定義的字段支持別名用于請(qǐng)求具有自定義鍵值的字段客戶端可以使用查詢來(lái)管理返回結(jié)果的順序客戶端可以更好地與API中的任何更改解耦GraphQL傾向于避免昂貴的操作,通常可以使用GraphQL在一個(gè)請(qǐng)求中獲取所需的所有數(shù)據(jù)。
何時(shí)使用RESTGraphQL不能替代REST。在以下情況下,可能更適合使用REST:
應(yīng)用程序是資源驅(qū)動(dòng)的,其中的操作與各個(gè)資源實(shí)體非常直接和完全地聯(lián)系在一起需要web緩存,因?yàn)镚raphQL本身并不支持需要文件上傳,因?yàn)镚raphQL本身并不支持結(jié)論選擇使用REST或GraphQL作為通信模式,需要由業(yè)務(wù)場(chǎng)景決定。GraphQL靈活性也決定了其一定程度上的復(fù)雜性。
使用GraphQL也需要考慮在應(yīng)用層面的緩存優(yōu)化,和解決N+1問(wèn)題的批量操作優(yōu)化。
關(guān)鍵詞:
X 關(guān)閉
X 關(guān)閉
- 泉港涂嶺:文旅嘉年華 枇杷迎客來(lái)
- 承重柱開(kāi)裂、鋼筋裸露!泉州德化一新樓盤(pán)讓業(yè)主心憂 焦點(diǎn)觀察
- 當(dāng)前通訊!福建省出臺(tái)“糧九條”扶持糧油生產(chǎn)
- 趙龍會(huì)見(jiàn)阿根廷卡塔馬卡省省長(zhǎng)勞爾·賈利爾_今日關(guān)注
- 【全球報(bào)資訊】福建省14項(xiàng)舉措強(qiáng)化個(gè)體工商戶金融服務(wù)
- 環(huán)球動(dòng)態(tài):福建省商貿(mào)貸外貿(mào)貸累計(jì)放款突破20億元
- 頭條:漳州財(cái)政收入實(shí)現(xiàn)首季“開(kāi)門(mén)紅”
- 15G資費(fèi)不大降!三大運(yùn)營(yíng)商誰(shuí)提供的5G網(wǎng)速最快?中國(guó)信通院給出答案
- 2聯(lián)想拯救者Y70發(fā)布最新預(yù)告:售價(jià)2970元起 迄今最便宜的驍龍8+旗艦
- 3亞馬遜開(kāi)始大規(guī)模推廣掌紋支付技術(shù) 顧客可使用“揮手付”結(jié)賬
- 4現(xiàn)代和起亞上半年出口20萬(wàn)輛新能源汽車(chē)同比增長(zhǎng)30.6%
- 5如何讓居民5分鐘使用到各種設(shè)施?沙特“線性城市”來(lái)了
- 6AMD實(shí)現(xiàn)連續(xù)8個(gè)季度的增長(zhǎng) 季度營(yíng)收首次突破60億美元利潤(rùn)更是翻倍
- 7轉(zhuǎn)轉(zhuǎn)集團(tuán)發(fā)布2022年二季度手機(jī)行情報(bào)告:二手市場(chǎng)“飄香”
- 8充電寶100Wh等于多少毫安?鐵路旅客禁止、限制攜帶和托運(yùn)物品目錄
- 9好消息!京東與騰訊續(xù)簽三年戰(zhàn)略合作協(xié)議 加強(qiáng)技術(shù)創(chuàng)新與供應(yīng)鏈服務(wù)
- 10名創(chuàng)優(yōu)品擬通過(guò)香港IPO全球發(fā)售4100萬(wàn)股 全球發(fā)售所得款項(xiàng)有什么用處?