將終結點圖添加到你的ASP.NET Core應用程式中

来源:https://www.cnblogs.com/yilezhu/archive/2020/07/19/13335749.html
-Advertisement-
Play Games

在本文中,我將展示如何使用DfaGraphWriter服務在ASP.NET Core 3.0應用程式中可視化你的終結點路由。上面文章我向您演示瞭如何生成一個有向圖(如我上篇文章中所示),可以使用GraphVizOnline將其可視化。最後,我描述了應用程式生命周期中可以檢索圖形數據的點。 作者:依樂 ...


在本文中,我將展示如何使用DfaGraphWriter服務在ASP.NET Core 3.0應用程式中可視化你的終結點路由。上面文章我向您演示瞭如何生成一個有向圖(如我上篇文章中所示),可以使用GraphVizOnline將其可視化。最後,我描述了應用程式生命周期中可以檢索圖形數據的點。

作者:依樂祝

原文地址:https://www.cnblogs.com/yilezhu/p/13335749.html

譯文地址:https://andrewlock.net/adding-an-endpoint-graph-to-your-aspnetcore-application/

在本文中,我僅展示如何創建圖形的“預設”樣式。在我的下一批那文章中,我再創建一個自定義的writer來生成自定義的圖如上篇文章所示

使用DfaGraphWriter可視化您的終結點

ASP.NET Core附帶了一個方便的類DfaGraphWriter可用於可視化ASP.NET Core 3.x應用程式中的終結點路由:

public class DfaGraphWriter
{
    public void Write(EndpointDataSource dataSource, TextWriter writer);
}

此類只有一個方法WriteEndpointDataSource包含描述您的應用程式的Endpoint集合,TextWriter用於編寫DOT語言圖(如您在前一篇文章中所見)。

現在,我們將創建一個中間件,該中間件使用DfaGraphWriter將該圖編寫為HTTP響應。您可以使用DI 將DfaGraphWriterEndpointDataSource註入到構造函數中:

public class GraphEndpointMiddleware
{
    // inject required services using DI
    private readonly DfaGraphWriter _graphWriter;
    private readonly EndpointDataSource _endpointData;

    public GraphEndpointMiddleware(
        RequestDelegate next, 
        DfaGraphWriter graphWriter, 
        EndpointDataSource endpointData)
    {
        _graphWriter = graphWriter;
        _endpointData = endpointData;
    }

    public async Task Invoke(HttpContext context)
    {
        // set the response
        context.Response.StatusCode = 200;
        context.Response.ContentType = "text/plain";

        // Write the response into memory
        await using (var sw = new StringWriter())
        {
            // Write the graph
            _graphWriter.Write(_endpointData, sw);
            var graph = sw.ToString();

            // Write the graph to the response
            await context.Response.WriteAsync(graph);
        }
    }
}

這個中間件非常簡單-我們使用依賴註入將必要的服務註入到中間件中。將圖形寫入響應有點複雜:您必須在記憶體中將響應寫到一個 StringWriter,再將其轉換為 string然後將其寫到圖形。

這一切都是必要的,因為DfaGraphWriter寫入TextWriter使用同步 Stream API調用,如Write,而不是WriteAsync。如果有非同步方法,理想情況下,我們將能夠執行以下操作:

// Create a stream writer that wraps the body
await using (var sw = new StreamWriter(context.Response.Body))
{
    // write asynchronously to the stream
    await _graphWriter.WriteAsync(_endpointData, sw);
}

如果DfaGraphWriter使用了非同步API,則可以如上所述直接寫入Response.Body,而避免使用in-memory string。不幸的是,它是同步的,出於性能原因您不應該使用同步調用直接寫入Response.Body。如果您嘗試使用上面的模式,則可能會得到如下所示內容的InvalidOperationException異常,具體取決於所寫圖形的大小:

System.InvalidOperationException: Synchronous operations are disallowed. Call WriteAsync or set AllowSynchronousIO to true instead.

如果圖形很小,則可能不會出現此異常,但是如果您嘗試映射中等規模的應用程式(例如帶有Identity的預設Razor Pages應用程式),則可以看到此異常。

