摘要: 作者引言.Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之试试的新玩法"打洞",让防火墙哭去吧 试试RPCs的新玩法"打洞" 比较典型的玩法:RPC数据流从客户端流向服务端,现在来尝试用IceRPC来玩一个新的花样"打洞"。 概述 对于 IceRPC,客户端是发起连接的实体, 而服务 阅读全文
posted @ 2024-05-01 14:24 xlgwr 阅读(626) 评论(0) 推荐(5) 编辑
摘要: 作者引言.Net 8.0 下的新RPC 自从19年开始接触到RPC,当时完全没有相关概念,接触到的都是http,tcp等,当时公司用的是zeroc出品的ice框架,对应rpc非常强大,跨平台,跨语言。可惜的国内并不是主流,主流是gRPC,万物诸途同归,最终的目地是一样的。主要上看谁简单,方便,好理解 阅读全文
posted @ 2024-03-18 12:55 xlgwr 阅读(759) 评论(4) 推荐(2) 编辑

作者引言

很高兴啊,我们来到了IceRPC之依赖注入>快乐的RPC,基础引导,打好基础,才能让自已不在迷茫,快乐的畅游世界。

依赖注入和IceRPC

了解 IceRPC (C#) 如何为依赖注入(DI)提供支持。

DI作为可选功能

DI的第一条规则是:不要引入对DI的依赖。

IceRPC (C#) 将此规则放首要位置上,即为 DI 提供全方位支持,同时使此支持完全可选。

IceRPC C# API 被设计为可选 DI 容器。此外,IceRPC 还提供支持代码来帮助大家,在 Microsoft's DI container中使用 IceRPC。.

DI APIs

IceRPC 提供的所有与 DI 相关的 API 都在同一个命名空间中, IceRpc.Extensions.DependencyInjection, 但由多个组件实现:

  • IceRpc.dll 提供如IDispatcherBuilderIInvokerBuilder IceRpc.Deadline.dll之类的抽象以及其他拦截器/中间件组件,为IDispatcherBuilderIInvokerBuilder提供了扩展方法。这些扩展方法与 DI 容器无关。
  • IceRpc.Extensions.DependencyInjection.dll 为 Microsoft 的 DI 容器提供支持代码。这包括 IServiceCollection 的各种扩展方法,例如 AddIceRpcServerAddIceRpcClientConnection,以及 IDispatcherBuilderIInvokerBuilder 的实现。
--- title: 程序集依赖图 --- flowchart BT di([Microsoft.Extensions.DependencyInjection.Abstractions.dll]) logging([Microsoft.Extensions.Logging.Abstractions.dll]) options([Microsoft.Extensions.Options.dll]) IceRpc.dll --> logging IceRpc.Logger.dll --> IceRpc.dll IceRpc.Logger.dll --> logging IceRpc.Deadline.dll --> IceRpc.dll IceRpc.Extensions.DependencyInjection.dll --> di IceRpc.Extensions.DependencyInjection.dll --> options IceRpc.Extensions.DependencyInjection.dll --> IceRpc.dll

调度管道与 DI

了解如何使用 DI 容器构建调度管道。

传统的调度管道

传统的调度管道相当静态: 创建路由、添加一些中间件、在此路由中映射或安装少量叶片调度程序,然后让服务器将传入的请求调度到此路由。

叶片调度程序(通常是 Slice 服务)被映射或安装在固定路径(例如/greeter 或/admin/greeter-manager)。 这些调度程序是单例(或类似单例),其使用寿命与路由和服务器相同。

调度管道中的中间件使用以下features相互通信: 上游中间件设置下游中间件可以检索的features。叶片调度程序还可以使用相同的features与这些中间件进行通信。

这对于许多应用程序来说都很有效。然而,这并不是使用 DI 时的典型模型。

DI容器构建调度管道

DI,调度管道通常更具动态性: 一些基础设施代码为每个调度创建唯一的 DI 范围,并且叶片调度程序是由 DI 容器管理的服务。当该叶片调度器的生命周期是短暂的或范围化的时,该叶片调度器是按需创建的(每个调度)。

DI 调度管道中的中间件可以像往常一样使用features,与其他中间件和叶片调度器进行通信。然而,更惯用的方法是使用注入服务进行通信。例如:

  • 上游中间件接收范围服务(通过注入),然后填写此服务
  • 下游中间件接收相同的作用域服务(也通过注入)并读取上游中间件填写的信息
  • 叶片调度器的构造函数(作用域或瞬态服务)与该先前填充的作用域服务自动连线

中间件链本身是静态的: 每个调度不会创建新的中间件实例。中间件通常是由 DI 容器管理的单例。

使用 Microsoft 的 DI 容器构建调度管道

IceRpc.Extensions.DependencyInjection组件为 IServiceCollection 提供了多种接受 Action<IDispatcherBuilder> 参数的扩展方法。

所有这些方法都允许 Microsoft 的 DI 容器构建和配置调度管道。例如:

// Construct a dispatch pipeline using Microsoft's DI container.

using IceRpc.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
...

// Add a new IDispatcher singleton configured with an action.
services.AddIceRpcDispatcher(builder => builder.Map<IGreeterService>());

由此产生的调度程序(调度管道)为每个传入请求创建一个新的 DI 范围,并使用 IServiceProviderFeature 将此范围传输到下游调度程序。

在 IDispatcherBuilder 中安装标准中间件

标准中间件是可以与 DI 容器一起使用或不使用 DI 容器的中间件: 它不依赖DI容器注入服务来运行,并且实现了接口 IDispatcher

IceRPC 附带的所有中间件都是标准中间件: 可以在有或没有 DI 的情况下使用它们,并且它们在调度中使用功能进行通信。

这些中间件可以安装在路由或 IDispatcherBuilder 中。例如:

// Construct a dispatch pipeline using Microsoft's DI container.

using IceRpc.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
...

services.AddIceRpcDispatcher(
    builder => builder
        .UseLogger()
        .Map<IGreeterService>());

这里,UseLoggerIceRpc.Logger 组件提供的扩展方法。此扩展方法适用于实现 IServiceProvider 的任何 DI 容器,例如 Microsoft 的 DI 容器和 Simple Injector 的容器。

UseLogger 的实现只是从 DI 容器中检索一个记录器实例, 然后用这个实例创建一个新的中间件:

public static IDispatcherBuilder UseLogger(this IDispatcherBuilder builder) =>
    builder.ServiceProvider.GetService(typeof(ILogger<LoggerMiddleware>)) is ILogger logger ?
        builder.Use(next => new LoggerMiddleware(next, logger)) :
        throw new InvalidOperationException(
            $"Could not find service of type '{nameof(ILogger<LoggerMiddleware>)}' in the service container.");

我们建议在创建自己的标准中间件时遵循相同的模式,并为 RouterIDispatcherBuilder 提供使用扩展方法。

通常不鼓励在运行时调用 DI 容器—它是反模式的服务定位器。在这里,应该将 UseLogger 扩展方法视为不受此规则约束的基础设施代码。

具有注入服务的中间件

DI 容器注入的服务来创建与其他中间件和叶片调度器通信的中间件,而不是提供标准的中间件。

DI 友好的中间件需要实现以下 IMiddleware 接口之一:

  • IMiddleware<TDep>
  • IMiddleware<TDep1, TDep2>
  • IMiddleware<TDep1, TDep2, TDep3>

例如,我们希望以更适合 DI 的方式,重新实施截止日期中间件。标准截止日期中间件读取截止日期字段,并创建截止日期功能,以将此截止日期传达给,下游中间件和叶片调度程序。新的 DI 友好截止日期中间件,解码截止日期并将此信息,保存在注入的 scoped 服务中:

// Configured as a scoped service in the composition root of the application.
public class DeadlineInformation
{
    public DateTime Value { get; set; } = DateTime.MinValue; // MinValue means no deadline.
}
...

// New DI-friendly deadline middleware. Note that it does not implement IDispatcher.
public class DIDeadlineMiddleware : IMiddleware<DeadlineInformation>
{
    private readonly IDispatcher _next;

    // A constructor with an IDispatcher parameter is required for auto-wiring.
    public DIDeadlineMiddleware(IDispatcher next) => _next = next;

    // deadlineInfo is a scope service provided by the DI container.
    public ValueTask<OutgoingResponse> DispatchAsync(
        IncomingRequest request,
        DeadlineInformation deadlineInfo,
        CancellationToken cancellationToken)
    {
        // Decode the deadline field as usual.
        DateTime deadline = request.Fields.DecodeValue(
            RequestFieldKey.Deadline,
            (ref SliceDecoder decoder) => decoder.DecodeTimeStamp());

        if (deadline != DateTime.MinValue)
        {
            // If deadline is not MinValue, store it in deadlineInfo
            deadlineInfo.Value = deadline;

            // TODO: enforce deadline while calling _next.DispatchAsync.
        }
        else
        {
            // Call _next.DispatchAsync as usual.
            return _next.DispatchAsync(request, cancellationToken);
        }
    }
}

如果使用 Microsoft 的 DI 容器,可以使用 IceRpc.Extensions.DependencyInjection 组件提供的 UseMiddleware 扩展方法安装此中间件:

using IceRpc.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
...

// The DIDeadlineMiddleware is instantiated and managed by the DI container.
services.AddIceRpcDispatcher(
    builder => builder
        .UseLogger()
        .UseMiddleware<DIDeadlineMiddleware>()
        .Map<IGreeterService>());

// To be registered as a transient or scoped service in the DI container.
[SliceService]
internal partial class Chatbot : IGreeterService
{
    // DeadlineInformation is auto-wired by the DI container.
    internal Chatbot(DeadlineInformation deadlineInfo)
    {
        ...
    }
    ...
}

调用管道与DI

了解如何使用 DI 容器构建调用管道。

DI 容器构建调用管道

与调度管道不同,调用管道在有或没有 DI 容器的情况下几乎相同。 这是因为调用没有自然的 DI 范围: DI 作用域内执行调用,则该作用域来自另一个封闭活动,例如进行此调用的调度。

IceRPC [C#] 不会为 DI 范围内的调用提供任何特殊支持。特别是 IMiddleware 没有拦截器对应物。

使用 Microsoft 的 DI 容器构建调用管道

可以调用 AddIceRpcInvoker 将新的调用器(调用管道)单例添加到您的 DI 容器中。

例如:

// Construct an invocation pipeline using Microsoft's DI container.

using IceRpc.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
...

// Add a new IInvoker singleton configured with an action.
services
    .AddIceRpcClientConnection()
    .AddIceRpcInvoker(builder => builder.Into<ClientConnection>())

必须使用 Into 方法指定最终调用器。通过此示例,新调用器流入我们之前配置的 ClientConnection 单例。

IInvokerBuilder 中安装拦截器

所有使用 IceRPC 发送的拦截器都可以在有或没有 DI 的情况下使用,并使用调用中的通信 features 。 例如,重试拦截器使用 IServerAddressFeature 与连接缓存通信,以协调复制服务器上的重试。

这些拦截器可以安装在管道或 IInvokerBuilder 中。

例如:

// Construct an invocation pipeline using Microsoft's DI container.

using IceRpc.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
...

// Add a new IInvoker singleton configured with an action.
services
    .AddIceRpcClientConnection()
    .AddIceRpcInvoker(builder =>
        builder
            .UseLogger()
            .Into<ClientConnection>())

这里,UseLoggerIceRpc.Logger 组件提供的扩展方法。 此扩展方法适用于实现 IServiceProvider 的任何 DI 容器,例如 Microsoft 的 DI 容器和 Simple Injector 的容器。

UseLogger 方法的实现只是从 DI 容器中检索一个记录器实例, 然后用这个实例创建一个新的拦截器:

public static IInvokerBuilder UseLogger(this IInvokerBuilder builder) =>
    builder.ServiceProvider.GetService(typeof(ILogger<LoggerInterceptor>)) is ILogger logger ?
        builder.Use(next => new LoggerInterceptor(next, logger)) :
        throw new InvalidOperationException(
            $"Could not find service of type '{nameof(ILogger<LoggerInterceptor>)}' in the service container.");

我们建议在创建自己的拦截器时遵循相同的模式,并为 PipelineIInvokerBuilder 提供使用扩展方法。

通常不鼓励在运行时调用 DI 容器—它是反模式的服务定位器。在这里,应该将 UseLogger 扩展方法视为不受此规则约束的基础设施代码。

收尾

最近写的都是基础相关的概念,大家看看就行,以官方为主更为妙哉。

作者结语

  • 一直做,不停做,才能提升速度
  • 翻译的不好,请手下留情,谢谢
  • 觉得还不错的话,点个
  • 如果对我有点小兴趣,如可加我哦,一起探讨人生,探讨道的世界
    image
posted @ 2024-06-08 12:35 xlgwr 阅读(162) 评论(0) 推荐(1) 编辑
摘要: 作者引言 很高兴啊,我们来到了IceRPC之多路复用传输>快乐的RPC,基础引导,打好基础,才能让自已不在迷茫,快乐的畅游世界。 icerpc 和多路复用传输 了解 icerpc 协议和多路复用传输 icerpc 协议 当创建到服务器地址 icerpc://hello.zeroc.com 的客户端连 阅读全文
posted @ 2024-05-26 11:27 xlgwr 阅读(110) 评论(0) 推荐(0) 编辑
摘要: 作者引言 很高兴啊,我们来到了IceRPC之深入理解调度管道->快乐的RPC,为上篇的续篇,深入理解常见的调度类型, 基础引导,有点小压力,打好基础,才能让自已不在迷茫,快乐的畅游世界。 传入请求 了解如何处理传入的请求 接收传入的请求 调度器的调度方法接受传入的请求。该传入请求是由连接,在收到来自 阅读全文
posted @ 2024-05-25 18:42 xlgwr 阅读(151) 评论(0) 推荐(0) 编辑
摘要: 作者引言 很高兴啊,我们来到了IceRPC之调度管道->快乐的RPC, 基础引导,有点小压力,打好基础,才能让自已不在迷茫,快乐的畅游世界。 调度管道 Dispatch pipeline 了解如何接受请求并返回响应。 定义 接受/完成请求,并返回响应的过程称为调度。 调度通常由服务器连接创建: 服务 阅读全文
posted @ 2024-05-25 12:08 xlgwr 阅读(114) 评论(0) 推荐(0) 编辑
摘要: 作者引言 .Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之传入响应和拦截器->快乐的RPC, 基础引导,让自已不在迷茫,快乐的畅游世界。 传入响应 Incoming response 了解如何演绎传入的响应。 收到传入响应 调用器 invoker 异步返回传入响应。该传入响应是由连 阅读全文
posted @ 2024-05-16 08:05 xlgwr 阅读(199) 评论(5) 推荐(2) 编辑
摘要: 作者引言 .Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之调用管道 Invocation pipeline与传出请求 Outgoing request->快乐的RPC, 基础引导,让自已不在迷茫,快乐的畅游世界。 调用管道 Invocation pipeline 了解如何发送请求r 阅读全文
posted @ 2024-05-15 08:37 xlgwr 阅读(143) 评论(0) 推荐(1) 编辑
摘要: 作者引言 .Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之服务器地址与TLS的安全性->快乐的RPC, 基础引导,让自已不在迷茫,快乐的畅游世界。 服务器地址 ServerAddress 了解服务器地址的概念和语法。 语法 服务器地址URI具有以下语法: protocol://ho 阅读全文
posted @ 2024-05-12 10:25 xlgwr 阅读(168) 评论(0) 推荐(1) 编辑
摘要: 作者引言 .Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之如何创建连接connection,基础引导,让自已不在迷茫,快乐的畅游世界。 如何创建连接connection 学习如何使用IceRPC,创建和接受连接。 连接有什么用途? 连接在 IceRPC 中发挥着核心作用: 通过连接 阅读全文
posted @ 2024-05-05 10:15 xlgwr 阅读(318) 评论(0) 推荐(2) 编辑
摘要: 作者引言.Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之使用Dev Containers进行 .NET QUIC 精简开发,主要是一篇指引,如何使用开发容器做为开发环境,进行开发IceRPC,可适用于任务应用的开发 使用 Dev Containers 进行 .NET QUIC 精简 阅读全文
posted @ 2024-05-03 10:45 xlgwr 阅读(589) 评论(0) 推荐(1) 编辑
摘要: 作者引言.Net 8.0 下的新RPC 很高兴啊,我们来到了IceRPC之"请求"生命线意义非凡,号称“死亡时间”的追命线,颤抖吧! "请求"生命线之意义非凡 本文将深入探讨将截止时间纳入RPCs的重要性, 以开发更强大的分布式应用程序。 概述 RPC(远程过程调用)系统中发送请求,通常会带来不确定 阅读全文
posted @ 2024-05-02 11:37 xlgwr 阅读(304) 评论(0) 推荐(1) 编辑
点击右上角即可分享
微信分享提示