自定义中间件开发(Beta)

什么是中间件？

活字格的服务器是基于 Asp.net core 6.0 实现的，Asp.net 在处理一个请求时，会把请求交个中间件来处理。通常，中间件是一个顺序列表。请求会先发送给第一个中间件，第一个中间件处理完成之后，会决定是否交给第二个中间件来处理，第二个中间件会决定是否交给第三个中间件来处理，以此类推。

当所有中间件处理完成，或者某一个中间件选择不交给下一个中间件处理则请求返回。

在活字格中如何开发自定义中间件？

活字格 V8.1 支持自定义中间件来处理高级需求，尤其是在使用第三方SDK的时候回特别有用，因为很多第三方SDK的接口就是以中间件的形式提供的。

在自定义插件项目的解决方案点击右键，在右键菜单中选择 “添加”-> “现有项目”。
找到当前项目中的“MyPlugin.Server.csproj”并选中，添加自定义中间件的模板工程。
添加后可以看到，在MyPlugin.Server工程里有两个文件：MyPluginMiddleware.cs 和 MyPluginMiddlewareInjector.cs。

MyPluginMiddleware.cs 是一个示例中间件，默认代码如下。实际上这就是一个标准的 Asp.net 的中间件，如果要对接的是三方库的中间件，可以不添加这个文件。

using Microsoft.AspNetCore.Http;
using System.Threading.Tasks;

namespace MyPlugin.Server
{
    internal class MyPluginMiddleware
    {
        private readonly RequestDelegate _next;
        public MyPluginMiddleware(RequestDelegate next)
        {
            _next = next;
        }

        public async Task InvokeAsync(HttpContext context)
        {
            if(context.Request.Path.Value == "/MyPluginMiddleware")
            {
                await context.Response.WriteAsync("自定义中间件测试成功");
                return;
            }
            await _next(context);
        }
    }
}

MyPluginMiddlewareInjector.cs 负责把中间件注册给活字格，默认代码如下。

using System;
using System.Collections.Generic;
using GrapeCity.Forguncy.ServerApi;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.DependencyInjection;

namespace MyPlugin.Server
{
    public class MyPluginMiddlewareInjector : MiddlewareInjector
    {
        public override List<ServiceItem> ConfigureServices(List<ServiceItem> serviceItems, IServiceCollection services)
        {
            serviceItems.Insert(0, new ServiceItem()
            {
                Id = "2eb703ef-7afd-4970-a1f3-85ddc57dea9b",
                ConfigureServiceAction = () =>
                {
                    // 这里可以注册中间件需要的服务，相当于 Asp.net 中的 public void ConfigureServices(IServiceCollection services) 方法
                    //services.AddXXXService();
                },
                Description = "我的自定义中间件服务"
            });
            return base.ConfigureServices(serviceItems, services);
        }
        public override List<MiddlewareItem> Configure(List<MiddlewareItem> middlewareItems, IApplicationBuilder app)
        {
            middlewareItems.Insert(0, new MiddlewareItem()
            {
                Id = "2eb703ef-7afd-4970-a1f3-85ddc57dea9b",
                ConfigureMiddleWareAction = () =>
                {
                    app.UseMiddleware<MyPluginMiddleware>();
                },
                Description = "我的自定义中间件"
            });
            return base.Configure(middlewareItems, app);
        }
    }
}

代码解释：定义了一个MyPluginMiddlewareInjector类从MiddlewareInjector，可以重写ConfigureServices方法和Configure。ConfigureServices 负责注册服务，Configure负责注册中间件。在函数的参数中，是活字格默认的服务或中间件列表，可以根据需求把中间件插入到最前边，最后边或者特定的某个中间件之后。甚至可以移除活字格默认的某个中间件（不推荐）。
编译工程。