讓我們回到正軌上-我們現在有了一個圖形生成中間件,所以讓我們把它添加到管道中。這裡有兩個選擇:

  • 使用終結點路由將其添加為終結點。
  • 從中間件管道中將其添加為簡單的“分支”。

通常建議使用前一種方法,將終結點添加到ASP.NET Core 3.0應用程式,因此從這裡開始。

將圖形可視化器添加為終結點

為了簡化終結點註冊代碼,我將創建一個簡單的擴展方法以將GraphEndpointMiddleware作為終結點添加:

public static class GraphEndpointMiddlewareExtensions
{
    public static IEndpointConventionBuilder MapGraphVisualisation(
        this IEndpointRouteBuilder endpoints, string pattern)
    {
        var pipeline = endpoints
            .CreateApplicationBuilder()
            .UseMiddleware<GraphEndpointMiddleware>()
            .Build();

        return endpoints.Map(pattern, pipeline).WithDisplayName("Endpoint Graph");
    }
}

然後,我們可以在Startup.Configure()中的UseEndpoints()方法中調用MapGraphVisualisation("/graph")將圖形終結點添加到我們的ASP.NET Core應用程式中:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapHealthChecks("/healthz");
        endpoints.MapControllers();
        // Add the graph endpoint
        endpoints.MapGraphVisualisation("/graph");
    });
}

這就是我們要做的。該DfaGraphWriter已經在DI中可用,因此不需要額外的配置。導航至http://localhost:5000/graph將以純文本形式生成我們的終結點圖:

digraph DFA {
    0 [label="/graph/"]
    1 [label="/healthz/"]
    2 [label="/api/Values/{...}/ HTTP: GET"]
    3 [label="/api/Values/{...}/ HTTP: PUT"]
    4 [label="/api/Values/{...}/ HTTP: DELETE"]
    5 [label="/api/Values/{...}/ HTTP: *"]
    6 -> 2 [label="HTTP: GET"]
    6 -> 3 [label="HTTP: PUT"]
    6 -> 4 [label="HTTP: DELETE"]
    6 -> 5 [label="HTTP: *"]
    6 [label="/api/Values/{...}/"]
    7 [label="/api/Values/ HTTP: GET"]
    8 [label="/api/Values/ HTTP: POST"]
    9 [label="/api/Values/ HTTP: *"]
    10 -> 6 [label="/*"]
    10 -> 7 [label="HTTP: GET"]
    10 -> 8 [label="HTTP: POST"]
    10 -> 9 [label="HTTP: *"]
    10 [label="/api/Values/"]
    11 -> 10 [label="/Values"]
    11 [label="/api/"]
    12 -> 0 [label="/graph"]
    12 -> 1 [label="/healthz"]
    12 -> 11 [label="/api"]
    12 [label="/"]
}

我們可以使用GraphVizOnline進行可視化顯示如下:

一個ValuesController終結點路由應用程式

在終結點路由系統中將圖形公開為終結點具有如下優點和缺點:

  • 您可以輕鬆地向終結點添加授權。您可能不希望任何人都能查看此數據!
  • 圖形終結點顯示為系統中的終結點。這顯然是正確的,但可能會很煩人。

如果最後一點對您來說很重要,那麼您可以使用傳統的方法來創建終結點,即使用分支中間件。

將圖形可視化工具添加為中間件分支

在您進行終結點路由之前,將分支添加到中間件管道是創建“終結點”的最簡單方法之一。它在ASP.NET Core 3.0中仍然可用,它比終結點路由系統要更為,但不能輕鬆添加授權或高級路由。

要創建中間件分支,請使用Map()命令。例如,您可以使用以下命令添加分支:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // add the graph endpoint as a branch of the pipeline
    app.Map("/graph", branch => 
        branch.UseMiddleware<GraphEndpointMiddleware>());

    app.UseRouting();
    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapHealthChecks("/healthz");
        endpoints.MapControllers();
    });
}

