快捷導(dǎo)航

使用C#?11的靜態(tài)接口方法改進(jìn)?面向約定?的設(shè)計(jì)方法

更新時(shí)間：2022年12月12日 09:36:08 作者：Artech

我們知道接口是針對(duì)契約的定義，但是一直以來(lái)它只能定義一組“實(shí)例”的契約，而不能定義類型的契約，因?yàn)槎x在接口中的方法只能是實(shí)例方，這篇文章主要介紹了使用C#?11的靜態(tài)接口方法改進(jìn)面向約定?的設(shè)計(jì),需要的朋友可以參考下

C# 11帶來(lái)了一個(gè)我期待已久的特性——接口方法。我們知道接口是針對(duì)契約的定義，但是一直以來(lái)它只能定義一組“實(shí)例”的契約，而不能定義類型（的靜態(tài)成員）的契約，因?yàn)槎x在接口中的方法只能是實(shí)例方法。由于缺乏針對(duì)“類型契約”的支持，我們?cè)谠O(shè)計(jì)一些框架或者類庫(kù)的時(shí)候，只能采用“按照約定”的設(shè)計(jì)，比如ASP.NET Core Minimal API針對(duì)參數(shù)的綁定就是一個(gè)典型的案例。

C# 11帶來(lái)了一個(gè)我期待已久的特性——靜態(tài)接口方法。我們知道接口是針對(duì)契約的定義，但是一直以來(lái)它只能定義一組“實(shí)例”的契約，而不能定義類型（的靜態(tài)成員）的契約，因?yàn)槎x在接口中的方法只能是實(shí)例方法。由于缺乏針對(duì)“類型契約”的支持，我們?cè)谠O(shè)計(jì)一些框架或者類庫(kù)的時(shí)候，只能采用“按照約定”的設(shè)計(jì)，比如ASP.NET Core Minimal API針對(duì)參數(shù)的綁定就是一個(gè)典型的案例。以如下這個(gè)簡(jiǎn)單的應(yīng)用為例，我們采用Minimal API的形式注冊(cè)了一個(gè)針對(duì)根地址“/”的路由，作為處理器的委托的輸出和輸出都是我們自定義的Point對(duì)象。

var app = WebApplication.Create();
app.Map("/", (Point point) => point);
app.Run();

public class Point
{
    public double X { get; }
    public double Y { get; }
    public Point(double x, double y)
    {
        X = x;
        Y = y;
    }

    public override string ToString() => $"{X},{Y}";

    public static bool TryParse(string expression, out Point? result)
    {
        result = default;
        var parts = expression.Split(',');
        if (parts.Length != 2) return false;
        if (!double.TryParse(parts[0], out var x) || !double.TryParse(parts[1], out var y)) return false;
        result = new Point(x, y);
        return true;
    }
}

Minimal API的約定，如果我們?yōu)镻oint類型定義了具有如上聲明的TryParse方法，該方法就會(huì)用來(lái)幫助我們綁定處理方法的Point參數(shù)，如下的演示結(jié)果證實(shí)了這一點(diǎn)。

其實(shí)針對(duì)參數(shù)綁定，我們還可以定義如下這樣BindAsync參數(shù)來(lái)完成。

public class Point
{
    ...
    public static ValueTask<Point?> BindAsync(HttpContext httpContext, ParameterInfo parameter)
    {
        Point? result = default;
        var name = parameter.Name;
        var value = httpContext.GetRouteData().Values.TryGetValue(name!, out var v) ? v : httpContext.Request.Query[name!].SingleOrDefault();
        if (value is string expression && TryParse(expression, out var point))
        {
            result = point;
        }
        return new ValueTask<Point?>(result);
    }
}

對(duì)于這種“基于約定”的編程，可以你覺(jué)得還不錯(cuò)，但是我想有90%的ASP.NET Core的開(kāi)發(fā)者不知道有這個(gè)特性，就從這一點(diǎn)就充分證明了這樣的設(shè)計(jì)還不夠好。這樣的實(shí)現(xiàn)也比較繁瑣，我們不得不通過(guò)反射檢驗(yàn)待綁定參數(shù)的類型是否滿足約定，并以反射（或者表達(dá)式樹(shù)）的方式調(diào)用對(duì)應(yīng)的方法。其實(shí)上述兩個(gè)方法本應(yīng)該寫(xiě)入“契約”，無(wú)奈它們是靜態(tài)方法，沒(méi)法定義在接口中?，F(xiàn)在我們有了靜態(tài)接口方法，它們可以定義如下所示的IBindable<T>和IParsable<T>。

