JH.SimplePipeline 1.1.1

简单快速创建一个上下文管道，类似于Asp.net 中的中间件管道，可以在开发中对文件解耦，是代码调理更清晰

使用方式

// 创建管道构建者
// 构建自己的上下文类型，会在整个管道中进行流转
// skipOption 选项会在管道开始流转时执行一次，如果返回 true ，后续管道中间件不会被执行(包括 DeferLayer)
var builder = new SimplePipelineBuilder<AntiCrawlerContext>(serviceProvider, async context => IfIgnore(context.HttpContext));

// 添加管道切面层
// 和 aspnet 中的中间件管道一样，会按照切面添加的顺序依次调用
builder
    .UseLayer<RateLimitLayer>()
    .UseLayer<UserRuleLayer>()
    .UseLayer<DeferLayer1>()
    .UseLayer<DeferLayer2>();

// 创建管道
SimplePipeline<AntiCrawlerContext> pipeline = builder.Build();

// 调用
var validateContext = ...
await pipeline.ExecuteAsync(validateContext);

示例

创建上下文：

public class AntiCrawlerContext : SimpleContext
{
    public AntiCrawlerContext(IServiceProvider serviceProvider)
    {
        ServiceProvider = serviceProvider;
    }
    
    public int UserId { get; set; }
    
    public Dictionary<string, object> Items { get; set; }
}

创建 IgnoreLayer 层，该类必须包含一个 InvokeAsync 方法（支持依赖注入），和有参构造函数，

public class IgnoreLayer
{
    private readonly SimpleRequestDelegate<AntiCrawlerContext> _next;

    public IgnoreLayer(SimpleRequestDelegate<AntiCrawlerContext> next)
    {
        _next = next;
    }

    /// <summary>
    /// 每个切面必要要有改方法，否则会报错
    /// </summary>
    /// <param name="context"></param>
    /// <param name="antiCrawlerService"></param>
    public async Task InvokeAsync(AntiCrawlerContext context, IAntiCrawlerService antiCrawlerService)
    {
      	// 该切面的一些负责验证逻辑
      	// ...
      
        if (await antiCrawlerService.IsPassed(context.UserId))
        {
            await _next(context);
            return;
        }
      
      	// 如果没有执行 _next ,后去切面不再流转
    }
}

创建收尾层

凡是标记了 [DeferLayer] 特性的切面层，不管其他层有没有流转，该层的 InvokeAsync 方法都会被调用，用来执行一些收尾操作，也遵循先添加先调用，后添加后调用的原则。 DeferLayer 层不需要有参构造函数，因为管道会自动流转。

[DeferLayer]
public class DeferLayer1
{
    public async Task InvokeAsync(AntiCrawlerContext context)
    {
        // 收尾操作
      	// ...
    }
}

[DeferLayer]
public class DeferLayer2
{
    public async Task InvokeAsync(AntiCrawlerContext context)
    {
        // 收尾操作
      	// ...
    }
}

1. InvokeAsync 内如果没有调用 next 方法，后续的非 [DeferLayer] 中间件都不会调用。
2. 标记了 [DeferLayer] 特性的中间件称为 Defer 中间件，不管前面有多少个中间件，或者执行怎样的操作，它们的 InvokeAsync 都会被调用，主要用来执行一些重制状态的操作。
3. 因为上下文和 HttpContext 上下文出自同一个 Scope，在流转的过程中，可以存储在本次请求中获得各种状态特征值，也可以获得和 aspnet 原生DI中的各种已注册服务。