使用此方法的優缺點在本質上與終結點路由版本相反:圖形中沒有/graph終結點,您無法輕鬆地將授權應用於此終結點!

沒有圖形終結點的ValuesController終結點路由應用程式

對我來說,像這樣公開應用程式的圖形是沒有意義的。在下一節中,我將展示如何通過小型集成測試來生成圖形。

從集成測試生成終結點圖

ASP.NET Core對於運行記憶體集成測試有很好的設計,它可以在不需要進行網路調用的情況下運行完整的中間件管道和API控制器/Razor頁面。

除了可以用來確認應用程式整體正確運行的傳統“端到端”集成測試之外,我有時還喜歡編寫“健全性檢查”測試,以確認應用程式配置正確。您可以使用,在Microsoft.AspNetCore.Mvc.Testing中暴露的底層DI容器中的WebApplicationFactory<>設施實現。這樣,您就可以在應用程式的DI上下文中運行代碼,而無需通過單元測試。

現在,讓我們來試下吧

  • 使用VS或dotnet new xunit來運行一個新的xUnit項目(我選擇的測試框架)
  • 通過運行dotnet add package Microsoft.AspNetCore.Mvc.Testing安裝Microsoft.AspNetCore.Mvc.Testing
  • 將測試項目的<Project>元素更新為<Project Sdk="Microsoft.NET.Sdk.Web">
  • 從測試項目中引用您的ASP.NET Core項目

現在,我們可以創建一個簡單的測試來生成終結點圖,並將其寫入測試輸出。在下麵的示例中,我將預設值WebApplicationFactory<>作為類基礎設施;如果您需要自定義工廠,請參閱文檔以獲取詳細信息。

除了WebApplicationFactory<>,我還註入了ITestOutputHelper。您需要使用此類來記錄xUnit的測試輸出。直接寫Console不會起作用。

public class GenerateGraphTest
    : IClassFixture<WebApplicationFactory<ApiRoutes.Startup>>
{

    // Inject the factory and the output helper
    private readonly WebApplicationFactory<ApiRoutes.Startup> _factory;
    private readonly ITestOutputHelper _output;

    public GenerateGraphTest(
        WebApplicationFactory<Startup> factory, ITestOutputHelper output)
    {
        _factory = factory;
        _output = output;
    }

    [Fact]
    public void GenerateGraph()
    {
        // fetch the required services from the root container of the app
        var graphWriter = _factory.Services.GetRequiredService<DfaGraphWriter>();
        var endpointData = _factory.Services.GetRequiredService<EndpointDataSource>();

        // build the graph as before
        using (var sw = new StringWriter())
        {
            graphWriter.Write(endpointData, sw);
            var graph = sw.ToString();

            // write the graph to the test output
            _output.WriteLine(graph);
        }
    }
}

測試的大部分內容與中間件相同,但是我們沒有編寫響應,而是編寫了xUnit的ITestOutputHelper以將記錄測試的結果輸出。在Visual Studio中,您可以通過以下方式查看此輸出:打開“測試資源管理器”,導航到GenerateGraph測試,然後單擊“為此結果打開其他輸出”,這將以選項卡的形式打開結果:

在Visual Studio中查看測試中的終結點數據

我發現像這樣的簡單測試通常足以滿足我的目的。在我看來有如下這些優點:

  • 它不會將此數據公開為終結點
  • 對您的應用沒有影響
  • 容易產生

不過,也許您想從應用程式中生成此圖,但是您不想使用到目前為止顯示的任何一種中間件方法將其包括在內。如果是這樣,請務必小心在哪裡進行。

您無法在IHostedService中生成圖形

一般而言,您可以在應用程式中任何使用依賴項註入或有權訪問實例的任何位置通過IServiceProvider訪問DfaGraphWriterEndpointDataSource服務。這意味著在請求的上下文中(例如從MVC控制器或Razor Page生成)圖很容易,並且與您到目前為止所看到的方法相同。

如果您要嘗試在應用程式生命周期的早期生成圖形,則必須小心。尤其是IHostedService

