这是系列文章中的第一篇：使用GraphvizOnline可视化ASP.NETCore3.0终结点。.
- 第1部分-使用DOT语言来可视化你的ASP.NETCore3.0终结点(本文)
- 第2部分-向ASP.NET Core应用程序添加终结点图
- 第3部分-使用ImpromptuInterface创建一个自定义的DfaGraphWriter，以便于反射
作者：依乐祝
原文：https://andrewlock.net/visualizing-asp-net-core-endpoints-using-graphvizonline-and-the-dot-language/
译文：https://www.cnblogs.com/yilezhu/p/13301981.html
在这篇文章中，我将展示如何在ASP.NETCore3.0应用程序中使用GraphvizOnline服务。这使您可以创建如下所示的图表，这些图表描述了应用程序中的所有端点：
用GraphvizOnline和DOT语言绘制图形
GraphvizOnline是一个GitHub上的开源项目，它为DOT图形描述语言 提供了一个在线可视化工具。这是一种简单的语言，它允许您定义各种类型的图形，它将节点与边连接起来。
例如，一个基本的无向图可以定义为
graph MyGraph {
a -- b -- c;
b -- d;
}
它描述了以下图表：
每个节点都有一个名称(
a
,
b
c
d
)，并且
--
定义节点之间的边缘。边定义节点之间的连接，但它们没有方向(因此名称，无向【undirected】).
当然，你也可以定义一个有向图，其中边是有方向的。对于有向边，使用
->
而不是
--
。例如：
digraph MyGraph {
a -> b -> c;
b -> d;
}
您可以自定义节点和边缘以多种方式显示的方式。例如，可以标记节点和边缘：
digraph MySimpleGraph {
// The label attribute can be used to change the label of a node...
a [label="Foo"];
b [label="Bar"];
// ... or an edge
a -> b [label="Baz"];
}
你可以使用DOT图形描述语言做更多的事情，这正是我们现在所需要的。那么，这如何应用于ASP.NET Core应用程序呢？
使用有向图来可视化ASP.NET Core终结点
ASP.NETCore中的终结点路由系统通过创建端点URL段的有向图来有效地工作。然后将传入的请求与图进行匹配（一次一个段），以确定要执行的终结点。
例如，以下简单有向图表示ASP.NET Core3.0 RazorPages 默认应用程序模板中的终结点(
dotnet new webapp
)，其中包含三个Razor页面：Index.cshtml, Error.cshtml和Privacy.cshtml:
digraph DFA {
1 [label="/Error/"]
2 [label="/Index/"]
3 [label="/Privacy/"]
4 -> 1 [label="/Error"]
4 -> 2 [label="/Index"]
4 -> 3 [label="/Privacy"]
4 [label="/"]
}
其中描述为如下图表：
.
在上面的DOT文件中，节点被赋予顺序的整数名，1
2
等，并使用端点名称进行标记。这是ASP.NET Core用于表示终结点图的格式。3
对于Razor页面，路由非常简单，所以图非常明显。ASP.NET Core WebAPI应用程序生成了一个更有趣的图表。例如，下面显示的ASP.NET Core 2.0默认模板中包含的
ValuesController
。它使用多个HTTP谓词，以及稍微复杂的URL结构：
[Route("api/[controller]")]
[ApiController]
public class ValuesController : ControllerBase
{
// GET api/values
[HttpGet]
public ActionResult<IEnumerable<string>> Get() => new string[] { "value1", "value2" };
// GET api/values/5
[HttpGet("{id}")]
public ActionResult<string> Get(int id) => "value";
// POST api/values
[HttpPost]
public void Post([FromBody] string value) { }
// PUT api/values/5
[HttpPut("{id}")]
public void Put(int id, [FromBody] string value) { }
// DELETE api/values/5
[HttpDelete("{id}")]
public void Delete(int id) { }
}
为了更好地度量，我还添加了一个基本的健康检查端点。
UseEndpoints()
:
app.UseEndpoints(endpoints =>
{
endpoints.MapHealthChecks("/healthz");
endpoints.MapControllers();
});
此应用程序生成以下图表：
digraph DFA {
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 -> 1 [label="/healthz"]
12 -> 11 [label="/api"]
12 [label="/"]
}
表现为如下图表：
在这个图中还有很多事情要做，因为我们现在有了可变的路由参数值(路由模板中的
{id}
，在图中显示为
{...}
)和HTTP动词约束(
GET
/
PUT
POST
等等)
当我第一次看到这个图表时，我很难理解它。每个节点都是终结点吗？当然不是，如
/api/
不应该产生响应。那这个呢？至于
HTTP: *
端点呢，它们会产生响应吗？
为了进一步了解，我查阅了可以生成这些图的ASP.NET Core中的代码，但它有点复杂，不幸的是，由于大量使用 internal
为了更好地理解端点图，我们需要了解并非所有的节点都是相同的。在下一节中，我们将深入研究这个简单图中的不同类型的节点，然后研究一个更好的图形表示（至少在我看来！）
了解不同类型的节点。
图中的每个节点都与给定的“深度”相关联。这是应该已经匹配的URL段数。例如，
/api/Values/
节点的深度为2-它要求空段
/
和
/api
段已经匹配。
当请求到达
EndpointRoutingMiddleware
(由
UseRouting()
添加)时，将传入的请求URL与此图进行比较。试图从树梢的根节点开始，通过图表找到一条路径。URL段与图中的边进行增量匹配，并在图中遍历一条路径，直到整个请求URL匹配为止。
每个节点(由在ASP.NET Core中的
DfaNode
中)有几个属性。我们目前感兴趣的属性是：
-
Matches
Endpoint
Endpoint
-
Literals
DfaNode
Literals
/api/
/Values
Literal
/api/Values
-
PolicyEdges
HTTP: GET
DfaNode
-
Parameters
{id}
Parameters
/*
还有一个附加的属性， CatchAll
基于这些特性，我们可以通过使用DOT语言的其他特性，如形状、颜色、线型和箭头：
上图中添加了以下内容：
- 没有任何关联的节点
Endpoint
-
Matches
Endpoint
- 文字段边缘显示为默认的黑色边缘，带有一个填充箭头。
-
Parameters
/*
-
PolicyEdges
现在，我承认我的设计技巧很烂，但是我认为您可以同意这个图表显示的信息比默认的要多！🙂--这是生成上面的图形的定义，请记住，您可以使用在线编辑来可视化和播放显示。
digraph DFA {
1 [label="/healthz/" shape=box style=filled color="brown" fontcolor="white"]
2 [label="/api/Values/{...}/ HTTP: GET" shape=box style=filled color="brown" fontcolor="white"]
3 [label="/api/Values/{...}/ HTTP: PUT" shape=box style=filled color="brown" fontcolor="white"]
4 [label="/api/Values/{...}/ HTTP: DELETE" shape=box style=filled color="brown" fontcolor="white"]
5 [label="/api/Values/{...}/ HTTP: *" shape=box style=filled color="brown" fontcolor="white"]
6 -> 2 [label="HTTP: GET" color="red" style=dashed arrowhead=open]
6 -> 3 [label="HTTP: PUT" color="red" style=dashed arrowhead=open]
6 -> 4 [label="HTTP: DELETE" color="red" style=dashed arrowhead=open]
6 -> 5 [label="HTTP: *" color="red" style=dashed arrowhead=open]
6 [label="/api/Values/{...}/"]
7 [label="/api/Values/ HTTP: GET" shape=box style=filled color="brown" fontcolor="white"]
8 [label="/api/Values/ HTTP: POST" shape=box style=filled color="brown" fontcolor="white"]
9 [label="/api/Values/ HTTP: *" shape=box style=filled color="brown" fontcolor="white"]
10 -> 6 [label="/*" arrowhead=diamond color="blue"]
10 -> 7 [label="HTTP: GET" color="red" style=dashed arrowhead=open]
10 -> 8 [label="HTTP: POST" color="red" style=dashed arrowhead=open]
10 -> 9 [label="HTTP: *" color="red" style=dashed arrowhead=open]
10 [label="/api/Values/"]
11 -> 10 [label="/Values"]
11 [label="/api/"]
12 -> 1 [label="/healthz"]
12 -> 11 [label="/api"]
12 [label="/"]
}
注意节点与端点关联，即使您可能不期望它，因为它们返回"HTTP: *"
405 Method Not Allowed
在下一篇文章中，我将展示如何自动为自己的ASP.NET Core应用程序生成端点图。
总结
在这篇文章中，我介绍了用于描述图形的DOT语言，并展示了如何使用在线编辑从图表中创建图像。然后，我展示了如何将ASP.NETCore 3.x应用程序中的端点路由表示为有向图。我描述了端点图中不同节点和边缘之间的差异，并调整了图形的显示以更好地表示这些差异。在后面的文章中，我将展示如何为应用程序生成自己的端点图，如何自定义显示，以及如何做的不仅仅是查看图形。
作者：依乐祝（祝雷）
出处：https://www.cnblogs.com/yilezhu
联系：[email protected] .NET Core实战项目交流群：637326624 微信：jkingzhu
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。如有问题或建议，请多多赐教，非常感谢。