アスペクトコアプロジェクトとは何ですか?

AspectCore プロジェクトとは何ですか?

AspectCore プロジェクトは、Asp.Net Core プラットフォームに適した軽量の Aop (アスペクト指向プログラミング) ソリューションであり、Asp.Net Core のモジュラー開発概念に準拠しています。結合度が低く、簡単にスケーラブルな Web アプリケーションを構築します。 AspectCore は Emit を使用して、サードパーティの Aop ライブラリに依存せずに効率的な動的プロキシを実装します。

AspectCore の使用を開始する

• Visual Studio を起動します。 [ファイル] メニューから [新規] > [プロジェクト] を選択します。 ASP.NET Core Web アプリケーション プロジェクト テンプレートを選択し、新しい ASP.NET Core Web アプリケーション プロジェクトを作成します。

• Nuget から AspectCore.Extensions.DependencyInjection パッケージをインストールします:AspectCore.Extensions.DependencyInjection package:

  PM>   Install-Package AspectCore.Extensions.DependencyInjection

• 在一般情况下可以使用抽象的InterceptorAttribute自定义特性类，它实现IInterceptor接口。AspectCore默认实现了基于Attribute的拦截器配置。我们的自定义拦截器看起来像下面这样:

  public class CustomInterceptorAttribute : InterceptorAttribute
  {
      public async override Task Invoke(IAspectContext context, AspectDelegate next)
      {
          try
          {
              Console.WriteLine("Before service call");
              await next(context);
          }
          catch (Exception)
          {
              Console.WriteLine("Service threw an exception!");
              throw;
          }
          finally
          {
              Console.WriteLine("After service call");
          }
       }
   }

• 定义ICustomService接口和它的实现类CustomService:

  public interface ICustomService
  {
      [CustomInterceptor]
      void Call();
  }
  
  public class CustomService : ICustomService
  {
      public void Call()
      {
          Console.WriteLine("service calling...");
      }
  }

• 在HomeController中注入ICustomService:

  public class HomeController : Controller
  {
      private readonly ICustomService _service;
      public HomeController(ICustomService service)
      {
          _service = service;
      }
  
      public IActionResult Index()
      {
          _service.Call();
          return View();
      }
  }

• 注册ICustomService，接着，在ConfigureServices中配置创建代理类型的容器:

  public IServiceProvider ConfigureServices(IServiceCollection services)
  {
      services.AddTransient<ICustomService, CustomService>();
      services.AddMvc();
      services.AddAspectCore();
      return services.BuildAspectCoreServiceProvider();
  }

• 拦截器配置。首先安装AspectCore.Extensions.Configuration package：

  PM> Install-Package AspectCore.Extensions.Configuration

  全局拦截器。使用AddAspectCore(Action<AspectCoreOptions>)的重载方法，其中AspectCoreOptions提供InterceptorFactories注册全局拦截器:

   services.AddAspectCore(config =>
   {
        config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>();
   });

  带构造器参数的全局拦截器，在CustomInterceptorAttribute中添加带参数的构造器：

  public class CustomInterceptorAttribute : InterceptorAttribute
  {
      private readonly string _name;
      public CustomInterceptorAttribute(string name)
      {
          _name = name;
      }
      public async override Task Invoke(AspectContext context, AspectDelegate next)
      {
          try
          {
              Console.WriteLine("Before service call");
              await next(context);
          }
          catch (Exception)
          {
              Console.WriteLine("Service threw an exception!");
              throw;
          }
          finally
          {
              Console.WriteLine("After service call");
          }
      }
  }

  修改全局拦截器注册:

  services.AddAspectCore(config =>
  {
       config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(args: new object[] { "custom" });
  });

  作为服务的全局拦截器。在ConfigureServices中添加：

  services.AddTransient<CustomInterceptorAttribute>(provider => new CustomInterceptorAttribute("service"));

  修改全局拦截器注册:

  services.AddAspectCore(config =>
  {
      config.InterceptorFactories.AddServiced<CustomInterceptorAttribute>();
  });

  作用于特定Service或Method的全局拦截器，下面的代码演示了作用于带有Service后缀的类的全局拦截器：

  services.AddAspectCore(config =>
  {
      config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(method => method.DeclaringType.Name.EndsWith("Service"));
  });

  使用通配符的特定全局拦截器：

  services.AddAspectCore(config =>
  {
      config.InterceptorFactories.AddTyped<CustomInterceptorAttribute>(PredicateFactory.ForService("*Service"));
  });

• 在AspectCore中提供NonAspectAttribute来使得Service或Method不被代理：

  [NonAspect]
  public interface ICustomService
  {
      void Call();
  }

  同时支持全局忽略配置，亦支持通配符：

   services.AddAspectCore(config =>
    {
        //App1命名空间下的Service不会被代理
        config.NonAspectOptions.AddNamespace("App1");
  
        //最后一级为App1的命名空间下的Service不会被代理
        config.NonAspectOptions.AddNamespace("*.App1");
  
        //ICustomService接口不会被代理
        config.NonAspectOptions.AddService("ICustomService");
  
        //后缀为Service的接口和类不会被代理
        config.NonAspectOptions.AddService("*Service");
  
        //命名为Query的方法不会被代理
        config.NonAspectOptions.AddMethod("Query");
  
        //后缀为Query的方法不会被代理
        config.NonAspectOptions.AddMethod("*Query");
    });