在ASP.NET Core 3.0中,Web基礎結構是在通用主機的基礎上重建的,這意味著您的伺服器(Kestrel)作為一個IHostedService在你的應用程式中運行的。在大多數情況下,這不會產生太大影響,但是與ASP.NET Core 2.x相比,它改變了應用程式的生成順序

在ASP.NET Core 2.x中,將發生以下情況:

  • 中間件管道已建立。
  • 伺服器(Kestrel)開始偵聽請求。
  • IHostedService實現啟動。

而是在ASP.NET Core 3.x上,如下所示:

  • IHostedService實現啟動。

GenericWebHostService

啟動:

  • 中間件管道已建立
  • 伺服器(Kestrel)開始偵聽請求。

需要註意的重要一點是,直到您的IHostedServices的執行後中間件管道才會建立。由於UseEndpoints()尚未被調用,EndpointDataSource將不包含任何數據!

如果您嘗試從一個IHostedService中的DfaGraphWriter生成圖表,該EndpointDataSource是空的。

如果嘗試使用其他標準機制來註入早期行為,情況也是如此,如IStartupFilter- Startup.Configure()執行之前 調用 ,因此EndpointDataSource將為空。

同樣,您不能只是在Program.Main調用IHostBuilder.Build()來構建一個Host,然後使用IHost.Services:來訪問服務,直到您調用IHost.Run,並且伺服器已啟動,否則您的終結點列表將為空!

這些限制可能不是問題,具體取決於您要實現的目標。對我來說,單元測試方法可以解決我的大多數問題。

無論使用哪種方法,都只能生成本文中顯示的“預設”終結點圖。這隱藏了很多真正有用的信息,例如哪些節點生成了終結點。在下一篇文章中,我將展示如何創建自定義圖形編寫器,以便您可以生成自己的圖形。

總結

在這篇文章中,我展示瞭如何使用DfaGraphWriterEndpointDataSource創建應用程式中所有終結點的圖形。我展示瞭如何創建中間件終結點來公開此數據,以及如何將這種中間件與分支中間件策略一起用作終結點路由。

我還展示瞭如何使用簡單的集成測試來生成圖形數據而無需運行您的應用程式。這避免了公開(可能敏感)的終結點圖,同時仍然允許輕鬆訪問數據。

