ASP.NET Core使用GraphQL第二章之中間件

更新時(shí)間：2018年11月06日 10:13:31 作者：LamondLu

這篇文章主要給大家介紹了關(guān)于ASP.NET Core使用GraphQL第二章之中間件的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

前言

在開始本文之前，對(duì)GraphQL不熟悉的朋友們，可以看下下面這篇文章：

前文：ASP.NET Core中使用GraphQL - 第一章 Hello World

看完上面的文章，下面話不多說了，來一起看看詳細(xì)的介紹吧

中間件

如果你熟悉ASP.NET Core的中間件，你可能會(huì)注意到之前的博客中我們已經(jīng)使用了一個(gè)中間件，

app.Run(async (context) =>
{
 var result = await new DocumentExecuter()
 .ExecuteAsync(doc =>
 {
 doc.Schema = schema;
 doc.Query = @"
 query {
  hello
 }
 ";
 }).ConfigureAwait(false);

 var json = new DocumentWriter(indent: true)
 .Write(result)
 await context.Response.WriteAsync(json);
});

這個(gè)中間件負(fù)責(zé)輸出了當(dāng)前查詢的結(jié)果。

中間件的定義：

中間件是裝載在應(yīng)用程序管道中的組件，負(fù)責(zé)處理請(qǐng)求和響應(yīng)，每一個(gè)中間件

可以選擇是否傳遞請(qǐng)求到應(yīng)用程序管道中的下一個(gè)組件
可以在應(yīng)用程序管道中下一個(gè)組件運(yùn)行前和運(yùn)行后進(jìn)行一些操作

來源： Microsoft Documentation

實(shí)際上中間件是一個(gè)委托，或者更精確的說是一個(gè)請(qǐng)求委托(Request Delegate)。正如他的名字一樣，中間件會(huì)處理請(qǐng)求，并決定是否將他委托到應(yīng)用程序管道中的下一個(gè)中間件中。在我們前面的例子中，我們使用IApplicationBuilder類的Run()方法配置了一個(gè)請(qǐng)求委托。

使用動(dòng)態(tài)查詢體替換硬編碼查詢體

在我們之前的例子中，中間件中的代碼非常簡單，它僅是返回了一個(gè)固定查詢的結(jié)果。然而在現(xiàn)實(shí)場景中，查詢應(yīng)該是動(dòng)態(tài)的，因此我們必須從請(qǐng)求中讀取查詢體。

在服務(wù)器端，每一個(gè)請(qǐng)求委托都可以接受一個(gè)HttpContext參數(shù)。如果一個(gè)查詢體是通過POST請(qǐng)求發(fā)送到服務(wù)器的，你可以很容易的使用如下代碼獲取到請(qǐng)求體中的內(nèi)容。

string body; 
using (var streamReader = new StreamReader(httpContext.Request.Body)) 
{
 body = await streamReader.ReadToEndAsync();
}

在獲取請(qǐng)求體內(nèi)容之前，為了不引起任何問題，我們需要先檢測一些當(dāng)前請(qǐng)求

是否是一個(gè)POST請(qǐng)求
是否使用了特定的Url, 例如 /api/graphql

因此我們需要對(duì)代碼進(jìn)行調(diào)整。

if(context.Request.Path.StartsWithSegments("/api/graphql") 
 && string.Equals(context.Request.Method, 
   "POST", 
   StringComparison.OrdinalIgnoreCase)) 
{
 string body;
 using (var streamReader = new StreamReader(context.Request.Body))
 {
 body = await streamReader.ReadToEndAsync();
 }

....
....
....

一個(gè)請(qǐng)求體可以包含很多字段，這里我們約定傳入graphql查詢體字段名稱是query。因此我們可以將請(qǐng)求體中的JSON字符串轉(zhuǎn)換成一個(gè)包含Query屬性的復(fù)雜類型。

這個(gè)復(fù)雜類型代碼如下：

public class GraphQLRequest
{
 public string Query { get; set; }
}

下一步我們要做的就是，反序列化當(dāng)前請(qǐng)求體的內(nèi)容為一個(gè)GraphQLRequest類型的實(shí)例。這里我們需要使用Json.Net中的靜態(tài)方法JsonConvert.DeserializeObjct來替換之前的硬編碼的查詢體。

var request = JsonConvert.DeserializeObject<GraphQLRequest>(body);

var result = await new DocumentExecuter().ExecuteAsync(doc =>
{
 doc.Schema = schema;
 doc.Query = request.Query;
}).ConfigureAwait(false);

在完成以上修改之后，Startup.cs文件的Run方法應(yīng)該是這個(gè)樣子的。

app.Run(async (context) =>
{
 if (context.Request.Path.StartsWithSegments("/api/graphql")
 && string.Equals(context.Request.Method, 
    "POST", 
    StringComparison.OrdinalIgnoreCase))
 {
 string body;
 using (var streamReader = new StreamReader(context.Request.Body))
 {
  body = await streamReader.ReadToEndAsync();

  var request = JsonConvert.DeserializeObject<GraphQLRequest>(body);
  var schema = new Schema { Query = new HelloWorldQuery() };

  var result = await new DocumentExecuter()
  .ExecuteAsync(doc =>
  {
  doc.Schema = schema;
  doc.Query = request.Query;
  }).ConfigureAwait(false);

  var json = new DocumentWriter(indent: true)
  .Write(result);
  await context.Response.WriteAsync(json);
 }
 }
});

最終效果

現(xiàn)在我們可以使用POSTMAN來創(chuàng)建一個(gè)POST請(qǐng)求, 請(qǐng)求結(jié)果如下：