• 拦截器中的依赖注入。在拦截器中支持属性注入，构造器注入和服务定位器模式。
  属性注入，在拦截器中拥有public get and set权限的属性标记[AspectCore.Abstractions.FromServices](区别于Microsoft.AspNetCore.Mvc.FromServices)特性，即可自动注入该属性，如：

  public class CustomInterceptorAttribute : InterceptorAttribute
  {
      [AspectCore.Abstractions.FromServices]
      public ILogger<CustomInterceptorAttribute> Logger { get; set; }
  
  
      public override Task Invoke(AspectContext context, AspectDelegate next)
      {
          Logger.LogInformation("call interceptor");
          return next(context);
      }
  }

  构造器注入需要使拦截器作为Service，除全局拦截器外，仍可使用ServiceInterceptor使拦截器从DI中激活：

  public interface ICustomService
  {
      [ServiceInterceptor(typeof(CustomInterceptorAttribute))]
      void Call();
  }

  服务定位器模式。拦截器上下文AspectContext可以获取当前Scoped的ServiceProvider：

  public class CustomInterceptorAttribute : InterceptorAttribute
  {
      public override Task Invoke(AspectContext context, AspectDelegate next)
      {
          var logger = context.ServiceProvider.GetService<ILogger<CustomInterceptorAttribute>>();
          logger.LogInformation("call interceptor");
          return next(context);
      }
  }

• 使用Autofac和AspectCore。AspectCore原生支持集成Autofac，我们需要安装下面两个nuget packages：

  PM> Install-Package Autofac.Extensions.DependencyInjection
  PM> Install-Package AspectCore.Extensions.Autofac

  AspectCore提供RegisterAspectCore扩展方法在Autofac的Container中注册动态代理需要的服务，并提供AsInterfacesProxy和AsClassProxy扩展方法启用interface和class的代理。修改ConfigureServices

  public IServiceProvider ConfigureServices(IServiceCollection services)
  {
      services.AddMvc();
  
      var container = new ContainerBuilder();
  
      container.RegisterAspectCore();
  
      container.Populate(services);
  
      container.RegisterType<CustomService>().As<ICustomService>().InstancePerDependency().AsInterfacesProxy();
  
      return new AutofacServiceProvider(container.Build());
  }

一般に、InterceptorAttribute カスタム属性クラスを使用できます。 code>IInterceptor インターフェイス。 AspectCore は、デフォルトで Attribute に基づいてインターセプター設定を実装します。カスタム インターセプターは次のようになります:

rrreee

ICustomService インターフェイスとその実装クラス CustomService を定義します:

rrreee

in Inject <code>ICustomService を HomeController:

rrreee🎜🎜🎜 に追加して ICustomService を登録し、ConfigureServices でプロキシ タイプを作成するようにコンテナを構成します: 🎜rrreee🎜 🎜🎜インターセプターの構成。まず、AspectCore.Extensions.Configuration パッケージ: 🎜rrreee🎜グローバル インターセプターをインストールします。 AddAspectCore(Action<AspectCoreOptions>) のオーバーロードされたメソッドを使用します。ここで、AspectCoreOptions は、グローバル インターセプターを登録するための InterceptorFactories を提供します。 🎜rrreee🎜コンストラクター パラメーター付きグローバル インターセプターの場合、CustomInterceptorAttribute にパラメーターを持つコンストラクターを追加します: 🎜rrreee🎜 サービスのグローバル インターセプターとしてグローバル インターセプターの登録: 🎜rrreee🎜 を変更します。 ConfigureServices を追加します: 🎜rrreee🎜グローバル インターセプターの登録を変更します: 🎜rrreee🎜 次のように、特定の Service または Method で動作するグローバル インターセプターコードは、Service サフィックスを持つクラスで動作するグローバル インターセプターを示しています。 🎜rrreee🎜 ワイルドカードを使用した特定のグローバル インターセプター: 🎜rrreee🎜🎜🎜 AspectCore では、NonAspectAttribute code> を使用して <code>Service を防止します。 code>Service または Method がプロキシされるのを防ぎます: 🎜rrreee🎜 グローバル無視構成もサポートし、ワイルドカードもサポートします: 🎜rrreee🎜🎜🎜 インターセプターでの依存関係注入。インターセプターでのプロパティ インジェクション、コンストラクター インジェクション、およびサービス ロケーター パターンをサポートします。 🎜属性インジェクション、インターセプター内の public get および set 権限を持つ属性タグ [AspectCore.Abstractions.FromServices] (Microsoft.AspNetCore.Mvc.FromServices) 機能を使用すると、次のようなこのプロパティを自動的に挿入できます。 🎜rrreee🎜コンストラクターの注入では、グローバル インターセプターに加えて、インターセプターを <code>Service として作成する必要がありますが、引き続き を使用できます。 ServiceInterceptor DI からインターセプターをアクティブ化できるようにします: 🎜rrreee🎜サービス ロケーター モード。インターセプター コンテキスト AspectContext は、Autofac と AspectCore を使用して、現在の Scoped の ServiceProvider: 🎜rrreee🎜🎜🎜 を取得できます。 AspectCore は Autofac の統合をネイティブにサポートしています。次の 2 つの nuget パッケージをインストールする必要があります: 🎜rrreee🎜AspectCore は、Autofac の Containerで動的プロキシに必要なサービスを登録するための RegisterAspectCore 拡張メソッドを提供します。 > および AsInterfacesProxy および AsClassProxy 拡張メソッドを提供して、インターフェイスおよびクラス プロキシを有効にします。 ConfigureServices メソッドを次のように変更します: 🎜rrreee🎜🎜🎜Feedback🎜🎜ご質問がある場合は、問題を送信してください。 🎜AspectCore Project プロジェクトアドレス:🎜🎜最後に。 。 。 🎜🎜 仕事を探しています。上海にある .NET/.NET Core バックエンド開発職を推薦することを歓迎します。プライベート メッセージまたは電子メールを送信してください。 🎜

以上がアスペクトコアプロジェクトとは何ですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。