使用ImpromptuInterface反射庫方便的創建自定義DfaGraphWriter

在本文中，我為創建的自定義的DfaGraphWriter實作奠定了基礎，DfaGraphWriter是公開的，因此您可以如上一篇文章中所示在應用程式中使用它，但它使用的所有類均已標記為internal，這使得創建自己的版本成為問題，要解決此問題，我使用了一個開源的反射庫ImpromptuInterface，使創建自定義的DfaGraphWriter實作更加容易，

作者：依樂祝
原文地址：https://andrewlock.net/creating-a-custom-dfagraphwriter-using-impromptuinterface-and reflection/
譯文地址：https://www.cnblogs.com/yilezhu/p/13336066.html

我們將從查看現有的DfaGraphWriter開始，以了解其使用的internal類以及導致我們的問題，然后，我們來看一下使用一些自定義介面和ImpromptuInterface庫來允許我們呼叫這些類，在下一篇文章中，我們將研究如何使用自定義界面創建的自定義版本DfaGraphWriter，

探索現有的 DfaGraphWriter

該DfaGraphWriter類是存在于ASP.NET Core中的一個“pubternal”檔案夾中的，它已注冊為單例，并使用注入的IServiceProvider來決議DfaMatcherBuilder：

 public class DfaGraphWriter
{
    private readonly IServiceProvider _services;
    public DfaGraphWriter(IServiceProvider services)
    {
        _services = services;
    }

    public void Write(EndpointDataSource dataSource, TextWriter writer)
    {
        // retrieve the required DfaMatcherBuilder
        var builder = _services.GetRequiredService<DfaMatcherBuilder>();

        // loop through the endpoints in the dataSource, and add them to the builder
        var endpoints = dataSource.Endpoints;
        for (var i = 0; i < endpoints.Count; i++)
        {
            if (endpoints[i] is RouteEndpoint endpoint && (endpoint.Metadata.GetMetadata<ISuppressMatchingMetadata>()?.SuppressMatching ?? false) == false)
            {
                builder.AddEndpoint(endpoint);
            }
        }

        // Build the DfaTree. 
        // This is what we use to create the endpoint graph
        var tree = builder.BuildDfaTree(includeLabel: true);

        // Add the header
        writer.WriteLine("digraph DFA {");

        // Visit each node in the graph to create the output
        tree.Visit(WriteNode);

        //Close the graph
        writer.WriteLine("}");

        // Recursively walks the tree, writing it to the TextWriter
        void WriteNode(DfaNode node)
        {
            // Removed for brevity - we'll explore it in the next post
        }
    }
}

上面的代碼顯示了圖形撰寫者Write方法的所有操作，終結如下：

• 獲取一個 DfaMatcherBuilder
• 寫入所有的端點EndpointDataSource到DfaMatcherBuilder，
• 呼叫DfaMatcherBuilder的BuildDfaTree，這將創建一個DfaNode的 圖，
• 訪問DfaNode樹中的每一個，并將其寫入TextWriter輸出，我們將在下一篇文章中探討這種方法，

創建我們自己的自定義撰寫器的目的是通過控制如何將不同的節點寫入輸出來定制最后一步，因此我們可以創建更多的描述性的圖形，如我先前所示：

我們的問題是兩個重點類，DfaMatcherBuilder和DfaNode，是internal所以我們不能輕易實體化它們，或者使用它們的寫入方法，這給出了兩個選擇：

• 重新實作這些internal類，包括它們依賴的其他任何internal類，
• 使用反射在現有類上創建和呼叫方法，

這些都不是很好的選擇，但是鑒于端點圖不是性能關鍵的東西，我決定使用反射將是最簡單的，為了使事情變得更加簡單，我使用了開源庫ImpromptuInterface，

ImpromptuInterface使反射更容易

ImpromptuInterface是一個庫它使呼叫動態物件或呼叫存盤在物件參考中的底層物件上的方法變得更加容易，它本質上增加了簡單的duck/structural型別，允許您為物件使用stronlgy型別化介面，它使用Dynamic Language Runtime和Reflection.Emit來實作，

例如，讓我們獲取我們要使用的現有DfaMatcherBuilder類，即使我們不能直接參考它，我們仍然可以從DI容器中獲取此類的實體，如下所示：

// get the DfaMatcherBuilder type - internal, so needs reflection :(
Type matcherBuilder = typeof(IEndpointSelectorPolicy).Assembly
    .GetType("Microsoft.AspNetCore.Routing.Matching.DfaMatcherBuilder");

object rawBuilder = _services.GetRequiredService(matcherBuilder);

該rawBuilder是一個object參考，但它包含了一個DfaMatcherBuilder的實體，我們不能直接在呼叫它的方法，但是我們可以通過直接構建MethodInfo和直接呼叫invoke來使用反射來呼叫它們，，

ImpromptuInterface通過提供一個可以直接呼叫方法的靜態介面，使該程序更加容易，例如，對于DfaMatcherBuilder，我們只需要呼叫兩個方法AddEndpoint和BuildDfaTree，原始類如下所示：

