在Ocelot中使用自定义的中间件(二)

在上文中,我介绍了如何在Ocelot中使用自定义的中间件来修改下游服务的response body。今天,我们再扩展一下设计,让我们自己设计的中间件变得更为通用,使其能够应用在不同的Route上。比如,我们可以设计一个通用的替换response body的中间件,然后将其应用在多个Route上。

Ocelot的配置文件

我们可以将Ocelot的配置信息写在appsettings.json中,当然也可以将其放在单独的json文件里,然后通过ConfigureAppConfiguration的调用,将单独的json文件添加到配置系统中。无论如何,基于JSON文件的Ocelot配置都是可以加入我们自定义的内容的,基于数据库的或者其它存储的配置文件信息或许扩展起来并不方便,因此,使用JSON文件作为配置源还是一个不错的选择。比如,我们可以在ReRoute的某个配置中添加以下内容:

{
  "DownstreamPathTemplate": "/api/themes",
  "DownstreamScheme": "http",
  "DownstreamHostAndPorts": [
    {
      "Host": "localhost",
      "Port": 5010
    }
  ],
  "UpstreamPathTemplate": "/themes-api/themes",
  "UpstreamHttpMethod": [ "Get" ],
  "CustomMiddlewares": [
    {
      "Name": "themeCssMinUrlReplacer",
      "Enabled": true,
      "Config": {
        "replacementTemplate": "/themes-api/theme-css/{name}"
      }
    }
  ]
}

然后就需要有一个方法能够解析这部分配置内容。为了方便处理,可以增加以下配置Model,专门存放CustomMiddlewares下的配置信息:

public class CustomMiddlewareConfiguration
{
    public string DownstreamPathTemplate { get; set; }
    public string UpstreamPathTemplate { get; set; }
    public int ReRouteConfigurationIndex { get; set; }
    public string Name { get; set; }
    public bool Enabled { get; set; }
    public Dictionary<string, object> Config { get; set; }
}

然后定义下面的扩展方法,用以从IConfiguration对象中解析出所有的CustomMiddleware的配置信息:

public static IEnumerable<CustomMiddlewareConfiguration> GetCustomMiddlewareConfigurations(this IConfiguration config)
{
    var reRoutesConfigSection = config.GetSection("ReRoutes");
    if (reRoutesConfigSection.Exists())
    {
        var reRoutesConfigList = reRoutesConfigSection.GetChildren();
        for (var idx = 0; idx < reRoutesConfigList.Count(); idx++)
        {
            var reRouteConfigSection = reRoutesConfigList.ElementAt(idx);
            var upstreamPathTemplate = reRouteConfigSection.GetSection("UpstreamPathTemplate").Value;
            var downstreamPathTemplate = reRouteConfigSection.GetSection("DownstreamPathTemplate").Value;
            var customMidwareConfigSection = reRouteConfigSection.GetSection("CustomMiddlewares");
            if (customMidwareConfigSection.Exists())
            {
                var customMidwareConfigList = customMidwareConfigSection.GetChildren();
                foreach (var customMidwareConfig in customMidwareConfigList)
                {
                    var customMiddlewareConfiguration = customMidwareConfig.Get<CustomMiddlewareConfiguration>();
                    customMiddlewareConfiguration.UpstreamPathTemplate = upstreamPathTemplate;
                    customMiddlewareConfiguration.DownstreamPathTemplate = downstreamPathTemplate;
                    customMiddlewareConfiguration.ReRouteConfigurationIndex = idx;
                    yield return customMiddlewareConfiguration;
                }
            }
        }
    }

    yield break;
}

CustomMiddleware基类

为了提高程序员的开发体验,我们引入CustomMiddleware基类,在Invoke方法中,CustomMiddleware对象会读取所有的CustomMiddleware配置信息,并找到属于当前ReRoute的CustomMiddleware配置信息,从而决定当前的CustomMiddleware是否应该被执行。相关代码如下:

public abstract class CustomMiddleware : OcelotMiddleware
{
    #region Private Fields

    private readonly ICustomMiddlewareConfigurationManager customMiddlewareConfigurationManager;
    private readonly OcelotRequestDelegate next;

    #endregion Private Fields

    #region Protected Constructors

    protected CustomMiddleware(OcelotRequestDelegate next,
        ICustomMiddlewareConfigurationManager customMiddlewareConfigurationManager,
        IOcelotLogger logger) : base(logger)
    {
        this.next = next;
        this.customMiddlewareConfigurationManager = customMiddlewareConfigurationManager;
    }

    #endregion Protected Constructors

    #region Public Methods

    public async Task Invoke(DownstreamContext context)
    {
        var customMiddlewareConfigurations = from cmc in this
                                                .customMiddlewareConfigurationManager
                                                .GetCustomMiddlewareConfigurations()
                                             where cmc.DownstreamPathTemplate == context
                                                    .DownstreamReRoute
                                                    .DownstreamPathTemplate
                                                    .Value &&
                                                   cmc.UpstreamPathTemplate == context
                                                    .DownstreamReRoute
                                                    .UpstreamPathTemplate
                                                    .OriginalValue
                                             select cmc;

        var thisMiddlewareName = this.GetType().GetCustomAttribute<CustomMiddlewareAttribute>(false)?.Name;
        var customMiddlewareConfiguration = customMiddlewareConfigurations.FirstOrDefault(x => x.Name == thisMiddlewareName);
        if (customMiddlewareConfiguration?.Enabled ?? false)
        {
            await this.DoInvoke(context, customMiddlewareConfiguration);
        }

        await this.next(context);
    }

    #endregion Public Methods

    #region Protected Methods

    protected abstract Task DoInvoke(DownstreamContext context, CustomMiddlewareConfiguration configuration);

    #endregion Protected Methods
}

接下来就简单了,只需要让自定义的Ocelot中间件继承于CustomMiddleware基类就行了,当然,为了解耦类型名称与中间件名称,使用一个自定义的CustomMiddlewareAttribute:

[CustomMiddleware("themeCssMinUrlReplacer")]
public class ThemeCssMinUrlReplacer : CustomMiddleware
{
    private readonly Regex regex = new Regex(@"\w+://[a-zA-Z0-9]+(\:\d+)?/themes/(?<theme_name>[a-zA-Z0-9_]+)/bootstrap.min.css");
    public ThemeCssMinUrlReplacer(OcelotRequestDelegate next,
        ICustomMiddlewareConfigurationManager customMiddlewareConfigurationManager,
        IOcelotLoggerFactory loggerFactory) 
        : base(next, customMiddlewareConfigurationManager, loggerFactory.CreateLogger<ThemeCssMinUrlReplacer>())
    {
    }

    protected override async Task DoInvoke(DownstreamContext context, CustomMiddlewareConfiguration configuration)
    {
        var downstreamResponseString = await context.DownstreamResponse.Content.ReadAsStringAsync();
        var downstreamResponseJson = JObject.Parse(downstreamResponseString);
        var themesArray = (JArray)downstreamResponseJson["themes"];
        foreach(var token in themesArray)
        {
            var cssMinToken = token["cssMin"];
            var cssMinValue = cssMinToken.Value<string>();
            if (regex.IsMatch(cssMinValue))
            {
                var themeName = regex.Match(cssMinValue).Groups["theme_name"].Value;
                var replacementTemplate = configuration.Config["replacementTemplate"].ToString();
                var replacement = $"{context.HttpContext.Request.Scheme}://{context.HttpContext.Request.Host}{replacementTemplate}"
                    .Replace("{name}", themeName);
                cssMinToken.Replace(replacement);
            }
        }

        context.DownstreamResponse = new DownstreamResponse(
            new StringContent(downstreamResponseJson.ToString(Formatting.None), Encoding.UTF8, "application/json"),
            context.DownstreamResponse.StatusCode, context.DownstreamResponse.Headers, context.DownstreamResponse.ReasonPhrase);
    }
}

