Castle.Core.AsyncInterceptor：简化异步方法拦截的库

【实例简介】
Castle.Core.AsyncInterceptor 是一个用于简化异步方法拦截开发的扩展库。它基于 Castle DynamicProxy 实现，能够让开发者更容易地为异步方法实现拦截器。

为什么需要拦截方法？拦截器的实现原因和场景非常多，这里不详细展开。一个常见的应用场景是在面向切面编程模式中，比如异常处理。

异步方法拦截的挑战在于，当方法是异步的（返回 Task 或 Task<TResult>）时，传统的拦截方式无法直接应用，因为异步方法的 Proceed() 返回时，方法可能还没有真正完成。Castle.Core.AsyncInterceptor 提供了一种简化的方式来拦截这些异步方法。

使用 Castle.Core.AsyncInterceptor，开发者可以通过实现 IAsyncInterceptor 接口或扩展 AsyncInterceptorBase 类来创建拦截器，从而在不增加复杂度的情况下，有效地拦截异步方法的执行。

此外，Castle.Core.AsyncInterceptor 还提供了 ProcessingAsyncInterceptor<TState> 类，允许开发者在方法调用前后维护状态，进一步简化了异步方法拦截的实现。

Castle.Core.AsyncInterceptor 不仅支持同步方法的拦截，也对异步方法提供了全面的拦截解决方案，是面向切面编程中不可或缺的工具之一。

// 示例：简单的异常处理拦截器
public class ExceptionHandlingInterceptor : AsyncInterceptorBase
{
    protected override async Task InterceptAsync(IInvocation invocation, Func<IInvocation, Task> proceed)
    {
        try
        {
            await proceed(invocation).ConfigureAwait(false);
        }
        catch (Exception ex)
        {
            Log.Error($"Error calling {invocation.Method.Name}.", ex);
            throw;
        }
    }
}

【实例截图】
【核心代码】
文件清单
└── Castle.Core.AsyncInterceptor-1f1254c7994e59737a44e2084935235d811777e7
    ├── castle.core.asyncinterceptor.sln
    ├── castle.core.asyncinterceptor.sln.DotSettings
    ├── coverage.cmd
    ├── coverage.sh
    ├── Directory.Build.props
    ├── Dockerfile
    ├── docs
    │   └── images
    │       └── castle-logo.png
    ├── LICENSE
    ├── README.md
    ├── src
    │   └── Castle.Core.AsyncInterceptor
    │       ├── AsyncDeterminationInterceptor.cs
    │       ├── AsyncInterceptorBase.cs
    │       ├── AsyncTimingInterceptor.cs
    │       ├── Castle.Core.AsyncInterceptor.csproj
    │       ├── IAsyncInterceptor.cs
    │       ├── NoCoverage
    │       │   └── RethrowHelper.cs
    │       ├── ProcessingAsyncInterceptor.cs
    │       ├── Properties
    │       │   └── AssemblyInfo.cs
    │       ├── ProxyGeneratorExtensions.cs
    │       └── SharedKey.snk
    └── test
        ├── Castle.Core.AsyncInterceptor.Tests
        │   ├── AsyncExceptionInterceptorShould.cs
        │   ├── AsyncInterceptorBaseShould.cs
        │   ├── AsyncInterceptorShould.cs
        │   ├── AsyncTimingInterceptorShould.cs
        │   ├── Castle.Core.AsyncInterceptor.Tests.csproj
        │   ├── CompletedAndIncompleteAsyncTests.cs
        │   ├── InterfaceProxies
        │   │   ├── ClassWithAlwaysCompletedAsync.cs
        │   │   ├── ClassWithAlwaysIncompleteAsync.cs
        │   │   ├── ClassWithInterfaceToProxy.cs
        │   │   ├── ClassWithVirtualMethodToProxy.cs
        │   │   ├── IInterfaceToProxy.cs
        │   │   ├── TestAsyncInterceptorBase.cs
        │   │   ├── TestAsyncInterceptor.cs
        │   │   ├── TestAsyncTimingInterceptor.cs
        │   │   ├── TestProcessingAsyncInterceptor.cs
        │   │   └── TestProcessingReturnValueAsyncInterceptor.cs
        │   ├── ListLogger.cs
        │   ├── ProcessingAsyncInterceptorShould.cs
        │   ├── ProcessingAsyncInterceptorWithReturnValueShould.cs
        │   ├── Properties
        │   │   └── AssemblyInfo.cs
        │   ├── ProxyGeneratorExtensionsShould.cs
        │   └── xunit.runner.json
        └── packages.config

11 directories, 42 files