internal class DfaMatcherBuilder : MatcherBuilder
{
    public override void AddEndpoint(RouteEndpoint endpoint) { /* body */ }
    public DfaNode BuildDfaTree(bool includeLabel = false)
}

我們可以創建一個暴露這些方法的介面：

public interface IDfaMatcherBuilder
{
    void AddEndpoint(RouteEndpoint endpoint);
    object BuildDfaTree(bool includeLabel = false);
}

然后，我們可以使用ImpromptuInterface ActLike<>方法創建實作了IDfaMatcherBuilder的代理物件，此代理包裝rawbuilder物件，因此當您在介面上呼叫方法時，它將在底層呼叫DfaMatcherBuilder中的等效的方法：

在代碼中，如下所示：

// An instance of DfaMatcherBuilder in an object reference
object rawBuilder = _services.GetRequiredService(matcherBuilder);

// wrap the instance in the ImpromptuInterface interface
IDfaMatcherBuilder builder = rawBuilder.ActLike<IDfaMatcherBuilder>();

// we can now call methods on the builder directly, e.g. 
object rawTree =  builder.BuildDfaTree();

原始DfaMatcherBuilder.BuildDfaTree()方法和介面版本之間有一個重要區別：原始方法回傳一個DfaNode，但這是另一個internal類，因此我們無法在介面中參考它，

相反，我們為DfaNode類創建另一個ImpromptuInterface，暴露我們將需要的屬性（在接下來的文章中你就會明白為什么我們需要他們）：

public interface IDfaNode
{
    public string Label { get; set; }
    public List<Endpoint> Matches { get; }
    public IDictionary Literals { get; } // actually a Dictionary<string, DfaNode>
    public object Parameters { get; } // actually a DfaNode
    public object CatchAll { get; } // actually a DfaNode
    public IDictionary PolicyEdges { get; } // actually a Dictionary<object, DfaNode>
}

在下一篇文章中，我們將在WriteNode的方法中使用這些屬性，但是有一些復雜性，在原始DfaNode類中，Parameters和CatchAll屬性回傳DfaNode物件，在我們IDfaNode版本的屬性中，我們必須回傳object，我們無法參考DfaNode（因為是internal）并且我們不能回傳IDfaNode，因為DfaNode 它沒有實作IDfaNode，因此您不能將object參考隱式轉換為IDfaNode，你必須使用ImpromptuInterface來顯式地添加一個實作了介面的代理，，

例如：

// Wrap the instance in the ImpromptuInterface interface
IDfaMatcherBuilder builder = rawBuilder.ActLike<IDfaMatcherBuilder>();

// We can now call methods on the builder directly, e.g. 
object rawTree =  builder.BuildDfaTree();
// Use ImpromptuInterface to add an IDfaNode wrapper
IDfaNode tree = rawTree.ActLike<IDfaNode>();

// We can now call methods and properties on the node...
object rawParameters = tree.Parameters;
// ...but they need to be wrapped using ImpromptuInterface too
IDfaNode parameters = rawParameters.ActLike<IDfaNode>();

回傳Dictionary型別的屬性還有另一個問題：Literals和PolicyEdges，實際回傳的型別分別為Dictionary<string, DfaNode>和Dictionary<object, DfaNode>，但是我們需要使用一個不包含該DfaNode型別的型別，不幸的是，這意味著我們不得不退回到.NET 1.1 IDictionary介面！

您不能將一個Dictionary<string, DfaNode>強制轉換為IDictionary<string, object>，因為這樣做將是不安全的協方差形式，

IDictionary是一個非泛型介面，因此key和value僅作為object公開，對于string鍵，您可以直接進行轉換，對于，DfaNode我們可以使用ImpromptuInterface為我們創建代理包裝器：

// Enumerate the key-value pairs as DictinoaryEntrys
foreach (DictionaryEntry dictEntry in node.Literals)
{
    // Cast the key value to a string directly
    var key = (string)dictEntry.Key;
    // Use ImpromptuInterface to add a wrapper
    IDfaNode value = https://www.cnblogs.com/yilezhu/p/dictEntry.Value.ActLike();
}

現在，我們已經擁有了通過實作WriteNode來創建自定義DfaWriter實作所需的一切物件，但是這篇文章已經有點長了，所以我們將在下一篇文章中探討如何實作這一點！

摘要

在本文中，我探討了DfaWriter在ASP.NET Core 中的實作以及它使用的兩個internal類：DfaMatcherBuilder和DfaNode，這些類是內部類的事實使得創建我們自己的DfaWriter實作非常棘手，為了干凈地實作它，我們將不得不重新實作這兩種型別以及它們所依賴的所有類，

作為替代，我使用ImpromptuInterface庫創建了一個包裝器代理，該代理實作與被包裝的物件擁有類似的方法，這使用反射來呼叫包裝屬性上的方法，但允許我們使用強型別介面，在下一篇文章中，我將展示如何使用這些包裝器創建一個定制的DfaWriter來進行端點圖的自定義，

標籤：.NET Core

上一篇：因為喜歡所以升級,MyStaging-3.0 繼續

下一篇：演算法題（動態規劃）