自定义中间件的注册

在上文介绍的BuildCustomOcelotPipeline扩展方法中,加入以下几行,就完成所有自定义中间件的注册:

var customMiddlewareTypes = from type in typeof(Startup).Assembly.GetTypes()
                            where type.BaseType == typeof(CustomMiddleware) && 
                                  type.IsDefined(typeof(CustomMiddlewareAttribute), false)
                            select type;
foreach (var customMiddlewareType in customMiddlewareTypes)
{
    builder.UseMiddleware(customMiddlewareType);
}

当然,app.UseOcelot的调用要调整为:

app.UseOcelot((b, c) => b.BuildCustomOcelotPipeline(c).Build()).Wait();

运行

重新运行API网关,得到结果跟之前的一样。所不同的是,我们可以将ThemeCssMinUrlReplacer在其它的ReRoute配置上重用了。

image

原文地址:https://www.cnblogs.com/daxnet/p/custom-middleware-in-ocelot-part-2.html

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


在上文中,我介绍了事件驱动型架构的一种简单的实现,并演示了一个完整的事件派发、订阅和处理的流程。这种实现太简单了,百十行代码就展示了一个基本工作原理。然而,要将这样的解决方案运用到实际生产环境,还有很长的路要走。今天,我们就研究一下在事件处理器中,对象生命周期的管理问题。事实上,不仅仅是在事件处理器
上文已经介绍了Identity Service的实现过程。今天我们继续,实现一个简单的Weather API和一个基于Ocelot的API网关。 回顾 《Angular SPA基于Ocelot API网关与IdentityServer4的身份认证与授权(一)》 Weather API Weather
最近我为我自己的应用开发框架Apworks设计了一套案例应用程序,并以Apache 2.0开源,开源地址是:https://github.com/daxnet/apworks-examples,目的是为了让大家更为方便地学习和使用.NET Core、最新的前端开发框架Angular,以及Apwork
HAL(Hypertext Application Language,超文本应用语言)是一种RESTful API的数据格式风格,为RESTful API的设计提供了接口规范,同时也降低了客户端与服务端接口的耦合度。很多当今流行的RESTful API开发框架,包括Spring REST,也都默认支
在前面两篇文章中,我详细介绍了基本事件系统的实现,包括事件派发和订阅、通过事件处理器执行上下文来解决对象生命周期问题,以及一个基于RabbitMQ的事件总线的实现。接下来对于事件驱动型架构的讨论,就需要结合一个实际的架构案例来进行分析。在领域驱动设计的讨论范畴,CQRS架构本身就是事件驱动的,因此,
HAL,全称为Hypertext Application Language,它是一种简单的数据格式,它能以一种简单、统一的形式,在API中引入超链接特性,使得API的可发现性(discoverable)更强,并具有自描述的特点。使用了HAL的API会更容易地被第三方开源库所调用,并且使用起来也很方便
何时使用领域驱动设计?其实当你的应用程序架构设计是面向业务的时候,你已经开始使用领域驱动设计了。领域驱动设计既不是架构风格(Architecture Style),也不是架构模式(Architecture Pattern),它也不是一种软件开发方法论,所以,是否应该使用领域驱动设计,以及什么时候使用
《在ASP.NET Core中使用Apworks快速开发数据服务》一文中,我介绍了如何使用Apworks框架的数据服务来快速构建用于查询和管理数据模型的RESTful API,通过该文的介绍,你会看到,使用Apworks框架开发数据服务是何等简单快捷,提供的功能也非常多,比如对Hypermedia的
在上一讲中,我们已经完成了一个完整的案例,在这个案例中,我们可以通过Angular单页面应用(SPA)进行登录,然后通过后端的Ocelot API网关整合IdentityServer4完成身份认证。在本讲中,我们会讨论在当前这种架构的应用程序中,如何完成用户授权。 回顾 《Angular SPA基于
Keycloak是一个功能强大的开源身份和访问管理系统,提供了一整套解决方案,包括用户认证、单点登录(SSO)、身份联合、用户注册、用户管理、角色映射、多因素认证和访问控制等。它广泛应用于企业和云服务,可以简化和统一不同应用程序和服务的安全管理,支持自托管或云部署,适用于需要安全、灵活且易于扩展的用
3月7日,微软发布了Visual Studio 2017 RTM,与之一起发布的还有.NET Core Runtime 1.1.0以及.NET Core SDK 1.0.0,尽管这些并不是最新版,但也已经从preview版本升级到了正式版。所以,在安装Visual Studio 2017时如果启用了
在上文中,我介绍了如何在Ocelot中使用自定义的中间件来修改下游服务的response body。今天,我们再扩展一下设计,让我们自己设计的中间件变得更为通用,使其能够应用在不同的Route上。比如,我们可以设计一个通用的替换response body的中间件,然后将其应用在多个Route上。 O
不少关注我博客的朋友都知道我在2009年左右开发过一个名为Apworks的企业级应用程序开发框架,旨在为分布式企业系统软件开发提供面向领域驱动(DDD)的框架级别的解决方案,并对多种系统架构风格提供支持。这个框架的开发和维护我坚持了很久,一直到2015年,我都一直在不停地重构这个项目。目前这个项目在
好吧,这个题目我也想了很久,不知道如何用最简单的几个字来概括这篇文章,原本打算取名《Angular单页面应用基于Ocelot API网关与IdentityServer4ʺSP.NET Identity实现身份认证与授权》,然而如你所见,这样的名字实在是太长了。所以,我不得不缩写“单页面应用”几个字
在前面两篇文章中,我介绍了基于IdentityServer4的一个Identity Service的实现,并且实现了一个Weather API和基于Ocelot的API网关,然后实现了通过Ocelot API网关整合Identity Service做身份认证的API请求。今天,我们进入前端开发,设计
Ocelot是ASP.NET Core下的API网关的一种实现,在微服务架构领域发挥了非常重要的作用。本文不会从整个微服务架构的角度来介绍Ocelot,而是介绍一下最近在学习过程中遇到的一个问题,以及如何使用中间件(Middleware)来解决这样的问题。 问题描述 在上文中,我介绍了一种在Angu
在大数据处理和人工智能时代,数据工厂(Data Factory)无疑是一个非常重要的大数据处理平台。市面上也有成熟的相关产品,比如Azure Data Factory,不仅功能强大,而且依托微软的云计算平台Azure,为大数据处理提供了强大的计算能力,让大数据处理变得更为稳定高效。由于工作中我的项目
在上文中,我们讨论了事件处理器中对象生命周期的问题,在进入新的讨论之前,首先让我们总结一下,我们已经实现了哪些内容。下面的类图描述了我们已经实现的组件及其之间的关系,貌似系统已经变得越来越复杂了。其中绿色的部分就是上文中新实现的部分,包括一个简单的Event Store,一个事件处理器执行上下文的接
在之前《在ASP.NET Core中使用Apworks快速开发数据服务》一文的评论部分,.NET大神张善友为我提了个建议,可以使用Compile As a Service的Roslyn为语法解析提供支持。在此非常感激友哥给我的建议,也让我了解了一些Roslyn的知识。使用Roslyn的一个很大的好处
很长一段时间以来,我都在思考如何在ASP.NET Core的框架下,实现一套完整的事件驱动型架构。这个问题看上去有点大,其实主要目标是为了实现一个基于ASP.NET Core的微服务,它能够非常简单地订阅来自于某个渠道的事件消息,并对接收到的消息进行处理,于此同时,它还能够向该渠道发送事件消息,以便