@elf-express/admin-net-mcp 1.0.0 → 1.1.0

package/knowledge/Furion_Teaching_Manual/05-3-/347/257/251/351/201/270/345/231/250/346/224/224/346/210/252/345/231/250AOP.md

@@ -0,0 +1,581 @@
+# 5.3 篩選器/攔截器/過濾器/AOP
+
+## 5.3.1 關於篩選器
+
+篩選器又名過濾器、攔截器，在 ASP.NET Core 中，可在請求處理管線中特定階段之前或之後執行程式碼。篩選器是非常經典的面向切面程式設計方式，也就是所謂的 AOP 操作。
+
+通俗來說就是可以在控制器 Action 執行前後進行切面操作，或回傳 Result 結果前後進行操作。
+
+---
+
+## 5.3.2 應用場景
+
+透過自訂篩選器可以實現錯誤處理、快取處理、授權處理、日誌記錄、實現工作單元交易（Uow）等等切面操作，從而使業務邏輯和系統行為邏輯進行分離。
+
+### 5.3.2.1 篩選器優點
+
+- 易擴充，易整合
+- 業務和系統邏輯分離，不干擾業務程式碼
+- 可實現介面多維度控制，如請求參數竄改、回傳值竄改、限流、分散式交易支援
+
+---
+
+## 5.3.3 支援攔截應用
+
+- Mvc/WebAPI 控制器/Action
+- Razor Pages 頁面
+- 框架提供的動態 WebAPI
+- 所有請求資源
+- 全域例外
+
+---
+
+## 5.3.4 篩選器類型
+
+### 5.3.4.1 介面類型
+
+**授權篩選器**：最先執行，用於確定是否已針對請求為使用者授權。如果請求未獲授權，授權篩選器可以讓管線短路。
+
+- `IAuthorizationFilter` / `IAsyncAuthorizationFilter` / `AuthorizeFilter`
+
+**資源篩選器**：授權後執行，如果需要使大部分請求管線短路，它將會很有用。
+
+- `IResourceFilter` / `IAsyncResourceFilter`
+
+**操作篩選器**：在呼叫操作方法之前和之後執行程式碼，可以更改傳遞的參數、回傳結果等，不可在 Razor Pages 中使用。
+
+- `IActionFilter` / `IAsyncActionFilter`
+
+**例外篩選器**：在向回應主體寫入任何內容之前，對未經處理的例外套用全域策略。
+
+- `IExceptionFilter` / `IAsyncExceptionFilter`
+
+**結果篩選器**：在執行操作結果之前和之後立即執行程式碼，僅當操作方法成功執行時才會執行。
+
+- `IResultFilter` / `IAsyncResultFilter`
+- `IAlwaysRunResultFilter` / `IAsyncAlwaysRunResultFilter`：針對所有操作結果執行攔截，即使 `IResourceFilter` 設定了 Result 仍會執行
+
+**Razor Pages 篩選器**：允許 Razor Pages 在執行 Razor 頁面處理常式前後執行程式碼。
+
+- `IPageFilter` / `IAsyncPageFilter`
+
+### 5.3.4.2 特性 Attribute 類型
+
+- **授權特性篩選器**：`Attribute + IAsyncAuthorizationFilter`
+- **操作特性篩選器**：`ActionFilterAttribute`
+- **例外特性篩選器**：`ExceptionFilterAttribute`
+- **結果特性篩選器**：`ResultFilterAttribute`
+- **服務特性篩選器**：`ServiceFilterAttribute`（支援相依性注入）
+- **類型特性篩選器**：`TypeFilterAttribute`（不支援相依性注入但可傳入自訂建構函式參數）
+- **組合特性篩選器**：`Attribute + 介面類型方式`
+
+> **篩選器選用技巧**：當你不需要全域篩選器的時候使用特性篩選器，否則使用介面類型篩選器。另外盡可能使用帶 `IAsync` 開頭的非同步篩選器。
+>
+> **同步非同步篩選器**：篩選器介面的同步和非同步版本任意實現一個即可。執行時會先查看是否實現了非同步介面，如果是則呼叫該介面；如果不是，則呼叫同步介面。如果同時實現，則僅呼叫非同步方法。
+
+---
+
+## 5.3.5 篩選器註冊
+
+ASP.NET Core 提供了多種篩選器註冊方式。通常不同的註冊方式執行順序不同：服務類型註冊最先執行，其次是 Mvc Filter 方式，最後是特性方式。相同方式中按照註冊前後決定執行順序，先註冊先執行。
+
+也可透過 `IOrderedFilter` 介面重寫執行順序，其 `Order` 屬性值越高的先執行。
+
+### 5.3.5.1 在 Startup.cs 中註冊
+
+這種方式表示全域註冊，應用所有控制器/Action：
+
+```csharp
+public void ConfigureServices(IServiceCollection services)
+{
+    // Mvc 方式註冊一，全域執行
+    services.AddControllersWithViews(options =>
+    {
+        options.Filters.Add(new AddHeaderAttribute("GlobalAddHeader", "Result filter added to MvcOptions.Filters"));
+        options.Filters.Add(typeof(MySampleActionFilter));
+        options.Filters.Add(new SampleGlobalActionFilter());
+    });
+
+    // Mvc 方式註冊二，全域執行
+    services.Configure<MvcOptions>(options =>
+    {
+        options.Filters.Add<TFilter>();
+    });
+
+    // Mvc 註冊方式三，全域執行，Furion 框架提供方式
+    services.AddMvcFilter<TFilter>();
+}
+```
+
+### 5.3.5.2 特性方式註冊
+
+這種方式表示局部註冊，只作用於特定的控制器/Action。
+
+**直接貼方式：**
+
+```csharp
+public class AddHeaderAttribute : ResultFilterAttribute { /* ... */ }
+
+[AddHeader]
+public class SampleController : Controller { }
+```
+
+**透過 `[ServiceFilter]` 方式**（適用於自訂特性篩選器包含建構函式注入服務的情境，需先在 `ConfigureServices` 中註冊）：
+
+```csharp
+// 篩選器定義
+public class MyActionFilterAttribute : ActionFilterAttribute
+{
+    private readonly PositionOptions _settings;
+    public MyActionFilterAttribute(IOptions<PositionOptions> options) { }
+}
+
+// Startup.cs 中註冊
+services.AddScoped<MyActionFilterAttribute>();
+
+// 使用
+[ServiceFilter(typeof(MyActionFilterAttribute))]
+public IActionResult Index2() { /* ... */ }
+```
+
+**透過 `[TypeFilter]` 方式**（不支援相依性注入但可傳遞基元類型建構函式參數）：
+
+```csharp
+public class MyLogFilterAttribute : ActionFilterAttribute
+{
+    public MyLogFilterAttribute(string message, int level) { }
+}
+
+[TypeFilter(typeof(MyLogFilterAttribute), Arguments = new object[] { "Message", 10 })]
+public IActionResult Index2() { /* ... */ }
+```
+
+---
+
+## 5.3.6 授權篩選器
+
+透過授權篩選器可以實現在所有請求到達控制器/Action 之前進行驗證，如果授權失敗，直接跳轉到登入或者回傳 401。
+
+### 5.3.6.1 介面定義方式
+
+```csharp
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.Authorization;
+using Microsoft.AspNetCore.Mvc.Controllers;
+using Microsoft.AspNetCore.Mvc.Filters;
+
+namespace WebApplication4.Filters;
+
+public class MyAuthorizationFilter : IAsyncAuthorizationFilter
+{
+    public async Task OnAuthorizationAsync(AuthorizationFilterContext context)
+    {
+        var actionDescriptor = context.ActionDescriptor as ControllerActionDescriptor;
+        var controllerType = actionDescriptor!.ControllerTypeInfo;
+        var methodType = actionDescriptor.MethodInfo;
+
+        // 是否匿名存取
+        var allowAnonymous = context.Filters.Any(u => u is IAllowAnonymousFilter)
+                        || controllerType.IsDefined(typeof(AllowAnonymousAttribute), true)
+                        || methodType.IsDefined(typeof(AllowAnonymousAttribute), true);
+
+        if (!allowAnonymous)
+        {
+            // MVC 專案跳轉到登入頁
+            if (typeof(Controller).IsAssignableFrom(controllerType.AsType()))
+            {
+                context.Result = new RedirectResult("~/Login");
+            }
+            else
+            {
+                context.Result = new UnauthorizedResult();
+            }
+        }
+        else await Task.CompletedTask;
+    }
+}
+```
+
+**全域註冊：**
+
+```csharp
+services.Configure<MvcOptions>(options =>
+{
+    options.Filters.Add<MyAuthorizationFilter>();
+});
+
+// 或使用 Furion 框架提供的簡易方式
+services.AddMvcFilter<MyAuthorizationFilter>();
+```
+
+**局部特性方式：**
+
+```csharp
+[TypeFilter(typeof(MyAuthorizationFilter))]
+public IActionResult Get() { /* ... */ }
+
+// 或使用 [ServiceFilter]（需先 services.AddScoped<MyAuthorizationFilter>()）
+[ServiceFilter(typeof(MyAuthorizationFilter))]
+public IActionResult Get() { /* ... */ }
+```
+
+### 5.3.6.2 特性定義方式（組合）
+
+```csharp
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = false)]
+public class MyAuthorizationFilterAttribute : Attribute, IAsyncAuthorizationFilter
+{
+    public async Task OnAuthorizationAsync(AuthorizationFilterContext context)
+    {
+        // 程式碼同上
+    }
+}
+
+// 使用
+[MyAuthorizationFilter]
+public IActionResult Get() { /* ... */ }
+```
+
+---
+
+## 5.3.7 資源篩選器
+
+資源篩選器使用頻率較少，通常用來處理資源快取或者阻止模型（值）繫結操作。
+
+### 5.3.7.1 介面定義方式
+
+```csharp
+public class MyResourceFilter : IAsyncResourceFilter
+{
+    public async Task OnResourceExecutionAsync(ResourceExecutingContext context, ResourceExecutionDelegate next)
+    {
+        var valueProviderFactories = context.ValueProviderFactories;
+
+        var formValueProviderFactory = valueProviderFactories
+                .OfType<FormValueProviderFactory>()
+                .FirstOrDefault();
+        if (formValueProviderFactory != null)
+        {
+            context.ValueProviderFactories.Remove(formValueProviderFactory);
+        }
+
+        var resourceContext = await next();
+    }
+}
+```
+
+註冊方式同授權篩選器（全域 `services.AddMvcFilter<MyResourceFilter>()`、局部 `[TypeFilter]` / `[ServiceFilter]`）。
+
+### 5.3.7.2 特性定義方式（組合）
+
+```csharp
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = false)]
+public class MyResourceFilterAttribute : Attribute, IAsyncResourceFilter
+{
+    public async Task OnResourceExecutionAsync(ResourceExecutingContext context, ResourceExecutionDelegate next)
+    {
+        // 程式碼同上
+    }
+}
+```
+
+---
+
+## 5.3.8 操作篩選器
+
+操作篩選器是使用頻率最高的篩選器，通常用來控制進入 Action 之前（此時模型繫結已完成）和 Action 執行之後（此時 Result 還未回傳）。
+
+可以使用操作篩選器實現各種操作，如竄改參數、竄改回傳值、統一參數驗證、稽核日誌、實現資料庫交易自動開啟關閉等等。
+
+### 5.3.8.1 介面定義方式
+
+```csharp
+public class MyActionFilter : IAsyncActionFilter
+{
+    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
+    {
+        //============== 執行方法之前取得資料 ====================
+        var actionDescriptor = context.ActionDescriptor as ControllerActionDescriptor;
+        var method = actionDescriptor!.MethodInfo;
+        var httpContext = context.HttpContext;
+        var httpRequest = httpContext.Request;
+
+        // 取得客戶端 IPv4 位址
+        var remoteIPv4 = httpContext.GetRemoteIpAddressToIPv4();
+
+        // 取得請求的 Url 位址
+        var requestUrl = httpRequest.GetRequestUrlAddress();
+
+        // 取得來源 Url 位址
+        var refererUrl = httpRequest.GetRefererUrlAddress();
+
+        // 取得請求參數（可以自由竄改）
+        var parameters = context.ActionArguments;
+
+        // 取得操作人（必須授權存取才有值）
+        var userId = httpContext.User?.FindFirstValue("userId");
+
+        var requestedTime = DateTimeOffset.Now;
+
+        //============== 執行方法之後取得資料 ====================
+        var actionContext = await next();
+
+        var returnResult = actionContext.Result;
+        var isRequestSucceed = actionContext.Exception == null;
+        var stackTrace = EnhancedStackTrace.Current();
+    }
+}
+```
+
+**全域註冊：** `services.AddMvcFilter<MyActionFilter>();`
+
+**局部特性方式：** `[TypeFilter(typeof(MyActionFilter))]` 或 `[ServiceFilter(typeof(MyActionFilter))]`
+
+### 5.3.8.2 ActionFilterAttribute 方式
+
+```csharp
+public class MyActionAttribute : ActionFilterAttribute
+{
+    public override Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
+    {
+        return base.OnActionExecutionAsync(context, next);
+    }
+
+    public override Task OnResultExecutionAsync(ResultExecutingContext context, ResultExecutionDelegate next)
+    {
+        return base.OnResultExecutionAsync(context, next);
+    }
+}
+
+// 使用
+[MyAction]
+public IActionResult Get() { /* ... */ }
+```
+
+### 5.3.8.3 特性定義方式（組合）
+
+```csharp
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = false)]
+public class MyActionFilterAttribute : Attribute, IAsyncActionFilter
+{
+    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
+    {
+        // 程式碼同上
+    }
+}
+```
+
+---
+
+## 5.3.9 例外篩選器
+
+例外篩選器使用頻率僅次於操作篩選器，更多用於程式出現例外時記錄日誌或回傳統一的頁面。
+
+### 5.3.9.1 介面定義方式
+
+```csharp
+public class MyExceptionFilter : IAsyncExceptionFilter
+{
+    public async Task OnExceptionAsync(ExceptionContext context)
+    {
+        if (context.ExceptionHandled) return;
+
+        var actionDescriptor = context.ActionDescriptor as ControllerActionDescriptor;
+        var method = actionDescriptor!.MethodInfo;
+        var exception = context.Exception;
+        var stackTrace = EnhancedStackTrace.Current();
+
+        // 1. MVC 回傳自訂錯誤頁面
+        // 2. WebAPI 回傳 context.Result = new JsonResult(...)
+        // 3. 記錄日誌
+
+        await Task.CompletedTask;
+    }
+}
+```
+
+**全域註冊：** `services.AddMvcFilter<MyExceptionFilter>();`
+
+### 5.3.9.2 ExceptionFilterAttribute 方式
+
+```csharp
+public class MyExceptionAttribute : ExceptionFilterAttribute
+{
+    public override Task OnExceptionAsync(ExceptionContext context)
+    {
+        return base.OnExceptionAsync(context);
+    }
+}
+
+// 使用
+[MyException]
+public IActionResult Get() { /* ... */ }
+```
+
+### 5.3.9.3 特性定義方式（組合）
+
+```csharp
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = false)]
+public class MyExceptionFilterAttribute : Attribute, IAsyncExceptionFilter
+{
+    public async Task OnExceptionAsync(ExceptionContext context)
+    {
+        // 程式碼同上
+    }
+}
+```
+
+---
+
+## 5.3.10 結果篩選器
+
+結果篩選器常用於對回傳的結果附加更多資料，比如 Mvc 中的 `ViewBag`、`ViewData`，主要用來控制輸出到瀏覽器的介面檢視物件。
+
+### 5.3.10.1 介面定義方式
+
+```csharp
+public class MyResultFilter : IAsyncResultFilter
+{
+    public async Task OnResultExecutionAsync(ResultExecutingContext context, ResultExecutionDelegate next)
+    {
+        var actionDescriptor = context.ActionDescriptor as ControllerActionDescriptor;
+        var routeData = context.RouteData;
+
+        // 判斷如果是 MVC 檢視，可以動態新增資料到頁面中
+        if (context.Result is ViewResult viewResult)
+        {
+            viewResult.TempData["Name"] = "Furion";
+            viewResult.ViewData["Version"] = 1;
+        }
+
+        // 也可以強制替換 Result
+        // context.Result = new ContentResult("....");
+
+        // 執行下一個結果過濾器
+        // 如果要短路，設定 context.Cancel = true; 即可
+        var resultContext = await next();
+        var result = resultContext.Result;
+    }
+}
+```
+
+**全域註冊：** `services.AddMvcFilter<MyResultFilter>();`
+
+### 5.3.10.2 ResultFilterAttribute 方式
+
+```csharp
+public class MyResultAttribute : ResultFilterAttribute
+{
+    public override Task OnResultExecutionAsync(ResultExecutingContext context, ResultExecutionDelegate next)
+    {
+        return base.OnResultExecutionAsync(context, next);
+    }
+}
+
+// 使用
+[MyResult]
+public IActionResult Get() { /* ... */ }
+```
+
+### 5.3.10.3 特性定義方式（組合）
+
+```csharp
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = false)]
+public class MyResultFilterAttribute : Attribute, IAsyncResultFilter
+{
+    public async Task OnResultExecutionAsync(ResultExecutingContext context, ResultExecutionDelegate next)
+    {
+        // 程式碼同上
+    }
+}
+```
+
+### 5.3.10.4 IAlwaysRunResultFilter
+
+`IAlwaysRunResultFilter` 和 `IAsyncAlwaysRunResultFilter` 介面宣告了一個針對所有操作結果執行的 `IResultFilter` 實作。這包括由以下物件產生的操作結果：設定短路的授權篩選器和資源篩選器、例外篩選器。
+
+---
+
+## 5.3.11 RazorPages 篩選器
+
+Razor Pages 篩選器僅支援 Razor Pages 專案類型。
+
+```csharp
+public class MyPageFilter : IAsyncPageFilter
+{
+    public async Task OnPageHandlerExecutionAsync(PageHandlerExecutingContext context, PageHandlerExecutionDelegate next)
+    {
+        var routeData = context.RouteData;
+        var actionDescriptor = context.ActionDescriptor;
+        var methodDescriptor = context.HandlerMethod;
+
+        await next.Invoke();
+    }
+
+    public Task OnPageHandlerSelectionAsync(PageHandlerSelectedContext context)
+    {
+        return Task.CompletedTask;
+    }
+}
+```
+
+**全域註冊：** `services.Configure<MvcOptions>(options => { options.Filters.Add(new MyPageFilter()); });`
+
+---
+
+## 5.3.12 篩選器取消和短路
+
+通常篩選器支援多個，只要呼叫 `await next()` 方法都會進入下一個篩選器，但如果透過 `context.Result = new XXXResult()` 之後，就可以使其短路。
+
+例外情況：
+
+- 在 `IResultFilter` / `IAsyncResultFilter` 結果篩選器中，使用 `context.Cancel = true;` 設定短路
+- 在 `IExceptionFilter` / `IAsyncExceptionFilter` 例外篩選器中，使用 `context.ExceptionHandled = true;` 設定短路
+
+---
+
+## 5.3.13 篩選器執行順序控制
+
+### 5.3.13.1 不同類型篩選器執行順序
+
+```
+IAuthorizationFilter → IResourceFilter → IActionFilter → IExceptionFilter → IResultFilter → IAlwaysRunResultFilter
+```
+
+### 5.3.13.2 相同類型篩選器執行順序
+
+預設透過 `services.Configure<MvcOptions>(...)` 方式先註冊先執行，之後到特性方式。
+
+也可以控制執行順序：
+
+**IOrderedFilter 方式：**
+
+```csharp
+public class MyActionFilter : IAsyncActionFilter, IOrderedFilter
+{
+    public int Order => 1000; // 值越大，越優先執行
+
+    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
+    {
+        // ....
+    }
+}
+```
+
+**特性方式：**
+
+```csharp
+[MyActionFilter(Order = 1000)]
+public class ControllerFiltersController : Controller { /* ... */ }
+```
+
+---
+
+## 5.3.14 篩選器相依性注入
+
+篩選器支援建構函式相依性注入服務，使用前提是在 `Startup.cs` 中註冊：
+
+```csharp
+services.AddScoped<MyActionFilterAttribute>();
+```