public interface IBindable<T>
{
    abstract static ValueTask<T?> BindAsync(HttpContext httpContext, ParameterInfo parameter);
}

public interface IParsable<T>
{
    abstract static bool TryParse(string expression, out T? result);
}

public class Point : IBindable<Point>, IParsable<Point>
{
    public double X { get; }
    public double Y { get; }
    public Point(double x, double y)
    {
        X = x;
        Y = y;
    }

    public override string ToString() => $"{X},{Y}";

    public static bool TryParse(string expression, out Point? result)
    {
        result = default;
        var parts = expression.Split(',');
        if (parts.Length != 2) return false;
        if (!double.TryParse(parts[0], out var x) || !double.TryParse(parts[1], out var y)) return false;
        result = new Point(x, y);
        return true;
    }

    public static ValueTask<Point?> BindAsync(HttpContext httpContext, ParameterInfo parameter)
    {
        Point? result = default;
        var name = parameter.Name;
        var value = httpContext.GetRouteData().Values.TryGetValue(name!, out var v) ? v : httpContext.Request.Query[name!].SingleOrDefault();
        if (value is string expression && TryParse(expression, out var point))
        {
            result = point;
        }
        return new ValueTask<Point?>(result);
    }
}

實(shí)際上IParsable<T>已經(jīng)存在了，它真正的定義是這樣的。如果有了這樣的接口，確定帶綁定參數(shù)類型是否滿足之前的約定條件只需要確定其是否實(shí)現(xiàn)了對(duì)應(yīng)的接口就可以了。

public interface IParsable<TSelf> where TSelf : IParsable<TSelf>?
{
    static TSelf Parse(string s, IFormatProvider? provider);
    static bool TryParse([NotNullWhen(true)] string? s, IFormatProvider? provider, [MaybeNullWhen(false)] out TSelf result);
}

靜態(tài)接口設(shè)計(jì)被應(yīng)用到基于微服務(wù)框架go-micro開(kāi)發(fā)gRPC應(yīng)用程序中，我在表示gRPC服務(wù)的接口中定義了如下的靜態(tài)方法Bind將本服務(wù)類型中定義的gRPC方法綁定成路由。

public interface IGrpcService<TService> where TService : class
{
    static abstract void Bind(IServiceBinder<TService> binder);
}

[GrpcService(ServiceName = "Greeter")]
public class GreeterService: IGrpcService<GreeterService>
{
    public Task<HelloReply> SayHelloUnaryAsync(HelloRequest request, ServerCallContext context);

    public async Task<HelloReply> SayHelloClientStreamingAsync(IAsyncStreamReader<HelloRequest> reader, ServerCallContext context);

    public  async Task SayHelloServerStreamingAsync(Empty request, IServerStreamWriter<HelloReply> responseStream, ServerCallContext context);

    public async Task SayHelloDuplexStreamingAsync(IAsyncStreamReader<HelloRequest> reader, IServerStreamWriter<HelloReply> writer, ServerCallContext context);

    public static void Bind(IServiceBinder<GreeterService> binder)
    {
        binder
            .AddUnaryMethod<HelloRequest, HelloReply>(it =>it.SayHelloUnaryAsync(default!,default!), HelloRequest.Parser)
            .AddClientStreamingMethod<HelloRequest, HelloReply>(it => it.SayHelloClientStreamingAsync(default!, default!), HelloRequest.Parser)
            .AddServerStreamingMethod<Empty, HelloReply>(nameof(SayHelloServerStreamingAsync), it => it.SayHelloServerStreamingAsync, Empty.Parser)
            .AddDuplexStreamingMethod<HelloRequest, HelloReply>(nameof(SayHelloDuplexStreamingAsync), it => it.SayHelloDuplexStreamingAsync, HelloRequest.Parser);
    }

到此這篇關(guān)于使用C# 11的靜態(tài)接口方法改進(jìn) 面向約定的設(shè)計(jì)的文章就介紹到這了,更多相關(guān)C# 11的靜態(tài)接口方法內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: