在.NET Core中使用DispatchProxy“实现”非公开的接口

原文地址：“Implementing” a non-public interface in .NET Core with DispatchProxy

原文作者：Filip W.

译文地址：https://www.cnblogs.com/lwqlun/p/11575686.html

译者：Lamond Lu

简介

反射是.NET中一个非常强大的概念，对于每一个C#开发人员来说，迟早都会使用到这个它。在许多场景中，反射都非常有用，例如程序集扫描，类型发现或者各种程序组合使用。

然而，它经常被用来绕过你正在使用的依赖项的public接口 - 修改它们或者访问依赖项做着未曾预想的内容。这就是说，这种“黑客入侵”的方式对于C#开发来说非常的典型，尽管有一定的风险，但是它可能有时候是让你摆脱编码困境的唯一方法。

如果你被迫公开一个非public(例如可能是internal的)接口的实现，那么事情就开始变得有趣了。针对这个问题，“基本的”反射已经不能带来任何帮助了，所以让我们来一起看一下我们应该如何实现这个需求。

示例问题

想想一下，你正在使用一个第三方库，在这个库中包含一下的内部类Greeter。

internal class Greeter
{
    public static void Greet(IGreeting greeting)
    {
        Console.WriteLine(greeting.Message);
    }
}

现在呢，我们希望通过反射，使用这个类型，执行它其中定义的Greet方法。为了实现这个需求，你需要一个实现IGreeting接口的实现类实例，因为它是Greet方法所需的参数。IGreeting接口的代码如下：

internal interface IGreeting
{
    string Message { get; }
}

这里需要注意的是，这里没有任何一个你可以直接使用的IGreeting接口的实现。相反的，要使用Greeter类，你就必须自己提供一个IGreeting接口的实现。

当然，使用C#实现一个接口很简单 - 但是如何实现一个通过反射提取到的接口？好吧，这有一点问题，不是么？下面的代码，也对此进行了说明，注意该示例代码中的类与Greeter和IGreeting类型存在于不同的程序集中。

class Program
{
    static void Main(string[] args)
    {
        // 查找非公开Greeter类型
        var greeterType = Assembly.Load("Library").GetType("Library.Greeter");

        // 提取Greet方法
        var greetMethod = internalType.GetMethod("Greet", BindingFlags.Public | BindingFlags.Static);

        // 尝试执行方法，然而...
        // ...我们需要一个IGreeting接口类型的实例，我们该怎么办?
        var greeting = greetMethod.Invoke(null, new[] { ??? });
        Console.WriteLine();
    }
}

DispatchProxy

下面让我们来使用DispatchProxy类。这个类型自.NET Core诞生之日起，就已经存在了，它提供了实例化代理对象和处理器方法分发的机制。DispatchProxy类的典型用法如下：

var proxy = DispatchProxy.Create<IFoo, FooProxy>();

这我们的示例中，IFoo是我们需要实现的接口。DispatchProxy的强大功能如下：它允许我们创建一个FooProxy类型，该类型可以像IFoo一样被使用，且不需要真正"实现它"。（或者它也可以转发给另一个实际上模拟IFoo接口的类型）

但是，当使用以上API的时候，代理类实现的接口类型需要在编译时被知晓，这对于我们当前的用例不太理想 - 因为在非public的接口情况下，我们只能在运行时才能抓住它。不过不用担心，我们将使用反射解决这个问题。以下的代码说明了我们的做法(假设IFoo是非public的):

var internalType = Assembly.Load("Library").GetType("IFoo");
var proxy = typeof(DispatchProxy)
    .GetMethod(nameof(DispatchProxy.Create))
    .MakeGenericMethod(internalType, typeof(FooProxy))
    .Invoke(null, null);

最后就很简单了，我们使用与之前相同的Api, 但是我们可以动态的提供必要的参数类型，而不必在编译时才知道它们才能在泛型中使用。

在我们特定的Greeting例子中，用于创建代理的方法如下：（为了更清晰的分离，我们将它封装在一个工厂类中）。

public class GreetingFactory
{
    public static object Create()
    {
        var internalType = Assembly.Load("Library").GetType("Library.IGreeting");
        return typeof(DispatchProxy)
            .GetMethod(nameof(DispatchProxy.Create))
            .MakeGenericMethod(internalType, typeof(GreetingProxy))
            .Invoke(null, null);
    }
}

现在，谜题的最后一块碎片就是实现GreetingProxy了。如下的代码展示了GreetingProxy类的实现，它是DispatchProxy的一个子类。

public class GreetingProxy : DispatchProxy
{
    private GreetingImpl _impl;

    public GreetingProxy()
    {
        _impl = new GreetingImpl();
    }

    protected override object Invoke(MethodInfo targetMethod, object[] args)
    {
        return _impl.GetType().GetMethod(targetMethod.Name).Invoke(_impl, args);
    }

    private class GreetingImpl // : 不实现IGreeting, 但是模拟了它
    {
        public string Message => "hello world";
    }
}

如你所见，这个类充当了潜在调用者与IGreeting实际实现之间的网关，毕竟这就是代理的主要作用。这个"实现"（我用引号引起来，因为我们并不是真正实现非public接口），或者更确切的说，使用私有类GreetingImpl的形式模仿接口类型，并包含了必要的public属性Message。这里并不是必须要要这么做，这只是我自己喜欢的一种实现方式。

每当代用代理类的时候，我们都会可以根据请求的接口成员获得MethodInfo信息 - 因此，我们只需将其重定向到结构相同的隐藏实现GreetingImpl的相应成员即可。

最后，我们的代码看起来应该是这样的。

class Program
{
    static void Main(string[] args)
    {
        var internalType = Assembly.Load("Library").GetType("Library.Greeter");
        var greetMethod = internalType.GetMethod("Greet", BindingFlags.Public | BindingFlags.Static);

        var proxy = GreetingFactory.Create();
        Console.WriteLine(greetMethod.Invoke(null, new[] { proxy }));
    }
}

那么，这个方法到底是用来做什么的呢？它通过代理对象，调用了GreetingImpl中定义的方法，打印出了"Hello World"。当然，最终的结果是我们设法“实现”并使用了非公开API中的非public接口。

这在真实需求中有用么？

就像其他所有东西一样，我觉着答案 - 取决于 -毕竟它是一个高度专业化的API。这种技术（代理对象）经常会在ORM和其他Mock框架中使用。另外，如果你使用的是复杂的第三方框架或库，并且需要使用大量的反射，那么你迟早会用到DispatchProxy。

实际上，如果你对真实需求的例子感兴趣， 你可以来看看我们的OmniSharp项目。OmniSharp项目使用Roslyn编译器为VSCode等许多代码编辑器提供代码感知功能。但是不幸的是，Roslyn并不会提供大量public API, 所以我们不得不大量使用反射。实际上，我们还必须在许多地方使用DispatchProxy才能向用户提供一些特定功能，例如从类型中提取接口。一方面，这不是很友好，因为东西很容易崩溃，但是对于客户的价值是毋庸置疑的，所以我们还是选择这样做。