• <sup id="mk476"></sup>
    <dl id="mk476"></dl>
  • <progress id="mk476"><tr id="mk476"></tr></progress>
    <div id="mk476"><tr id="mk476"></tr></div>
    <sup id="mk476"><ins id="mk476"></ins></sup>
  • <progress id="mk476"></progress>
    <div id="mk476"></div>
    <div id="mk476"><tr id="mk476"></tr></div>
  • <div id="mk476"></div>
    <dl id="mk476"><s id="mk476"></s></dl><dl id="mk476"></dl><div id="mk476"></div>
  • <div id="mk476"></div>
    <dl id="mk476"><ins id="mk476"></ins></dl>

    使用ASP.NET Core支持GraphQL -- 較為原始的方法

    GraphQL簡介

    下面是GraphQL的定義: 
    GraphQL 既是一種用于 API 的查詢語言也是一個滿足你數據查詢的運行時。 GraphQL 對你的 API 中的數據提供了一套易于理解的完整描述,使得客戶端能夠準確地獲得它需要的數據,而且沒有任何冗余,也讓 API 更容易地隨著時間推移而演進,還能用于構建強大的開發者工具。

    GraphQL由Facebook開發,始于2012年,2015年公開。

    GraphQL牛逼之處是它可以讓客戶端精確的查詢它們想要的,不附加額外的東西,這樣的話就很容易讓客戶端隨著API的演進去使用。

    例子

    下面是一個簡單的例子,這是一個GraphQL的查詢:

    {
      person  {
        name
        email
      }
    }

    而這個查詢的響應結果是:

    {
      "data": {
        "person": {
          "name": "Dave",
          "email": "[email protected]"
        }
      }
    }

    可以看到響應結果和查詢請求的內容結構幾乎是完全一樣的。如果你需要person其它的信息,例如parents,那么在查詢中加上這個屬性即可:

    {
      person  {
        name
        email
        parents {
          name
        }
      }
    }

    它的響應會像這樣:

    {
      "data": {
        "person": {
          "name": "Dave",
          "email": "[email protected]",
          "parents": [
            {
              "name": "Nick"
            },
            {
              "name": "AJ"
            },
            {
              "name": "Brian"
            }
          ]
        }
      }
    }

    在ASP.NET Core中支持GraphQL

    GraphQL的查詢通常會被發送到一個特定的GraphQL端點。在這個端點,會處理請求查詢并返回GraphQL對象結果。

    建立項目

    下面我們就在ASP.NET Core中實現這個功能,首先建立項目: 
    使用dotnet cli 在命令行輸入:

    dotnet new web --name graph

    這樣會建立一個ASP.NET Core 的空項目。項目結構如圖: 
    圖片描述

    建立Model

    然后建立一個Person 的Model: 
    圖片描述

    建立Repository

    下面建立用于查詢Person的Repository,首先是接口: 
    圖片描述

    然后是具體的Repository,里面帶有一些寫死的數據: 
    圖片描述

    添加GraphQL庫

    通過dotnet cli添加GraphQL這個庫:

    dotnet add package GraphQL

    安裝成功后,在項目文件里會有顯示: 
    圖片描述

    建立GraphQL中間件

    首先我需要一個GraphQL特定的Person類型類,它要包含映射到Person類的字段: 
    圖片描述
    該類需要繼承于ObjectGraphType< Person>。

    然后我還需要一個查詢類,它里面包含對GraphQL實現的細節: 
    圖片描述
    該類需要繼承于 ObjectGraphType。在這里,我把所有請求查詢的字段映射到了PersonRepository的調用上。

    最后是中間件: 
    圖片描述
    圖片描述
    該類的意思就是,當請求地址是"/graphql"開頭時,就會嘗試讀取請求的body。然后建立一個Schema對象,它的query字段的值就是PersonQuery的實例,而PersonQuery的實例又需要PersonRepository作為參數。 
    最后建立一個DocumentExecuter來對這個schema進行查詢,結果以JSON格式返回。

    注冊Repository,使用中間件

    別忘了在Startup.cs里注冊Repository和在管道里調用我們的中間件: 
    圖片描述

    測試

    運行ASP.NET Core項目:

    dotnet watch run

    圖片描述

    打開POSTMAN,首先按id查詢一個Person: 
    圖片描述
    Cool,沒問題。

    再來一個帶Parents的查詢: 
    圖片描述

    最后再查詢所有的Person吧: 
    圖片描述

    注意這里的查詢寫的是persons而不是person,這個要和PersonQuery類里面的定義一致。

    結語

    這只不過是使用ASP.NET Core支持GraphQL的一個原始手動實現而已。 具體請看graphql-dotnet:https://github.com/graphql-dotnet/graphql-dotnet。 

     

    posted @ 2018-09-23 07:27 solenovex 閱讀(...) 評論(...) 編輯 收藏
    江苏11选5软件