聊聊AspectCore動態代理中的攔截器

前言

在上一篇文章使用AspectCore動態代理中，簡單說明了AspectCore.DynamicProxy的使用方式，因爲介紹的比較淺顯，也有很多同窗留言詢問攔截器的配置，那麼在這篇文章中，咱們來詳細看一下AspectCore中的攔截器使用。

兩種配置方式

在AspectCore中，提供攔截器的特性配置和全局配置兩種使用方式，而且分別提供AbstractInterceptor(可用於全局攔截器配置)和AbstractInterceptorAttribute(可同時用於全局配置和特性配置)兩個攔截器基類。下面來分別演示兩個攔截器配置方式的使用：

• 特性攔截器。咱們繼承AbstractInterceptorAttribute來實現一個本身的特性攔截器

public class CustomInterceptorAttribute : AbstractInterceptorAttribute
 {
     public override Task Invoke(AspectContext context, AspectDelegate next)
     {
         return context.Invoke(next);
     }
 }

那麼此時CustomInterceptorAttribute能夠標記在須要攔截的接口，類或者方法上來開啓攔截。

• 全局攔截器配置。咱們繼承AbstractInterceptor來實現一個本身的特性攔截器（除不能做爲Attribute標記在口，類或者方法上以外，AbstractInterceptor和AbstractInterceptorAttribute並沒有任何區別）

public class CustomInterceptor : AbstractInterceptor
 {
     public override Task Invoke(AspectContext context, AspectDelegate next)
     {
         return context.Invoke(next);
     }
 }

如今咱們已經定義了咱們本身的攔截器，我使用Microsoft.Extensions.DependencyInjection的集成方式來演示全局攔截器的配置（需安裝AspectCore.Extensions.DependencyInjection包）：

IServiceCollection services = new ServiceCollection();
services.AddDynamicProxy(config =>
{
    config.Interceptors.AddTyped<CustomInterceptor>();
});
IServiceProvider serviceProvider = services.BuildAspectCoreServiceProvider();

CustomInterceptor即可以攔截由serviceProvider建立的任何服務的方法。

三種攔截器類型

在AspectCore中，提供了TypedInterceptor,ServiceInterceptor,DelegateInterceptor三種攔截器的激活類型。

• TypedInterceptor 標記在接口，類或者方法上的特性攔截器或者使用上面config.Interceptors.AddTyped<CustomInterceptor>();配置的全局攔截器，這類攔截器對於每一個方法具備惟一的實例。
• ServiceInterceptor 註冊到DI並從DI激活使用的攔截器。這類攔截器的生命週期同註冊到DI時的生命週期一致。以下面咱們註冊一個瞬態的ServiceInterceptor：

IServiceCollection services = new ServiceCollection();

services.AddTransient<CustomInterceptor>();

咱們能夠使用ServiceInterceptor特性激活註冊到DI中的攔截器：

[ServiceInterceptor(typeof(CustomInterceptor))]
public interface IService
{
    void Foo();
}

或者使用全局配置：

IServiceCollection services = new ServiceCollection();

 services.AddTransient<CustomInterceptor>();

 services.AddDynamicProxy(config =>
 {
     config.Interceptors.AddServiced<CustomInterceptor>();
 });
 IServiceProvider serviceProvider = services.BuildAspectCoreServiceProvider();

• DelegateInterceptor 在使用全局的攔截器配置時，咱們也能夠不定義具體的攔截器類，而直接使用簽名爲Func<AspectDelegate, AspectDelegate>或Func<AspectContext, AspectDelegate, Task>的委託來執行攔截，以下面：

IServiceCollection services = new ServiceCollection();

services.AddTransient<CustomInterceptor>();

services.AddDynamicProxy(config =>
{
    config.Interceptors.AddDelegate( async (content, next) =>
    {
        Console.WriteLine("delegate interceptor");
        await content.Invoke(next);
    });
});
IServiceProvider serviceProvider = services.BuildAspectCoreServiceProvider();

使用通配符或者委託配置攔截器

在AspectCore中配置全局攔截器時，能夠使用通配符或者委託來限定攔截器的做用範圍。
內置提供了Predicates.ForMethod,Predicates.ForService,Predicates.ForNameSpace三個通配符函數：

services.AddDynamicProxy(config =>
 {
     config.Interceptors.AddTyped<CustomInterceptor>(Predicates.ForMethod("*Query")); //攔截全部Query後綴的方法
     config.Interceptors.AddTyped<CustomInterceptor>(Predicates.ForService("*Repository")); //攔截全部Repository後綴的類或接口
     config.Interceptors.AddTyped<CustomInterceptor>(Predicates.ForNamespace("AspectCoreDemo.*")); //攔截全部AspectCoreDemo及其子命名空間下面的接口或類
 });

有問題反饋

若是您有任何問題，請提交 Issue 給咱們。
Github : https://github.com/dotnetcore/AspectCore-Framework
AspectCore QQ羣: 306531723

相關文章

Asp.Net Core輕量級Aop解決方案：AspectCore
AspectCore.Extension.Reflection : .NET Core反射擴展庫
AspectCore中的IoC容器和依賴注入
使用AspectCore動態代理