package/knowledge/Furion_Teaching_Manual/05-4-/350/253/213/346/261/202/347/250/275/346/240/270/346/227/245/350/252/214.md

@@ -0,0 +1,129 @@
+# 5.4 請求稽核日誌（Audit）
+
+> **小知識**：Furion 提供了非常強大的 `LoggingMonitor` 稽核日誌功能，可直接使用：LoggingMonitor 文件。
+
+---
+
+## 5.4.1 稽核日誌
+
+在一個企業應用系統中，使用者對系統所有的操作包括請求、資料庫操作等等都應該記錄起來，那麼這些日誌我們稱為操作日誌，也可以說稽核日誌。
+
+> **關於資料庫操作稽核日誌**：如需實現 SQL 操作、資料庫操作的稽核日誌可查閱【9.23 審計日誌章節】。
+
+---
+
+## 5.4.2 請求稽核日誌
+
+### 實現原理
+
+結合【5.3 篩選器】實現請求稽核日誌功能。
+
+請求稽核日誌通常指的是記錄請求位址、來源位址、操作人、傳遞參數等。主要透過 `IAsyncActionFilter` 篩選器實現。
+
+### 定義 RequestAuditFilter 並實現 IAsyncActionFilter
+
+```csharp
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc.Filters;
+using System;
+using System.Security.Claims;
+using System.Threading.Tasks;
+
+namespace Furion.Web.Core
+{
+    public class RequestAuditFilter : IAsyncActionFilter
+    {
+        public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
+        {
+            //============== 執行方法之前取得資料 ====================
+
+            // 取得控制器、路由資訊
+            var actionDescriptor = context.ActionDescriptor as ControllerActionDescriptor;
+
+            // 取得請求的方法
+            var method = actionDescriptor.MethodInfo;
+
+            // 取得 HttpContext 和 HttpRequest 物件
+            var httpContext = context.HttpContext;
+            var httpRequest = httpContext.Request;
+
+            // 取得客戶端 IPv4 位址
+            var remoteIPv4 = httpContext.GetRemoteIpAddressToIPv4();
+
+            // 取得請求的 Url 位址
+            var requestUrl = httpRequest.GetRequestUrlAddress();
+
+            // 取得來源 Url 位址
+            var refererUrl = httpRequest.GetRefererUrlAddress();
+
+            // 取得請求參數（寫入日誌，需序列化成字串後儲存）
+            var parameters = context.ActionArguments;
+
+            // 取得操作人（必須授權存取才有值）
+            // "userId" 為你儲存的 claims type，JWT 授權對應的是 payload 中儲存的鍵名
+            var userId = httpContext.User?.FindFirstValue("userId");
+
+            // 請求時間
+            var requestedTime = DateTimeOffset.Now;
+
+            //============== 執行方法之後取得資料 ====================
+            var actionContext = await next();
+
+            // 取得回傳的結果
+            var returnResult = actionContext.Result;
+
+            // 判斷是否請求成功，沒有例外就是請求成功
+            var isRequestSucceed = actionContext.Exception == null;
+
+            // 取得呼叫堆疊資訊
+            var stackTrace = EnhancedStackTrace.Current();
+
+            // 這裡寫入日誌，或儲存到資料庫中
+        }
+    }
+}
+```
+
+### 註冊 RequestAuditFilter 篩選器
+
+```csharp
+services.AddMvcFilter<RequestAuditFilter>();
+```
+
+---
+
+## 5.4.3 LoggingMonitor 稽核日誌
+
+> Furion 提供了非常強大的 `LoggingMonitor` 稽核日誌功能，可直接使用。
+
+輸出範例：
+
+```
+┏━━━━━━━━━━━  Logging Monitor ━━━━━━━━━━━
+┣ Furion.Application.TestLoggerServices.GetPerson (Furion.Application)
+┣
+┣ 控制器名稱：              TestLoggerServices
+┣ 操作名稱：                GetPerson
+┣ 路由資訊：                [area]: ; [controller]: test-logger; [action]: person
+┣ 請求方式：                POST
+┣ 請求位址：                https://localhost:44316/api/test-logger/person/11
+┣ 來源位址：                https://localhost:44316/api/index.html
+┣ 瀏覽器標識：              Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...
+┣ 客戶端 IP 位址：          0.0.0.1
+┣ 伺服端 IP 位址：          0.0.0.1
+┣ 伺服端執行環境：          Development
+┣ 執行耗時：                31ms
+┣ ━━━━━━━━━━━━━━━  授權資訊 ━━━━━━━━━━━━━━━
+┣ JWT Token：               Bearer eyJhbGci...
+┣
+┣ UserId (integer)：        1
+┣ Account (string)：        admin
+┣ ━━━━━━━━━━━━━━━  參數列表 ━━━━━━━━━━━━━━━
+┣ Content-Type：
+┣
+┣ id (Int32)：              11
+┣ ━━━━━━━━━━━━━━━  回傳資訊 ━━━━━━━━━━━━━━━
+┣ 類型：                    Furion.Application.Persons.PersonDto
+┣ 回傳值：                  {"Id":11,"Name":null,"Age":0,...}
+┗━━━━━━━━━━━  Logging Monitor ━━━━━━━━━━━
+```