最後,我討論了何時可以在應用程式的生命周期中生成圖形。該EndpointDataSource未填充,直到後Server(Kestrel)已經開始,所以你主要限於在請求上下文訪問數據。IHostedServiceIStartupFilter執行得太早以至於無法訪問數據,IHostBuilder.Build()只是構建DI容器,而沒有構建中間件管道。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • JDBC中 execute與executeUpdate的區別 execute與executeUpdate的區別 步驟 1 : 相同點 execute與executeUpdate的相同點:都可以執行增加,刪除,修改 package jdbc; import java.sql.Connection; i ...
  • 第十三章 高級引用和指針 13.1按引用傳遞以提高效率 ​ 每次將值按對象傳入函數是,都將創建該對象的一個備份。每次按值從函數返回一個對象時,也將創建其備份。 ​ 對於用戶創建的大型對象,備份的代價很高。這將增加程式占用的記憶體量,而程式的運行速度將更慢。 ​ 在棧中,用戶創建的對象的大小為其成員變數 ...
  • 在某乎上看到一個問題,《30歲學軟體測試來得及嗎?》 問題:之前一直在工廠上班,看不到希望。已經30歲了,想轉學軟體測試來得及嗎? 同樣類型的問題,還有“我是大專學歷,學軟體測試能找到工作不?”“我是女生,軟體測試學起來難麽?”每天都會遇到很多同學有這些困惑,看看測試同仁對這件事是怎麼看的? 其中有 ...
  • 學習使用的環境:Win10,Python3.6,PyCharm Community Edition ,Django 2.2.12。 創建步驟: 1)安裝創建Django項目: 打開windows命令提示符: 安裝Django庫:pip install django==2.2.12 -i https: ...
  • 上次介紹了Azure Application Insights,實現了.net core程式的監控功能。這次讓我們來看看Azure DevOps Pipeline功能。Azure DevOps Pipeline 是Azure DevOps裡面的一個組件,對於12個月試用賬號同樣永久免費。 持續集成C ...
  • 在後臺管理系統中導出Excel功能是必不可少的,該模板可以幫助我們簡單優雅的實現導出功能,支持導出大數據。封裝如下: public class NPOIExcelExporterBase { protected ICellStyle HeadStyle { get; set; } protected ...
  • 這是一個使用WinForm開發的程式,用於在電腦上播放特定的樂音,包括中央C和國際標準音。 界面如下: .NET其實非常強大。使用.NET WinForm開發還是相當高效的,值得學習。 下載:https://hovertree.com/h/bjag/mcmub5gm.htm ...
  • 可以直接用CE進行雷總數修改,下麵是通過C#直接修改雷總數記憶體地址 /// PROCESS_ALL_ACCESS -> (STANDARD_RIGHTS_REQUIRED | SYNCHRONIZE | 0xFFF) public const int PROCESS_ALL_ACCESS = (ST ...
一周排行
    -Advertisement-
    Play Games
  • 比如要拆分“呵呵呵90909086676喝喝999”,下麵當type=0返回的是中文字元串“呵呵呵,喝喝”,type=1返回的是數字字元串“90909086676,999”, private string GetStrings(string str,int type=0) { IList<strin ...
  • Swagger一個優秀的Api介面文檔生成工具。Swagger可以可以動態生成Api介面文檔,有效的降低前後端人員關於Api介面的溝通成本,促進項目高效開發。 1、使用NuGet安裝最新的包:Swashbuckle.AspNetCore。 2、編輯項目文件(NetCoreTemplate.Web.c ...
  • 2020 年 7 月 30 日, 由.NET基金會和微軟 將舉辦一個線上和為期一天的活動,包括 微軟 .NET 團隊的演講者以及社區的演講者。本次線上大會 專註.NET框架構建微服務,演講者分享構建和部署雲原生應用程式的最佳實踐、模式、提示和技巧。有關更多信息和隨時瞭解情況:https://focu... ...
  • #abp框架Excel導出——基於vue #1.技術棧 ##1.1 前端採用vue,官方提供 UI套件用的是iview ##1.2 後臺是abp——aspnetboilerplate 即abp v1,https://github.com/aspnetboilerplate/aspnetboilerp ...
  • 前言 本文的文字及圖片來源於網路,僅供學習、交流使用,不具有任何商業用途,版權歸原作者所有,如有問題請及時聯繫我們以作處理。 作者:碧茂大數據 PS:如有需要Python學習資料的小伙伴可以加下方的群去找免費管理員領取 input()輸入 Python提供了 input() 內置函數從標準輸入讀入一 ...
  • 從12年到20年,python以肉眼可見的趨勢超過了java,成為了當今It界人人皆知的編程語言。 python為什麼這麼火? 網路編程語言搜索指數 適合初學者 Python具有語法簡單、語句清晰的特點,這就讓初學者在學習階段可以把精力集中在編程對象和思維方法上。 大佬都在用 Google,YouT ...
  • 在社會上存在一種普遍的對培訓機構的學生一種歧視的現象,具體表現在,比如:當你去公司面試的時候,一旦你說了你是培訓機構出來的,那麼基本上你就涼了,那麼你瞞著不說,然後又通過了面試成功入職,但是以後一旦在公司被髮現有培訓經歷,可能會面臨被降薪,甚至被辭退,培訓機構出來的學生,在用人單位眼裡就是能力低下的 ...
  • from typing import List# 這道題看了大佬寫的代碼,經過自己的理解寫出來了。# 從最外圍的四周找有沒有為O的,如果有的話就進入深搜函數,然後深搜遍歷# 判斷上下左右的位置是否為Oclass Solution: def solve(self, board: List[List[s ...
  • import requests; import re; import os; # 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, li ...
  • import requests; import re; import os; import parsel; 1.請求網頁 header = { "user-agent":'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537. ...